3. 安装 Claude Code

本节目标：把 Claude Code 装到你的电脑上，验证安装成功，知道怎么升级和卸载。

安装前先看系统要求

Claude Code 不挑机器，但有几个最低门槛：

操作系统（满足任一）：

macOS 13.0+
Windows 10 1809+ 或 Windows Server 2019+
Ubuntu 20.04+
Debian 10+
Alpine Linux 3.19+

硬件：4 GB+ 内存，x64 或 ARM64 处理器。

其他：

需要互联网连接（要连 claude.ai 和 Anthropic API）
Shell：Bash、Zsh、PowerShell 或 CMD
所在国家/地区需在 Anthropic 支持列表内

Warning

Claude Code 需要连通 claude.ai 和 Anthropic API 端点。中国大陆网络可能无法直接访问，开始前请确认你的网络能连通这些服务。具体网络配置见下一章。

五种安装方式

Claude Code 有五种安装方式，选一个就行。官方推荐原生安装器，因为它支持后台自动更新。

方式	平台	自动更新	推荐度
原生安装器	全平台	是	推荐
Homebrew	macOS	否（手动）	macOS 用户可选
WinGet	Windows	否（手动）	Windows 用户可选
npm	全平台	否（手动）	已有 Node.js 环境的
Linux 包管理器	Linux	否（手动）	Linux 服务器用户

方式一：原生安装器（推荐）

原生安装器直接下载编译好的二进制文件，不依赖 Node.js，装完自动后台更新。

macOS / Linux / WSL：

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

Windows PowerShell：

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

Windows CMD：

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

Tip

怎么判断你在 PowerShell 还是 CMD？看提示符：PS C:\> 是 PowerShell，C:\> 不带 PS 的是 CMD。irm 命令只在 PowerShell 能用，&& 连接符只在 CMD 能用。

Windows 上建议装一下 Git for Windows，这样 Claude Code 能用 Bash 工具。不装的话会退而用 PowerShell。WSL 不需要 Git for Windows。

原生安装会在后台自动更新，始终保持最新版。省心。

方式二：Homebrew（macOS）

brew install --cask claude-code

Homebrew 提供两个 cask：

claude-code：稳定版，大约比最新版晚一周，跳过有重大问题的版本
claude-code@latest：最新版，发布即更新

Homebrew 安装不会自动更新，得手动跑：

brew upgrade claude-code
# 或
brew upgrade claude-code@latest

方式三：WinGet（Windows）

winget install Anthropic.ClaudeCode

同样不自动更新，定期手动升级：

winget upgrade Anthropic.ClaudeCode

Note

WinGet 在 Claude Code 运行时升级可能失败，因为 Windows 会锁住可执行文件。遇到这种情况 Claude Code 会提示你手动执行命令。

方式四：npm

如果你已经有 Node.js 环境，也可以用 npm 装：

npm install -g @anthropic-ai/claude-code

从 v2.1.198 开始，npm 包需要 Node.js 22 或更高版本。旧版 Node.js 会打印警告但不会安装失败。

Warning

不要用 sudo npm install -g，会导致权限问题和安全风险。遇到权限错误请查阅官方故障排除文档。

升级用：

npm install -g @anthropic-ai/claude-code@latest

别用 npm update -g，它可能不会更新到最新版。

方式五：Linux 包管理器

Debian/Ubuntu 用 apt，Fedora/RHEL 用 dnf，Alpine 用 apk。以 apt 为例：

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

每个包管理器都有 stable 和 latest 两个渠道。stable 大约比最新版晚一周，latest 发布即更新。

升级走系统正常更新流程，比如 sudo apt update && sudo apt upgrade claude-code。

Windows 上的选择：原生还是 WSL

Windows 用户有个选择题：用原生 Windows 还是 WSL？

选项	需要	沙箱支持	适合
原生 Windows	无，Git for Windows 可选	不支持	Windows 原生项目和工具
WSL 2	WSL 2 已启用	支持	Linux 工具链、需要沙箱
WSL 1	WSL 1 已启用	不支持	WSL 2 不可用时

简单说：如果你的项目跑在 Windows 上（比如 .NET），用原生。如果你的项目是 Linux 工具链（比如 Node.js 服务端），用 WSL 2。

装了 Git for Windows 后，Claude Code 会用 Git Bash 跑 shell 命令。如果找不到 Git Bash，在 settings.json 里指定路径：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

验证安装

装完了，验证一下：

claude --version

能打印版本号就说明装好了。如果报 command not found，检查一下 PATH 环境变量，或者重启终端。

想更详细地检查安装和配置状态：

claude doctor

这个命令会跑一套诊断，检查安装健康度、配置文件、PATH 问题等，有问题会告诉你怎么修。

安装特定版本

有时候你需要装某个特定版本（比如回退到旧版排查问题）。

原生安装器支持指定版本号：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash -s -- 2.1.118

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex -Args "2.1.118"

也可以指定渠道：

claude install stable
claude install latest

升级与更新

自动更新（原生安装器）

原生安装器会在后台自动检查更新、下载安装。你下次启动 Claude Code 时就生效了。

想控制更新节奏，配置发布渠道：

{
  "autoUpdatesChannel": "stable"
}

"latest"（默认）：新功能发布即收到
"stable"：大约晚一周，跳过有重大问题的版本

手动更新

不等后台检查，立即更新：

claude update

Homebrew 和 WinGet 用各自的升级命令（见上面各安装方式）。

禁用自动更新

在某些环境（比如 CI）你不想自动更新，在 settings.json 里：

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

这只停后台自动检查，claude update 和 claude install 仍然有效。要彻底禁用所有更新路径，设 DISABLE_UPDATES。

卸载

卸载方式取决于你怎么装的。

原生安装卸载

macOS / Linux / WSL：

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell：

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew 卸载

brew uninstall --cask claude-code
# 或
brew uninstall --cask claude-code@latest

WinGet 卸载

winget uninstall Anthropic.ClaudeCode

npm 卸载

npm uninstall -g @anthropic-ai/claude-code

Linux 包管理器卸载

以 apt 为例：

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

Note

卸载后如果 claude 命令还能运行，说明你有多个安装或旧版残留。检查一下 PATH 里有没有其他 claude 可执行文件。VS Code 扩展、JetBrains 插件和桌面应用也会往 ~/.claude/ 写东西，要彻底清除得先卸载这些。

装完了下一步

安装成功后，进入你的项目目录，运行 claude 启动：

cd your-project
claude

第一次运行会让你登录认证。下一章讲登录与认证的细节。