大陆这边装 Claude Code，终端里常见就卡在这几处：下载站进不去、装完找不到 claude、CLI 能起来但浏览器登录接不上。别一上来反复重装。先分清卡在哪一层，再动手。
官方文档写得全，一口气对照容易晕。顺序可以按：先测下载通不通 → 再装 → 再查 PATH → 最后才管登录。下面命令和报错对照来自官方说明，完整错误表见 排查安装和登录问题。地区名单以 Supported countries 为准。
先对一下终端原文
把报错原文拿出来对，别混着试：
| 更接近哪句 | 优先怀疑 |
|---|---|
403、脚本开头变成 <!DOCTYPE html>、解析报错里夹着网页标签 |
下载被拦，或页面提示地区不可用 |
command not found: claude / 'claude' is not recognized |
文件可能在，PATH 没带上 |
| 能出版本号，但登录页不弹、远程机浏览器开错、要粘贴码 | 鉴权回调出问题 |
明确出现 App unavailable in region |
产品侧地区限制；和「代理没配对」分开看 |
下载站通不通
安装器要从 downloads.claude.ai 拉文件。先只做探测，别急着管道进 bash：
# macOS / Linux / WSL
curl -sI https://downloads.claude.ai/claude-code-releases/latest
# Windows：PowerShell 里别用别名 curl，用这个
curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest
读第一行状态就够：
- 出现 200：主机摸得到，可以继续装
- 403：多半是过滤或代理拦截。若正文或跳转里写了地区不可用，按官方地区政策处理，不要当成「换个安装器就能好」
- 5xx：多半临时抽风，隔几分钟再测
- 解析失败、超时、没输出：先把 DNS / 网络理顺，再谈
install.sh
探测不过时，给当前这个终端挂上代理再测一遍。浏览器勾了系统代理，终端经常不跟着走，这一步漏的人特别多：
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。
ls -la ~/.local/bin/claude
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
文件都没有：安装没落盘，回到上一节（网络 / 安装命令 / 权限）。文件在、命令仍找不到：把 ~/.local/bin（Windows 对应 .local\bin）写进用户 PATH，保存后新开终端再测。Zsh 常见写 ~/.zshrc；多数 Linux Bash 写 ~/.bashrc；macOS 上 Bash 登录壳有时只读 ~/.bash_profile。
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 里最常见的是浏览器开错机器、回调回不来。
- 会话里
/logout，退出后再开claude。 - 浏览器不自动弹出时，在提示处按
c，把完整链接贴到你眼前这台机器的浏览器。 - SSH、WSL、容器里，页面常开在另一侧，回调到不了本地服务；浏览器若给出一次性码，贴回终端提示处。交互粘贴失灵时，可改用
claude auth login。 - 提示码无效：多半过期或复制缺段，回车重来，尽快在浏览器里点完。
登录之后冒出 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 支持，别只循环重装。