2026 年起Anthropic 推出了 Claude Code 原生安装器不再依赖 Node.js 和 npm。这篇教程覆盖 Windows / macOS / Linux 三种平台的安装、首次配置和常见问题。一、安装前提需要一个Claude Pro 及以上订阅Pro Max / Team / Enterprise。免费版不支持 Claude Code不需要预装Node.js、npm 或 Git二、安装方式WindowsPowerShell推荐irmhttps://claude.ai/install.ps1|iexCMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmdWinGetwingetinstallAnthropic.ClaudeCode安装完成后重启终端输入claude --version验证。如果提示找不到命令将%USERPROFILE%\.local\bin添加到系统 PATH 环境变量。macOScurl-fsSLhttps://claude.ai/install.sh|bash或通过 Homebrewbrewinstall--caskclaude-code验证claude --version。Linuxcurl-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-ganthropic-ai/claude-code# 可选清理 npm 残留原生安装器后续会自动在后台更新无需手动操作。六、国内用户补充安装脚本下载慢→ 用代理或改用brew install --cask claude-codeMac/winget install Anthropic.ClaudeCodeWindowsOAuth 授权页面打不开→ 推荐用 API Key 方式export ANTHROPIC_API_KEY你的sk-ant-xxx-key不需要 Pro 订阅国内信用卡无法付款→ 直接用 API Key按用量付费或使用 WildCard 虚拟信用卡注册被风控→ 建议用 Gmail 注册QQ/163 邮箱可能被拦截API 响应慢→ 装 CC Switch 切换到国产模型Qnpm 安装还能用吗A能用但已废弃不再更新新功能。建议尽快迁移到原生安装器。Q安装脚本下载不下来A检查网络连接或使用 WinGet / Homebrew 作为备选。QPowerShell 报禁止运行脚本ASet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned开放脚本权限。或用 CMD 安装绕过。QMac 提示无法验证开发者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手动检查。
