核心结论
先安装 Node.js 18 或更高版本（以官方文档为准），在终端中设置好 HTTPS_PROXY 等代理变量，再执行 npm install -g @anthropic-ai/claude-code 安装，最后在项目目录运行 claude，按提示在浏览器中完成账号登录即可。
先说结论
Claude Code 的安装只有三步：装 Node.js、设代理、npm 全局安装，然后在项目目录运行 claude 并在浏览器中完成登录。国内环境最容易卡住的不是命令本身，而是 npm 下载和登录请求没有走代理。只要在同一个终端窗口里先设好代理再执行后续命令，整个流程通常十分钟内可以完成。
本文聚焦安装与首次登录；如果已经装好但连接不稳定，请看 Claude Code 连接失败排查，整体网络要求见 Claude Code 网络环境配置指南。
准备工作
| 项目 | 要求 | 检查方法 |
|---|---|---|
| Node.js | 18 或更高版本（以官方文档为准） | node -v |
| npm | 随 Node.js 一起安装 | npm -v |
| 代理客户端 | 已连接支持地区节点，知道本地端口 | 客户端设置中查看混合端口 |
| 账号 | Claude 付费订阅或 Anthropic Console 账号 | 浏览器能正常登录 |
| 系统 | macOS、Linux、Windows（可用 WSL） | Windows 用户另见下文 |
节点方面，请选择美国、日本、新加坡等 Anthropic 支持地区的节点并手动固定，不要用香港节点。本站实测中，二猫云是目前唯一 Claude Code 实测可用的品牌，美国、日本、新加坡节点均可用，专线丢包 0.3%。
另外，官方也提供不依赖 Node.js 的原生安装方式，命令与适用系统以官方文档为准，本文以 npm 方式为主。
安装步骤
第一步：在终端中设置代理
以 Clash Verge Rev 默认混合端口 7897 为例，端口以你客户端中显示的为准。
Windows PowerShell：
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"macOS / Linux：
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897这两行只对当前终端窗口生效，后面的安装和登录都要在同一个窗口中进行。想长期生效，Windows 可写入 $PROFILE，macOS / Linux 可写入 ~/.zshrc 或 ~/.bashrc；Windows 的详细做法见 Windows 与 WSL 中 Claude Code 的代理设置。
如果 npm 依然不走代理，可以为 npm 单独配置：
npm config set proxy http://127.0.0.1:7897
npm config set https-proxy http://127.0.0.1:7897不再需要时用 npm config delete proxy 和 npm config delete https-proxy 删除。
第二步：全局安装 Claude Code
npm install -g @anthropic-ai/claude-codemacOS 或 Linux 上如果提示权限不足，不建议加 sudo，可以改用 Node 版本管理工具安装的 Node.js，或把 npm 全局目录设置到用户目录下。
第三步：启动并登录
进入你的项目目录，运行：
cd 你的项目目录
claude首次运行会引导你选择登录方式，常见选项包括使用 Claude 订阅账号，或使用 Anthropic Console 账号按 API 计费，具体以界面为准。选择后终端会打开浏览器完成授权；如果没有自动打开，就复制终端显示的链接手动打开。授权完成后回到终端，即可开始使用。之后如需切换账号，可在 Claude Code 中使用 /login 命令。
两种登录方式怎么选
| 方式 | 计费 | 适合人群 |
|---|---|---|
| Claude 订阅账号 | 包含在订阅中，受订阅用量限制 | 已经在用 Claude 付费订阅的个人开发者 |
| Anthropic Console 账号 | 按 API 实际用量计费 | 需要精确控制成本、或团队统一管理的用户 |
哪些订阅档位包含 Claude Code、各自的用量额度如何计算，Anthropic 会不定期调整，以官方说明为准。无论哪种方式，登录时浏览器与终端都应处于同一个支持地区的出口下，登录完成后也尽量不要切换地区。
首次使用的几点建议
- 在项目根目录启动：Claude Code 会以启动目录为工作范围读取文件，不要在用户主目录或系统目录下直接运行；
- 留意信任与权限提示：首次在某个目录运行时，通常会询问是否信任该目录；执行命令、修改文件前也会请求确认，请看清再同意；
- 把代理配置固定下来：确认能用后，把代理变量写入终端配置文件，避免下次打开新窗口忘记设置而连接失败；
- 固定节点：不要让代理客户端的自动测速组接管 Claude Code 的流量，任务进行中切换节点容易导致中断。
升级与卸载
通过 npm 安装的版本，可以在设置好代理的终端中执行 npm update -g @anthropic-ai/claude-code 升级；部分版本也提供内置的升级命令或自动更新机制，以官方文档为准。需要卸载时执行 npm uninstall -g @anthropic-ai/claude-code。升级失败的原因与安装时类似，多数是 npm 没有走代理。
验证安装
- 执行
claude --version，能输出版本号说明安装成功； - 执行
claude doctor，可检查安装方式与运行环境（命令以当前版本为准）； - 在同一终端执行
curl -I https://api.anthropic.com（Windows PowerShell 中用curl.exe），能返回 HTTP 状态行说明终端到 API 的网络已连通； - 在 Claude Code 中提一个简单问题，能正常流式输出回复即表示一切正常。
常见错误
npm 安装卡住或报 ETIMEDOUT
终端没有走代理，或代理端口填错。确认客户端已连接、端口正确，再按第一步重新设置。
提示 claude 命令不存在
npm 全局目录不在 PATH 中。执行 npm prefix -g 查看全局目录，把其中的可执行文件目录加入 PATH 后重新打开终端。
Node.js 版本过低
安装时出现语法错误或引擎版本警告，通常是 Node.js 太旧，升级到官方要求的版本后重装。
浏览器授权成功，终端却提示登录失败
多数是浏览器和终端的出口不一致，或终端没有走代理。确保两者使用同一支持地区节点；如果设置了代理变量，建议同时设置 NO_PROXY=localhost,127.0.0.1，避免本机回调请求被发往代理。
安装成功但启动后提示连接错误
安装阶段走的是 npm 软件源，使用阶段走的是 Anthropic 的 API 与登录服务，两者的网络路径并不相同。npm 能装上只说明软件源可达，不代表 API 也能连通。常见原因是只用 npm config set 给 npm 设置了代理，却没有在终端设置 HTTPS_PROXY。补上终端代理变量，或开启客户端 TUN 模式后重新运行 claude。
Windows 下该用 PowerShell 还是 WSL
两种方式都可以使用 Claude Code，区别主要在代理设置方式：PowerShell 可以直接使用 127.0.0.1 的代理端口；WSL2 默认网络模式下需要改用 Windows 宿主机 IP，并在代理客户端中开启局域网连接。如果你的项目主要依赖 Linux 工具链，推荐在 WSL 中安装并运行；注意 WSL 里要单独安装 Linux 版 Node.js，不要调用 Windows 侧的 npm。
提示地区不支持
出口 IP 不在支持地区，常见于误用香港节点。换到美国、日本或新加坡节点后重新登录，详见 Region Not Supported 报错解析。
请遵守所在地法律法规以及 Anthropic 的使用条款和支持地区政策。
相关问题
常见问题
Claude Code 需要什么版本的 Node.js？
通过 npm 安装时需要 Node.js 18 或更高版本，具体最低版本以 Anthropic 官方文档为准。可以执行 node -v 查看当前版本，版本过低时建议通过 Node.js 官方安装包或版本管理工具升级。
npm install 一直卡住或报 ETIMEDOUT 怎么办？
说明 npm 访问软件源时没有走代理或网络不通。可以先在终端设置 HTTPS_PROXY 环境变量，或执行 npm config set proxy 和 npm config set https-proxy 为 npm 单独指定代理，然后重新安装。
Claude Code 登录需要什么账号？
可以使用 Claude 付费订阅账号登录，也可以使用 Anthropic Console 账号按 API 用量计费。首次运行 claude 时会让你选择登录方式，具体可选项以当前版本界面为准。
运行 claude 后浏览器没有自动打开怎么办？
终端通常会显示登录链接，可以手动复制到浏览器中打开。请确保浏览器和终端使用同一个支持地区的出口，完成授权后按终端提示操作。
macOS 上安装提示权限不足，可以用 sudo 吗？
官方不建议用 sudo 全局安装，容易带来权限和安全问题。更稳妥的做法是使用 Node 版本管理工具安装 Node.js，或把 npm 全局目录改到用户目录下，再重新执行安装命令。
本文最后更新于 。网络服务与 AI 平台政策变化较快，如发现信息过时，欢迎通过联系我们反馈。