Claude Code 装不上？command not found、403、登录失败对照表

安装页写得很短，真实翻车多半卡在 PATH、装到了 HTML、登录 403、代理/证书、环境变量抢登录。下面按症状对照处理；装法本身请回 macOS 安装、Windows 安装、完整安装指南。

先跑自检

能执行二进制时，优先：

bash

claude doctor
claude --version
which -a claude

doctor 报什么就先修什么；比盲目重装省时间。

症状对照表

症状	常见原因	怎么处理
`command not found: claude`	PATH 未含安装目录	把 `~/.local/bin`（官方脚本）或 brew 前缀加入 PATH，新开终端
安装脚本报 `syntax error near unexpected token '<'`	下载到的是 HTML（拦截页/登录页），不是 shell	用浏览器或 `curl -I` 看是否 200 且 `content-type` 合理；换网络/代理后再装
安装请求 403	CDN/地区/WAF/代理篡改	换节点、关「破解 HTTPS」的公司代理、稍后重试；确认 URL 是官方 `claude.ai/install.sh`
Windows 上 `curl ... \| bash` 乱套	把 Linux/mac 命令抄到 PowerShell	Windows 用文档里的 irm / 官方 Windows 方式，别硬套 bash 管道
mac/Linux 误用 `irm`	PowerShell cmdlet 在 Unix shell 不存在	用 `curl -fsSL ... \| bash`
TLS / 证书错误	公司 MITM、自签 CA、缺根证书	导入企业 CA；必要时设 `NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem`（仅在确有自签链时）
超时、卡住、半截下载	需代理但未配，或代理不可用	设置 `HTTPS_PROXY`/`HTTP_PROXY`（含协议与端口），装完再测直连是否可登录
OAuth：`invalid code` / 让按 `c`	授权码过期、复制多空格、终端粘贴截断	重新发起登录；短码一次粘贴；看清提示是「按 c」还是粘贴整段
登录后 403	账号无 Code 权限、地区限制、会话异常	确认 Pro/Max/Team；换网络；退出重登；见下方「地区不可用」
已登录却像 API Key 模式	`ANTHROPIC_API_KEY` 覆盖订阅登录	`unset ANTHROPIC_API_KEY`，检查 shell profile / CI 环境是否 export 了它
WSL2 粘贴授权码失败	Windows ↔ WSL 剪贴板不同步	在 WSL 终端内用右键粘贴；或 `clip.exe`/`powershell` 中转；尽量在同一侧完成浏览器回调
App unavailable in region	当前网络出口地区限制	换合规可用的网络出口后再登录；并参考国内使用

PATH：最常见的「装上了却没有」

官方脚本默认用户目录安装时：

bash

ls -la ~/.local/bin/claude
export PATH="$HOME/.local/bin:$PATH"
# 写入 ~/.zshrc 或 ~/.bashrc 后 source

Homebrew：

bash

brew --prefix
ls "$(brew --prefix)/bin/claude"

Windows（PowerShell）确认安装目录是否在用户 PATH；改完重开终端，不要只改当前窗口却去另一个 Profile 测试。

安装脚本变成 HTML / `<` 语法错

典型日志类似 syntax error near unexpected token '<'——说明管道左边吐出来的是网页（往往以 <!DOCTYPE html> 开头），bash 按脚本解析就炸。

处理步骤：

curl -fsSL -o /tmp/claude-install.sh https://claude.ai/install.sh
head -5 /tmp/claude-install.sh：应是 shell，不是 HTML。
若是 HTML：查代理、DNS、公司网关是否劫持；必要时换网络后再装。
确认无毒后再 bash /tmp/claude-install.sh。

出现裸 403 时，先别循环重试刷爆；修好网络路径再装。

壳用错了：irm vs curl

macOS / Linux / WSL：curl -fsSL https://claude.ai/install.sh | bash
Windows 原生 PowerShell：跟 Windows 安装指南走（常见是 irm 一类），不要把 bash 管道原样贴进 cmd.exe。

混用是新手第二大坑，仅次于 PATH。

代理、TLS 与公司网

bash

# 仅示例：按你的代理改主机和端口
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

证书被公司中间人替换时，把企业根证书落到本地，再：

bash

export NODE_EXTRA_CA_CERTS=/path/to/corporate-root.pem

没有自签需求就不要乱设，以免掩盖真问题。装好、登录稳了，再决定是否长期保留代理变量。

登录与 403

订阅：免费计划没有 Claude Code；换 Pro/Max/Team 后再登。
OAuth 码：过期极快；失败就整轮重来，不要拼旧码。
按 c：部分 TUI 用按键继续，不是让你输入字母 c 当密码。
登录后 403：查地区、账号权限、是否被 API Key 环境变量带偏。
App unavailable in region：换可用出口；国内场景配合国内使用优化。

怀疑 Key 抢登录时：

bash

env | grep -i anthropic
unset ANTHROPIC_API_KEY
# 检查 ~/.zshrc、~/.bashrc、系统环境变量里是否写死了 Key

WSL2 特别提醒

在 WSL 里装 Linux 版，不要假设 Windows 安装的 claude.exe 自动进 WSL PATH。
浏览器若在 Windows 打开、终端在 WSL，回调/粘贴容易丢字符——尽量缩短路径：同一侧完成，或手动可靠粘贴。
claude doctor 在 WSL 内跑，看的是 Linux 侧环境。

修完再验收

bash

hash -r
command -v claude
claude --version
claude doctor
cd /tmp && claude

能进会话再回项目目录干活。使用节奏见新手第一次会话；权限弹窗见 permissions / sandbox；总览见完整使用指南与官方中文概览。

Claude Code 装不上？command not found、403、登录失败对照表 ​

先跑自检 ​

症状对照表 ​

PATH：最常见的「装上了却没有」 ​

安装脚本变成 HTML / < 语法错 ​

壳用错了：irm vs curl ​

代理、TLS 与公司网 ​

登录与 403 ​

WSL2 特别提醒 ​

修完再验收 ​

相关入口 ​

Claude Code 装不上？command not found、403、登录失败对照表

先跑自检

症状对照表

PATH：最常见的「装上了却没有」

安装脚本变成 HTML / `<` 语法错

壳用错了：irm vs curl

代理、TLS 与公司网

登录与 403

WSL2 特别提醒

修完再验收

相关入口