本文覆盖 Claude Code 的完整安装细节，包括系统要求、平台特定配置、版本管理和卸载方法。
系统要求
操作系统支持
| 系统 | 最低版本 |
|---|---|
| macOS | 13.0+ |
| Windows | 10 1809+ 或 Windows Server 2019+ |
| Ubuntu | 20.04+ |
| Debian | 10+ |
| Alpine Linux | 3.19+ |
其他要求：
- 内存：4 GB+ RAM
- 网络：需要互联网连接（网络配置要求）
- Shell：Bash、Zsh、PowerShell 或 CMD（Windows 需要 Git for Windows）
- 地区：Anthropic 支持的国家/地区
三种安装方式
方式一：Native 安装（推荐）
macOS / Linux / WSL：
bash
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
powershell
irm https://claude.ai/install.ps1 | iexWindows CMD：
cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdNative 安装会自动在后台更新到最新版本。
方式二：Homebrew（macOS）
bash
brew install --cask claude-codeHomebrew 安装不自动更新，需手动运行
brew upgrade claude-code。
方式三：WinGet（Windows）
powershell
winget install Anthropic.ClaudeCodeWinGet 安装不自动更新，需手动运行
winget upgrade Anthropic.ClaudeCode。
Windows 平台配置
Claude Code 在 Windows 上需要 Git for Windows 或 WSL。可从 PowerShell、CMD 或 Git Bash 启动，Claude Code 内部使用 Git Bash 运行命令（不需要以管理员权限运行 PowerShell）。
选项一：原生 Windows + Git Bash
安装 Git for Windows 后运行安装命令。若 Claude Code 找不到 Git Bash，手动配置路径：
json
// settings.json
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}选项二：WSL
- WSL 1 和 WSL 2 均支持
- WSL 2 支持沙箱隔离（增强安全性）
- WSL 1 不支持沙箱功能
Alpine Linux / musl 系发行版
bash
# 安装依赖
apk add libgcc libstdc++ ripgrepjson
// settings.json
{
"env": {
"USE_BUILTIN_RIPGREP": "0"
}
}验证安装
bash
claude --version # 查看版本号
claude doctor # 运行诊断检查（检测常见配置问题）版本管理
自动更新
Native 安装默认在后台自动更新。两个更新频道：
| 频道 | 特点 | 配置值 |
|---|---|---|
latest（默认） | 最新版本，第一时间获取新功能 | "latest" |
stable | 约落后一周，跳过有重大问题的版本 | "stable" |
配置更新频道：
json
// settings.json
{ "autoUpdatesChannel": "stable" }或通过命令行：
bash
claude config set autoUpdatesChannel stable禁用自动更新
bash
export CLAUDE_CODE_DISABLE_AUTOUPDATER=1或在 settings.json 中持久化：
json
{ "env": { "CLAUDE_CODE_DISABLE_AUTOUPDATER": "1" } }手动更新
bash
claude update # 检查并安装最新版本安装特定版本
bash
claude update --version 1.2.3从 npm 迁移到 Native 安装
bash
npm uninstall -g @anthropic-ai/claude-code # 卸载 npm 版本
curl -fsSL https://claude.ai/install.sh | bash # 安装 Native 版本二进制完整性与代码签名
- macOS：二进制文件由 Anthropic 代码签名，Gatekeeper 可验证
- Windows：可执行文件经 Authenticode 签名
- Linux：通过 SHA-256 校验和验证完整性
完整卸载步骤
Native 安装卸载
macOS / Linux：
bash
claude uninstallWindows（PowerShell）：
powershell
$env:APPDATA\...\ # 通过控制面板「程序和功能」卸载Homebrew 卸载
bash
brew uninstall --cask claude-codeWinGet 卸载
powershell
winget uninstall Anthropic.ClaudeCodenpm 卸载
bash
npm uninstall -g @anthropic-ai/claude-code移除配置文件（可选，彻底清理）
bash
# macOS / Linux
rm -rf ~/.claude ~/.claude.json
# Windows
# 删除 %APPDATA%\Claude 和 %USERPROFILE%\.claude删除配置文件后，登录凭证、设置和会话历史将全部清除。
原文：Advanced setup - Claude Code Docs | 来源：Anthropic 官方文档