Claude Code官方文档安装配置macOSLinuxWindows

Claude Code 高级安装配置 - 三平台、版本管理、卸载完整指南

Claude Code 的系统要求、各平台安装方式、Windows 与 Alpine 等特殊环境配置、版本管理、二进制完整性验证以及完整卸载流程。

发布于 2025年5月1日 · 阅读约 19 分钟

本页面涵盖系统要求、特定平台安装详情、更新和卸载。有关首次会话的引导式演练，请参阅快速入门。

系统要求

Claude Code 在以下平台和配置上运行：

操作系统：
- macOS 13.0+
- Windows 10 1809+ 或 Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
硬件：4 GB+ RAM、x64 或 ARM64 处理器
网络：需要互联网连接。
Shell：Bash、Zsh、PowerShell 或 CMD。在原生 Windows 上，建议使用 Git for Windows；当 Git Bash 不存在时，Claude Code 会回退到 PowerShell。WSL 设置不需要 Git for Windows。
位置：Anthropic 支持的国家/地区

其他依赖项

ripgrep：通常包含在 Claude Code 中。

安装 Claude Code

💡 更喜欢图形界面？桌面应用让您无需使用终端即可使用 Claude Code。下载适用于 macOS 或 Windows 的版本。

要安装 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

ℹ️ 原生安装会在后台自动更新，确保您使用最新版本。

Homebrew

brew install --cask claude-code

ℹ️ Homebrew 安装不会自动更新。运行 brew upgrade claude-code 或 brew upgrade claude-code@latest。

WinGet

winget install Anthropic.ClaudeCode

ℹ️ WinGet 安装不会自动更新。定期运行 winget upgrade Anthropic.ClaudeCode。

您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 安装。

安装完成后，在您要使用的项目中打开终端并启动 Claude Code：

claude

在 Windows 上设置

您可以在 Windows 上原生运行 Claude Code，也可以在 WSL 中运行。根据您的项目位置和所需的功能进行选择：

选项	需要	沙箱	何时使用
原生 Windows	Git for Windows 推荐；如果没有则使用 PowerShell	不支持	Windows 原生项目和工具
WSL 2	WSL 2 已启用	支持	Linux 工具链或沙箱命令执行
WSL 1	WSL 1 已启用	不支持	如果 WSL 2 不可用

选项 1：使用 Git Bash 的原生 Windows

安装 Git for Windows，然后从 PowerShell 或 CMD 运行安装命令。您无需以管理员身份运行。

安装后，从 PowerShell、CMD 或 Git Bash 启动 claude。安装 Git Bash 后，Claude Code 在内部使用它来执行命令，无论您从哪里启动它。如果 Claude Code 找不到您的 Git Bash 安装，请在您的 settings.json 文件中设置路径：

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

Claude Code 也可以在 Windows 上原生运行 PowerShell。安装 Git Bash 后，PowerShell 工具正在逐步推出作为额外选项：设置 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 以选择加入或 0 以选择退出。

选项 2：WSL

打开您的 WSL 发行版并从上面的安装说明中运行 Linux 安装程序。您在 WSL 终端内安装和启动 claude，而不是从 PowerShell 或 CMD。

Alpine Linux 和基于 musl 的发行版

Alpine 和其他基于 musl/uClibc 的发行版上的原生安装程序需要 libgcc、libstdc++ 和 ripgrep。使用您的发行版的包管理器安装这些，然后设置 USE_BUILTIN_RIPGREP=0。

此示例在 Alpine 上安装所需的包：

apk add libgcc libstdc++ ripgrep

然后在您的 settings.json 文件中将 USE_BUILTIN_RIPGREP 设置为 0：

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

验证您的安装

安装后，确认 Claude Code 正常工作：

claude --version

要更详细地检查您的安装和配置，请运行 claude doctor：

claude doctor

身份验证

Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户。免费的 Claude.ai 计划不包括 Claude Code 访问权限。您也可以通过第三方 API 提供商（如 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry）使用 Claude Code。

安装后，通过运行 claude 并按照浏览器提示登录。

更新 Claude Code

原生安装会在后台自动更新。您可以配置发布渠道来控制您是立即接收更新还是按延迟的稳定计划接收更新，或者完全禁用自动更新。Homebrew、WinGet 和 Linux 包管理器安装默认需要手动更新。

自动更新

Claude Code 在启动时和运行时定期检查更新。更新在后台下载和安装，然后在您下次启动 Claude Code 时生效。

ℹ️ Homebrew、WinGet、apt、dnf 和 apk 安装默认不会自动更新；要手动升级 Homebrew，请运行 brew upgrade claude-code 或 brew upgrade claude-code@latest。对于 WinGet，请运行 winget upgrade Anthropic.ClaudeCode。

要让 Claude Code 在 Homebrew 或 WinGet 上为您运行升级命令，请将 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设置为 1。Claude Code 随后会在新版本可用时在后台运行升级，并在成功时显示重启提示。

配置发布渠道

使用 autoUpdatesChannel 设置控制 Claude Code 为自动更新和 claude update 遵循的发布渠道：

"latest"，默认值：在新功能发布后立即接收
"stable"：使用通常约一周前的版本，跳过有重大回归的发布

通过 /config → 自动更新渠道配置此项，或将其添加到您的 settings.json 文件：

{
  "autoUpdatesChannel": "stable"
}

对于企业部署，您可以使用托管设置在整个组织中强制执行一致的发布渠道。

固定最低版本

minimumVersion 设置建立了一个下限。后台自动更新和 claude update 拒绝安装低于此值的任何版本。

将其添加到您的 settings.json 文件以显式固定下限：

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

禁用自动更新

在您的 settings.json 文件的 env 键中将 DISABLE_AUTOUPDATER 设置为 "1"：

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

DISABLE_AUTOUPDATER 仅停止后台检查；claude update 和 claude install 仍然有效。要阻止所有更新路径（包括手动更新），请改为设置 DISABLE_UPDATES。

手动更新

要立即应用更新而不等待下一次后台检查，请运行：

claude update

高级安装选项

这些选项用于版本固定、Linux 包管理器、npm 和验证二进制完整性。

安装特定版本

原生安装程序接受特定版本号或发布渠道（latest 或 stable）。您在安装时选择的渠道将成为自动更新的默认值。

要安装最新版本（默认）：

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

要安装稳定版本：

macOS、Linux、WSL

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

Windows PowerShell

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD

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

要安装特定版本号：

macOS、Linux、WSL

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

Windows PowerShell

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Windows CMD

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

使用 Linux 包管理器安装

Claude Code 发布已签名的 apt、dnf 和 apk 存储库。将 stable 替换为 latest 以使用滚动渠道。包管理器安装不会通过 Claude Code 自动更新；更新通过您的正常系统升级工作流程进行。

apt

适用于 Debian 和 Ubuntu。

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

在信任之前验证 GPG 密钥指纹：gpg --show-keys /etc/apt/keyrings/claude-code.asc 应该报告 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE。

要稍后升级，请运行 sudo apt update && sudo apt upgrade claude-code。

dnf

适用于 Fedora 和 RHEL：

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

要稍后升级，请运行 sudo dnf upgrade claude-code。

apk

适用于 Alpine Linux：

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

要稍后升级，请运行 apk update && apk upgrade claude-code。

使用 npm 安装

您也可以将 Claude Code 安装为全局 npm 包。该包需要 Node.js 18 或更高版本。

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

npm 包安装与独立安装程序相同的原生二进制文件。要升级 npm 安装，请运行 npm install -g @anthropic-ai/claude-code@latest。

⚠️ 不要使用 sudo npm install -g，因为这可能导致权限问题和安全风险。

二进制完整性和代码签名

每个发布都发布一个 manifest.json，其中包含每个平台二进制文件的 SHA256 校验和。清单使用 Anthropic GPG 密钥签名，因此验证清单上的签名可以传递地验证它列出的每个二进制文件。

验证清单签名

步骤 1：下载并导入公钥

发布签名密钥发布在固定 URL。

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

显示导入的密钥的指纹。

gpg --fingerprint security@anthropic.com

确认输出包含此指纹：

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

步骤 2：下载清单和签名

将 VERSION 设置为您要验证的发布。

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

步骤 3：验证签名

针对清单验证分离的签名。

gpg --verify manifest.json.sig manifest.json

有效的结果报告 Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>"。

步骤 4：根据清单检查二进制文件

将您下载的二进制文件的 SHA256 校验和与 manifest.json 中 platforms.<platform>.checksum 下列出的值进行比较。

Linux：

sha256sum claude

macOS：

shasum -a 256 claude

Windows PowerShell：

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

ℹ️ 清单签名可用于 2.1.89 及以后的发布。较早的发布在 manifest.json 中发布校验和，但没有分离的签名。

平台代码签名

除了签名的清单外，各个二进制文件在支持的地方还带有平台原生代码签名。

macOS：由”Anthropic PBC”签名并由 Apple 公证。使用 codesign --verify --verbose ./claude 验证。
Windows：由”Anthropic, PBC”签名。使用 Get-AuthenticodeSignature .\claude.exe 验证。
Linux：二进制文件不单独进行代码签名。

卸载 Claude Code

要删除 Claude Code，请按照您的安装方法的说明进行操作。

原生安装

删除 Claude Code 二进制文件和版本文件：

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 安装

如果您安装了稳定版 cask：

brew uninstall --cask claude-code

如果您安装了最新版 cask：

brew uninstall --cask claude-code@latest

WinGet 安装

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

apt：

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

dnf：

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk：

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

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

删除配置文件

⚠️ 删除配置文件将删除您的所有设置、允许的工具、MCP 服务器配置和会话历史记录。

要删除 Claude Code 设置和缓存数据：

macOS、Linux、WSL：

# 删除用户设置和状态
rm -rf ~/.claude
rm ~/.claude.json

# 删除特定于项目的设置（从您的项目目录运行）
rm -rf .claude
rm -f .mcp.json

Windows PowerShell：

# 删除用户设置和状态
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# 删除特定于项目的设置（从您的项目目录运行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。