摘要：安装本身只是 Node.js 加一条 npm 全局命令，真正卡人的是终端不读系统代理。装之前先让终端走代理，比装完再一层层排查省时间。
一分钟速查
- 前置：装好 Node.js 与 npm。
- 安装命令：npm install -g @anthropic-ai/claude-code。
- 关键：安装与登录前让终端走代理，用 curl 验证。
- 长期：开 TUN 模式，选低倍率专线节点。
第一步：让终端走代理
在代理客户端找到本地混合端口，Clash Verge Rev 通常是 7897，其他客户端可能是 7890，以实际显示为准。macOS / Linux / WSL 在终端执行：
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
curl -I https://api.anthropic.com
curl 能返回响应头，说明终端已走通代理。不想每次手动设置，可在客户端开启 TUN 模式，所有终端自动接管。
第二步：安装与登录
安装命令
在已设置代理的同一终端窗口执行全局安装命令。
浏览器授权
安装后执行 claude 启动，按提示在浏览器完成登录授权。
保持同地区
浏览器与终端保持同一支持地区节点，避免回调因地区不一致失败。
启动使用
登录成功后在项目目录启动即可使用。
账号登录还是 API Key
首次启动通常可选用 Claude 订阅账号授权，或使用 Anthropic API Key。两者计费不同：订阅账号按套餐额度，API Key 按用量计费。网络要求上两者没有区别，终端都要走支持地区节点。刚注册的账号建议先把节点固定下来再登录，避免网页端与终端出现在不同地区。
常见报错对照
- 连接超时：代理没生效，回头检查环境变量是否设置、TUN 是否开启。
- 地区不可用：节点地区不在支持范围，换支持地区节点，Claude 建议美国原生 IP。
- 鉴权失败：API key 错误或订阅过期，重新生成 key 或续费套餐。
关于 Claude Code 安装的 3 个误区
- 「装好就能用」——安装成功只代表 npm 能下载包，不代表日常请求稳定，长连接对丢包更敏感；
- 「设了系统代理就行」——终端默认不读系统代理，要设 HTTPS_PROXY 或开 TUN；
- 「npm 用国内镜像更快」——镜像源可能同步滞后，装官方包建议用默认源并走代理。