# Claude Code 装不上：403、command not found、登录打不开浏览器

**URL:** <https://www.shiqidu.com/t/topic/1765>\
**Category:** 人工智能\
**Tags:** 问与答, macOS, Windows, AICoding\
**Created:** [2026 年10 月 24 日 14:43 UTC](https://www.shiqidu.com/t/topic/1765 "2026-10-24T14:43:06Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年10 月 24 日 14:43 UTC](https://www.shiqidu.com/t/topic/1765/1 "2026-10-24T14:43:06Z")

</div>

大陆这边装 Claude Code，终端里常见就卡在这几处：下载站进不去、装完找不到 `claude`、CLI 能起来但浏览器登录接不上。别一上来反复重装。先分清卡在哪一层，再动手。

官方文档写得全，一口气对照容易晕。顺序可以按：先测下载通不通 → 再装 → 再查 PATH → 最后才管登录。下面命令和报错对照来自官方说明，完整错误表见 [排查安装和登录问题](https://code.claude.com/docs/zh-CN/troubleshoot-install)。地区名单以 [Supported countries](https://www.anthropic.com/supported-countries) 为准。

## 先对一下终端原文

把报错原文拿出来对，别混着试：

| 更接近哪句 | 优先怀疑 |
| --- | --- |
| `403`、脚本开头变成 `<!DOCTYPE html>`、解析报错里夹着网页标签 | 下载被拦，或页面提示地区不可用 |
| `command not found: claude` / `'claude' is not recognized` | 文件可能在，PATH 没带上 |
| 能出版本号，但登录页不弹、远程机浏览器开错、要粘贴码 | 鉴权回调出问题 |
| 明确出现 `App unavailable in region` | 产品侧地区限制；和「代理没配对」分开看 |

## 下载站通不通

安装器要从 `downloads.claude.ai` 拉文件。先只做探测，别急着管道进 bash：

```bash
# macOS / Linux / WSL
curl -sI https://downloads.claude.ai/claude-code-releases/latest

```

```powershell
# Windows：PowerShell 里别用别名 curl，用这个
curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

```

读第一行状态就够：

- 出现 **200** ：主机摸得到，可以继续装
- **403** ：多半是过滤或代理拦截。若正文或跳转里写了地区不可用，按官方地区政策处理，不要当成「换个安装器就能好」
- **5xx** ：多半临时抽风，隔几分钟再测
- 解析失败、超时、没输出：先把 DNS / 网络理顺，再谈 `install.sh`

探测不过时，给 **当前这个终端** 挂上代理再测一遍。浏览器勾了系统代理，终端经常不跟着走，这一步漏的人特别多：

```bash
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
curl -sI https://downloads.claude.ai/claude-code-releases/latest

```

端口改成你本机代理的真实端口；企业环境问 IT 要代理 URL。探测变成 200 之后，再在同一窗口执行安装。

原生安装按壳选一条（别抄错提示符）：

| 环境 | 命令 |
| --- | --- |
| macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh | bash` |
| Windows PowerShell（提示符带 PS） | `irm https://claude.ai/install.ps1 | iex` |
| Windows CMD（没有 PS） | `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` |

壳抄错的典型症状：PowerShell 里跑 `&&`、CMD 里跑 `irm`、把 macOS 那条管道命令丢进 Windows PowerShell。先认准提示符，再粘贴。

备选还有 `brew install --cask claude-code` 和 `winget install Anthropic.ClaudeCode`。它们同样要能访问下载相关主机。探测失败时换包装器往往没用，只是多一种入口。

装完 **新开一个终端** ，跑 `claude --version`。能打出版本号，下载和安装这一层就算过了。

## 命令找不到：先查文件，别急着重装

版本命令失败，别重装三遍。先看二进制在不在默认位置：macOS / Linux 一般是 `~/.local/bin/claude`，Windows 是 `%USERPROFILE%\.local\bin\claude.exe`。

```bash
ls -la ~/.local/bin/claude

```

```powershell
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

```

文件都没有：安装没落盘，回到上一节（网络 / 安装命令 / 权限）。文件在、命令仍找不到：把 `~/.local/bin`（Windows 对应 `.local\bin`）写进用户 PATH，保存后 **新开** 终端再测。Zsh 常见写 `~/.zshrc`；多数 Linux Bash 写 `~/.bashrc`；macOS 上 Bash 登录壳有时只读 `~/.bash_profile`。

```bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

```

安装器要是已经提示「Native installation exists but … is not in your PATH」，按它打印的修复做就行，不必删目录重来。

再补两点：只装了编辑器扩展，不等于终端里有全局 `claude`；机器上若有多套，用 `which -a claude` 或 `where.exe claude` 看谁抢了名字，尽量只留一套官方推荐的本机路径。

## 登录卡在浏览器：走手动回调

能 `claude --version` 却进不去账号，按登录链路排，别当安装失败。远程机、WSL 里最常见的是浏览器开错机器、回调回不来。

1. 会话里 `/logout`，退出后再开 `claude`。
2. 浏览器不自动弹出时，在提示处按 **`c`** ，把完整链接贴到 **你眼前这台机器** 的浏览器。
3. SSH、WSL、容器里，页面常开在另一侧，回调到不了本地服务；浏览器若给出一次性码，贴回终端提示处。交互粘贴失灵时，可改用 `claude auth login`。
4. 提示码无效：多半过期或复制缺段，回车重来，尽快在浏览器里点完。

登录之后冒出 `403` / 权限类文案，优先查订阅还在不在、Console 角色有没有 Claude Code 相关权限、企业代理有没有拦 API。账号问题重装 CLI 解决不了。

若 shell 里还留着旧的 `ANTHROPIC_API_KEY`，可能盖住订阅登录，表现会很怪。官方做法是清掉该变量后再用订阅鉴权，并用会话里的 `/status` 确认当前走的是哪条凭据。

## 还过不去时

网络过关：对 `downloads.claude.ai` 的 `curl -sI` 拿到 200，需要时代理已进 **当前** shell。安装落盘：默认路径有文件，PATH 带上了该目录，新终端里 `claude --version` 有输出。登录：按 `c` 开本机浏览器或粘贴回调码，能进会话。明文出现 `App unavailable in region` 时，对照官方支持地区列表单独处理，不要和普通 403 混在一起试。

能启动时跑 `claude doctor`。把系统、完整命令和原文报错带上，对照官方排查页，或去 Claude Code 的 GitHub 仓库查已知问题。订阅 / 组织类问题走 Anthropic 支持，别只循环重装。

文档入口：[快速入门](https://code.claude.com/docs/zh-CN/quickstart) · [排查安装和登录](https://code.claude.com/docs/zh-CN/troubleshoot-install) · [支持地区](https://www.anthropic.com/supported-countries)