3. 安装

本章你将学到

• 5 种安装方式及其适用场景
• 各平台的详细安装步骤
• 如何验证安装和卸载

3.1 安装方式对比

方式	平台	是否自动更新	推荐程度
官方安装脚本	macOS / Linux / WSL	✅ 自动后台更新	⭐⭐⭐ 首选
WinGet	Windows	手动 winget upgrade	⭐⭐⭐ Windows 首选
Homebrew	macOS / Linux	手动 brew upgrade	⭐⭐ 习惯 Homebrew 的用户
apt / dnf / apk	Linux	系统包管理器管理	⭐⭐ Linux 服务器
npm	全平台（需 Node.js 18+）	手动 npm update	⭐ 备选

3.2 方式一：官方安装脚本（推荐）

官方安装脚本会自动配置后台更新，保持 Claude Code 始终是最新版。

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

Windows 前置条件

使用 Windows 原生安装前，请先安装 Git for Windows。安装时勾选「Add Git to PATH」。

• 看到 'irm' is not recognized → 你在 CMD，用 CMD 方式
• 看到 The token '&&' is not a valid statement separator → 你在 PowerShell，用 PS 方式

3.3 方式二：WinGet（Windows 推荐）

# 安装
winget install Anthropic.ClaudeCode

# 手动升级
winget upgrade Anthropic.ClaudeCode

3.4 方式三：Homebrew（macOS / Linux）

# 安装稳定版
brew install --cask claude-code

# 安装最新版（可能包含预览功能）
brew install --cask claude-code@latest

# 手动升级
brew upgrade claude-code

3.5 方式四：Linux 包管理器

Debian / Ubuntu (apt)

# 添加 GPG 密钥
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

RHEL / Fedora (dnf)

sudo dnf config-manager --add-repo \
    https://downloads.claude.ai/claude-code/rpm/claude-code.repo
sudo dnf install claude-code

Alpine (apk)

# 添加 libgcc（某些发行版需要）
apk add libgcc libstdc++

curl -fsSL https://downloads.claude.ai/claude-code/apk/install.sh | sh

3.6 方式五：npm

注意

• 需要 Node.js 18+
• 不要使用 sudo npm install -g，会导致权限问题

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

如果遇到权限问题，先配置 npm 全局目录：

# 创建用户级 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

# 添加到 PATH（加到 ~/.bashrc 或 ~/.zshrc）
export PATH=~/.npm-global/bin:$PATH

# 重新安装
npm install -g @anthropic-ai/claude-code

3.7 验证安装

安装完成后，打开新终端窗口运行：

# 查看版本号
claude --version

# 全面诊断安装与配置
claude doctor

claude doctor 会检查：

• 二进制文件位置
• 版本信息
• 网络连接状态
• 账号认证状态
• 配置文件位置

如果 claude 命令找不到，参见 故障排除。

3.8 卸载

原生安装 macOS/Linux/WSL

# 删除二进制文件
rm -f ~/.local/bin/claude

# 删除程序数据
rm -rf ~/.local/share/claude

原生安装 Windows

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

WinGet

winget uninstall Anthropic.ClaudeCode

Homebrew

brew uninstall --cask claude-code

npm

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

如需彻底删除所有配置和历史记录：

# 注意：这会删除所有 CLAUDE.md、设置、会话历史
rm -rf ~/.claude
rm -f ~/.claude.json

---

下一步：登录认证