2026 年起，Anthropic 推出了 Claude Code 原生安装器，不再依赖 Node.js 和 npm。这篇教程覆盖 Windows / macOS / Linux 三种平台的安装、首次配置和常见问题。

---

一、安装前提

• 需要一个 Claude Pro 及以上订阅（Pro Max / Team / Enterprise）。免费版不支持 Claude Code
• 不需要预装 Node.js、npm 或 Git

---

二、安装方式

Windows

PowerShell（推荐）：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

WinGet：

winget install Anthropic.ClaudeCode

安装完成后重启终端，输入 claude --version 验证。如果提示找不到命令，将 %USERPROFILE%\.local\bin 添加到系统 PATH 环境变量。

---

macOS

curl -fsSL https://claude.ai/install.sh | bash

或通过 Homebrew：

brew install --cask claude-code

验证：claude --version。

---

Linux

curl -fsSL https://claude.ai/install.sh | bash

验证：claude --version。

---

三、首次启动

在项目目录下执行 claude。

两种认证方式：

• OAuth（默认）：打开浏览器授权，需要 Claude Pro 及以上订阅（$20/月）。国内信用卡无法直接付款，需虚拟信用卡。

• API Key（推荐国内用户）：不需要 Pro 订阅，按 API 用量付费。新用户有 $5 免费额度。

  export ANTHROPIC_API_KEY=你的sk-ant-xxx-key
  claude
  

启动成功后终端显示 > 提示符。

---

四、从 npm 迁移

如果你之前通过 npm 安装：

claude install     # 自动迁移到原生版本
npm uninstall -g @anthropic-ai/claude-code   # 可选，清理 npm 残留

原生安装器后续会自动在后台更新，无需手动操作。

---

六、国内用户补充

1. 安装脚本下载慢 → 用代理，或改用 brew install --cask claude-code（Mac）/ winget install Anthropic.ClaudeCode（Windows）
2. OAuth 授权页面打不开 → 推荐用 API Key 方式：export ANTHROPIC_API_KEY=你的sk-ant-xxx-key，不需要 Pro 订阅
3. 国内信用卡无法付款 → 直接用 API Key（按用量付费），或使用 WildCard 虚拟信用卡
4. 注册被风控 → 建议用 Gmail 注册，QQ/163 邮箱可能被拦截
5. API 响应慢 → 装 CC Switch 切换到国产模型

---

Q：npm 安装还能用吗？
A：能用但已废弃，不再更新新功能。建议尽快迁移到原生安装器。

Q：安装脚本下载不下来？
A：检查网络连接，或使用 WinGet / Homebrew 作为备选。

Q：PowerShell 报"禁止运行脚本"？
A：Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned 开放脚本权限。或用 CMD 安装绕过。

Q：Mac 提示"无法验证开发者"？
A：执行 xattr -d com.apple.quarantine $(which claude)，权限不够加 sudo。

Q：启动提示 “not included in your plan”？
A：升级到 Claude Pro 及以上订阅即可。

Q：装完 claude 命令找不到？
A：手动将安装目录添加到系统 PATH 环境变量。

Q：注册 API Key 需要手机验证？
A：中国手机号 +86 可用。收不到验证码用 Google 账号直接注册。

Q：自动更新失败？
A：执行 claude update 手动检查。