Claude Code安装教程
现在装 Claude Code，优先走原生安装（官方脚本 / Homebrew / WinGet），不必先装 Node、也不要把 npm install -g 当默认路径。订阅需要 Pro / Max / Team（或企业）；免费计划装上了也会卡在登录或额度。
分平台细节可对照：
系统要求（简表）
| 平台 | 要求 |
|---|---|
| macOS | 13+（Ventura 及以上） |
| Linux | 常见发行版；WSL2 可用 Linux 脚本 |
| Windows | 原生 PowerShell / WinGet；也可选 WSL |
| 账号 | Pro / Max / Team（或企业）订阅 |
| 网络 | 能访问官方安装与登录域名；国内网络见下方链接 |
装之前一般不需要全局 Node。若机器里还留着旧的 @anthropic-ai/claude-code npm 包，建议卸掉，避免 PATH 里两个 claude 抢命令。
macOS / Linux：官方脚本（推荐）
一行安装：
curl -fsSL https://claude.ai/install.sh | bash脚本通常把二进制放到 ~/.local/bin/claude，并尽量写入 shell 配置。装完新开一个终端再验证。
Homebrew（可选）
习惯用 brew 管软件时：
brew install --cask claude-code不要和官方脚本混装抢 PATH。用 which -a claude 确认实际命中哪一个。macOS 对照说明见 macOS 安装。
Windows：PowerShell / WinGet
PowerShell（推荐原生）
在 PowerShell（不是把 mac 命令硬贴进 CMD）执行：
irm https://claude.ai/install.ps1 | iex无需管理员权限。装完新开终端，再跑 claude --version。
WinGet
winget install Anthropic.ClaudeCodeWinGet 不会自动更新，需要时再执行 winget upgrade Anthropic.ClaudeCode。不要同时保留脚本安装与 WinGet 两份，避免重复可执行文件。
WSL（可选）
项目主要在 Linux 文件系统时，可在 WSL 终端里走上面的 Linux install.sh。Windows 与 WSL 混用剪贴板、PATH 时，对照 安装排错。
验证：版本、doctor、PATH
claude --version
claude doctor
command -v claude # Windows PowerShell 可用 Get-Command claude官方脚本常见路径是 ~/.local/bin。若提示 command not found：
export PATH="$HOME/.local/bin:$PATH"
# zsh 示例：写入 ~/.zshrc 后 source
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcclaude doctor 比只看版本号更靠谱，网络、登录态、二进制问题会直接标出来。
登录与账号
终端运行 claude，按提示用浏览器完成 Anthropic 账号 OAuth。注意：
- 浏览器登录的必须是已订阅的账号。
- 若环境里残留过期或临时的
ANTHROPIC_API_KEY，可能盖掉订阅登录、走 API Key 路径。调试完请unset ANTHROPIC_API_KEY，并检查 shell profile / CI 是否还在 export。 - 登录 403、授权码粘贴失败、地区不可用，先看 安装排错 与 国内使用。
更新
| 安装方式 | 更新 |
|---|---|
| 官方原生脚本 | 客户端侧自动更新为主；异常时可重跑安装脚本 |
| Homebrew | brew upgrade --cask claude-code |
| WinGet | winget upgrade Anthropic.ClaudeCode |
大版本变更后建议再跑一次 claude doctor。
npm 仅作备选（不推荐主路径）
只有在原生安装不可用、且你明确需要 npm 全局包时，才考虑：
# 需要较新的 Node（官方当前要求偏新，建议 Node 22+）
npm install -g @anthropic-ai/claude-code这不是当前推荐主路径：更新、PATH、与原生包冲突都更容易踩坑。能走 install.sh / install.ps1 / brew / winget，就优先走那些。