Claude Code 怎么安装？安装前要准备的网络环境

安装 Claude Code 分两步：先准备 Node.js 与 npm，再用 npm 全局安装官方包 @anthropic-ai/claude-code。截至 2026 年 9 月，Node.js 的最低版本要求与是否有其他安装方式，请以 Anthropic 官方文档为准。

国内网络下真正容易卡住的是网络环境。npm 下载包、首次登录授权、之后每一次请求，都需要终端能访问境外服务。终端默认不会读取系统代理，所以安装前先让终端走代理，比装好后再排查省事得多。

安装前的准备清单

第一步：让终端走代理

在代理客户端的设置中找到本地混合端口，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

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
curl.exe -I https://api.anthropic.com

curl 能返回响应头，说明终端已经走通代理。如果不想每次手动设置，可以在 Clash Verge Rev 中开启 TUN 模式，所有终端会自动接管，做法见 Clash Verge TUN 模式。

第二步：安装与登录

1. 在已设置代理的同一个终端窗口中执行全局安装命令。
2. 安装完成后执行 claude 启动，按提示在浏览器中完成登录授权。
3. 浏览器与终端保持同一个支持地区的节点，避免回调因地区不一致失败。
4. 登录成功后在项目目录中启动，即可开始使用。

npm install -g @anthropic-ai/claude-code
claude

Windows 下如果全局安装提示权限问题，通常是 npm 全局目录权限设置导致，可以参考 npm 官方说明调整全局目录，不建议直接用管理员权限反复重装。

账号登录还是 API Key

首次启动时通常可以选择用 Claude 订阅账号授权，或使用 Anthropic API Key。两者的计费方式不同：订阅账号按套餐额度使用，API Key 按实际用量计费，具体规则截至 2026 年 9 月以官方说明为准。网络要求上两者没有区别，终端都需要走支持地区的节点。

如果你的 Claude 账号刚注册、还在频繁切换地区，建议先把节点固定下来再登录 Claude Code，避免网页端与终端在不同地区同时出现，增加账号被要求验证的概率。

安装后仍然连不上

安装成功只代表 npm 能下载包，不代表日常请求稳定。Claude Code 是长连接，对丢包与倍率比网页对话更敏感，节点建议选低倍率专线。详细的网络要求见 Claude Code 网络环境，连接报错的排查顺序见 Claude Code 网络连接失败怎么办。

总结

• 先装 Node.js 与 npm，再全局安装 @anthropic-ai/claude-code，细节以官方文档为准。
• 安装与登录前先让终端走代理，用 curl 验证。
• 浏览器与终端保持同一支持地区节点，避开香港。
• 长期使用建议开启 TUN 模式并选择低倍率专线节点。