Claude Code 2026 安装教程：原生安装器已发布，告别 Node.js 依赖

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

一、安装前提

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

二、安装方式

Windows

PowerShell（推荐）：

irmhttps://claude.ai/install.ps1|iex

CMD：

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

WinGet：

wingetinstallAnthropic.ClaudeCode

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

macOS

curl-fsSLhttps://claude.ai/install.sh|bash

或通过 Homebrew：

brewinstall--caskclaude-code

验证：claude --version。

Linux

curl-fsSLhttps://claude.ai/install.sh|bash

验证：claude --version。

三、首次启动

在项目目录下执行claude。

两种认证方式：

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

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

  exportANTHROPIC_API_KEY=你的sk-ant-xxx-key claude

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

四、从 npm 迁移

如果你之前通过 npm 安装：

claudeinstall# 自动迁移到原生版本npmuninstall-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手动检查。