Claude Code 管理与部署

高级安装配置

4 分钟阅读

高级设置

Claude Code 的系统要求、各平台安装方式、版本管理和卸载方法。

本页面介绍系统要求、各平台的安装详情、更新和卸载。首次会话的引导式教程请参阅快速入门。如果你从未使用过终端，请参阅终端指南。

系统要求

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。
地区：Anthropic 支持的国家和地区

其他依赖

ripgrep：通常随 Claude Code 一起提供。如果搜索失败，请参阅搜索故障排除。

安装 Claude Code

更喜欢图形界面？通过桌面应用，无需终端即可使用 Claude Code。可下载 macOS、Windows 或 Linux 版本。

第一次使用终端？请参阅终端指南中的分步说明。

使用以下任一方式安装 Claude Code：

原生安装（推荐）
Homebrew
WinGet

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

如果看到 The token '&&' is not a valid statement separator，说明你使用的是 PowerShell，而不是 CMD。如果看到 'irm' is not recognized as an internal or external command，说明你使用的是 CMD，而不是 PowerShell。在 PowerShell 中，Prompt 显示为 PS C:\；在 CMD 中则显示为不带 PS 的 C:\。

如果安装命令因 syntax error near unexpected token '<'、403 或其他 curl 错误而失败，请参阅安装故障排除，根据错误找到修复方法和其他安装方式。

建议在原生 Windows 上安装 Git for Windows，以便 Claude Code 使用 Bash 工具。如果没有安装 Git for Windows，Claude Code 会改用 PowerShell 作为 shell 工具。WSL 环境不需要 Git for Windows。

原生安装会在后台自动更新，使你始终使用最新版本。

brew install --cask claude-code

Homebrew 提供两个 cask。claude-code 跟踪稳定发布通道，通常比最新版本晚约一周，并跳过存在严重回归的版本。claude-code@latest 跟踪最新通道，新版本发布后会立即收到。

Homebrew 安装不会自动更新。根据安装的 cask，运行 brew upgrade claude-code 或 brew upgrade claude-code@latest，以获取最新功能和安全修复。

在 Debian、Fedora、RHEL 和 Alpine 上，还可以通过 apt、dnf 或 apk安装。

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

claude

如果安装过程中遇到任何问题，请参阅安装和登录故障排除。

在 Windows 上设置

你可以在 Windows 原生环境或 WSL 中运行 Claude Code。请根据项目所在位置和所需功能进行选择：

选项	要求	沙箱	适用场景
原生 Windows	无；可选择安装 Git for Windows	不支持	Windows 原生项目和工具
WSL 2	已启用 WSL 2	支持	Linux 工具链或沙箱化命令执行
WSL 1	已启用 WSL 1	不支持	无法使用 WSL 2 时

选项 1：原生 Windows

在 PowerShell 或 CMD 中运行安装命令，无需以管理员身份运行。可以选择安装 Git for Windows，它会提供 Git Bash，从而启用 Bash 工具。

从 PowerShell 还是 CMD 安装，只会影响需要运行哪条安装命令。在 PowerShell 中，Prompt 显示为 PS C:\Users\YourName>；在 CMD 中则显示为不带 PS 的 C:\Users\YourName>。如果你刚开始使用终端，终端指南会逐步讲解每项操作。

安装后，可以从任何终端启动 claude。

未安装 Git for Windows 时，Claude Code 通过 PowerShell 工具运行 shell 命令。
已安装 Git for Windows 时，Claude Code 通过 Git Bash 使用 Bash 工具。如果 Claude Code 找不到 Git Bash，请在 settings.json 文件中设置路径：
```
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

安装 Git for Windows 后，PowerShell 工具会作为 Bash 之外的另一项选择逐步推出。设置 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 可选择加入，设为 0 可选择退出。有关设置和限制，请参阅 PowerShell 工具。

选项 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

如果出现 command not found 或其他错误，请参阅安装和登录故障排除。

如需更详细地检查安装和配置，请运行 claude doctor：

claude doctor

身份验证

Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户。免费的 Claude.ai 方案不包含 Claude Code 访问权限。你也可以通过 Amazon Bedrock、Google Cloud's Agent Platform或 Microsoft Foundry 等第三方 API 提供商使用 Claude Code。

安装后，运行 claude 并按照浏览器提示登录。有关所有账户类型和团队设置选项，请参阅身份验证。

更新 Claude Code

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

自动更新

Claude Code 会在启动时及运行期间定期检查更新。更新会在后台下载并安装，在下次启动 Claude Code 时生效。

运行 claude doctor 可以查看最近一次更新尝试的结果。

如果通过 npm 全局安装，而 npm 全局目录不可写，导致无法自动更新，Claude Code 会在启动时显示一次性通知，claude doctor 则会列出可用的解决方法。详情请参阅安装期间的权限错误。

Homebrew、WinGet、apt、dnf 和 apk 安装默认不会自动更新；下面会介绍如何为 Homebrew 和 WinGet 选择加入。要手动升级 Homebrew，请根据安装的 cask 运行 brew upgrade claude-code 或 brew upgrade claude-code@latest。对于 WinGet，请运行 winget upgrade Anthropic.ClaudeCode。对于 Linux 包管理器，请参阅使用 Linux 包管理器安装中的升级命令。

要让 Claude Code 代你在 Homebrew 或 WinGet 上运行升级命令，请将 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设为 1。此后有新版本时，Claude Code 会在后台运行升级，成功后提示重新启动。升级只以 Claude Code 软件包为目标，不影响已安装的其他软件。

在 WinGet 上，Claude Code 运行期间 Windows 会锁定可执行文件，因此升级可能失败。遇到这种情况，Claude Code 会改为显示手动命令。apt、dnf 和 apk 仍需手动升级，因为相应命令需要提升的权限。

**已知问题：**Claude Code 可能会在新版本尚未进入这些包管理器前就发出更新通知。如果升级失败，请稍后重试。

Homebrew 会在升级后将旧版本保留在磁盘上。请定期运行 brew cleanup 释放磁盘空间。

配置发布通道

通过 autoUpdatesChannel 设置，控制 Claude Code 在自动更新和 claude update 时使用哪个发布通道：

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

通过 /config → Auto-update channel 配置，或添加到 settings.json 文件：

{
  "autoUpdatesChannel": "stable"
}

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

Homebrew 安装按 cask 名称选择通道，而不使用此设置：claude-code 跟踪 stable，claude-code@latest 跟踪 latest。

固定最低版本

minimumVersion 设置用于确定版本下限。后台自动更新和 claude update 会拒绝安装低于此值的版本，因此，如果已经使用较新的 "latest" 构建版本，切换到 "stable" 通道不会将版本降级。

通过 /config 从 "latest" 切换到 "stable" 时，系统会提示你选择保留当前版本或允许降级。选择保留会将 minimumVersion 设为当前版本。切换回 "latest" 会清除此值。

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

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

在托管设置中，这会强制设置组织级最低版本，用户和项目设置均无法覆盖。

minimumVersion 只约束更新。要让 Claude Code 在版本不处于指定范围时拒绝启动，请改用托管设置 requiredMinimumVersion 和 requiredMaximumVersion。更新也会遵守 requiredMaximumVersion 上限。请参阅可用设置。

禁用自动更新

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

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

DISABLE_AUTOUPDATER 只会停止后台检查；claude update 和 claude install 仍然有效。要阻止包括手动更新在内的所有更新路径，请改为设置 DISABLE_UPDATES。如果通过自己的渠道分发 Claude Code，并要求用户继续使用指定版本，请使用此设置。

手动更新

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

claude update

高级安装选项

以下选项适用于固定版本、使用 Linux 包管理器和 npm，以及验证二进制文件完整性。

安装特定版本

原生安装程序接受特定版本号，也接受发布通道（latest 或 stable）。安装时选择的通道会成为自动更新的默认通道。有关更多信息，请参阅配置发布通道。

安装最新版本（默认）：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

安装稳定版本：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

安装特定版本号：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

使用 Linux 包管理器安装

Claude Code 发布经过签名的 apt、dnf 和 apk 仓库。每个仓库提供两个通道：stable 提供通常约一周前的版本，并跳过存在严重回归的版本；latest 则在每个版本发布后立即提供。以下命令配置适合大多数用户的 stable 通道；各标签页也会显示 latest 仓库 URL。通过包管理器安装的 Claude Code 不会自行自动更新；更新会通过常规系统升级工作流送达。

所有仓库均使用 Claude Code 发布签名 key进行签名。信任该 key 前，请按照各标签页中的说明进行验证。

适用于 Debian 和 Ubuntu。以下安装命令使用 curl 下载签名 key，但全新安装的 Debian 和 Ubuntu 可能不包含 curl。如果下载失败并显示 sudo: curl: command not found，请先安装 curl：

sudo apt install curl

以下命令配置 stable 通道：

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

如果改用 latest 通道，URL 路径和 suite 名称都需要更改。请使用以下 deb 行：

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list

信任 GPG key 前，请验证其指纹：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。

适用于 Fedora 和 RHEL。以下命令配置 stable 通道：

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

如果改用 latest 通道，请将 baseurl 设为 latest 仓库：

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

dnf 会在首次安装时下载 key，并提示你确认指纹。接受前，请验证它与 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE 一致。

日后升级时，运行 sudo dnf upgrade claude-code。

适用于 Alpine Linux。以下命令配置 stable 通道：

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

要切换到 latest 通道，请删除 stable 仓库行，再添加 latest 仓库：

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

运行 sha256sum /etc/apk/keys/claude-code.rsa.pub 验证下载的 key；它应报告 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6。

日后升级时，运行 apk update && apk upgrade claude-code。

使用 npm 安装

也可以将 Claude Code 安装为全局 npm package。自 v2.1.198 起，npm package 需要 Node.js 22 或更高版本。使用更早的 Node.js 版本时，npm 会在安装期间输出 EBADENGINE 警告，而不是使安装失败；安装仍会完成，claude 也仍可运行，因为该 package 下载的是原生二进制文件，运行时并不使用你的 Node.js。

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

npm package 安装的原生二进制文件与独立安装程序相同。npm 通过 @anthropic-ai/claude-code-darwin-arm64 等各平台可选依赖获取二进制文件，再由 postinstall 步骤将其链接到位。安装后的 claude 二进制文件本身不会调用 Node。

npm 支持的安装平台包括 darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64 和 win32-arm64。包管理器必须允许安装可选依赖。如果安装后缺少二进制文件，请参阅故障排除。

要升级 npm 安装，请运行 npm install -g @anthropic-ai/claude-code@latest。不要使用 npm update -g，因为它会遵守初次安装时的 semver 范围，可能无法升级到最新版本。

请勿使用 sudo npm install -g，否则可能导致权限问题和安全风险。如果遇到权限错误，请参阅权限错误故障排除。

二进制文件完整性和代码签名

每个发布版本都会提供一个 manifest.json，其中包含各平台二进制文件的 SHA256 checksum。该 manifest 由 Anthropic GPG key 签名，因此，验证 manifest 的签名，也就间接验证了其中列出的所有二进制文件。

验证 manifest 签名

第 1–3 步需要带有 gpg 和 curl 的 POSIX shell。在 Windows 上，请通过 Git Bash 或 WSL 运行。第 4 步还提供 PowerShell 选项。

下载并导入公钥

发布签名 key 位于固定 URL。

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

显示已导入 key 的指纹。

gpg --fingerprint security@anthropic.com

确认输出包含以下指纹：

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

下载 manifest 和签名

将 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"

验证签名

根据 manifest 验证 detached signature。

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

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

对于任何刚导入的 key，gpg 还会输出 WARNING: This key is not certified with a trusted signature!，这是正常现象。Good signature 行确认密码学检查已通过，第 1 步的指纹比较则确认 key 本身真实可信。

根据 manifest 检查二进制文件

将二进制文件的 SHA256 checksum 与 manifest.json 中 platforms.<platform>.checksum 下列出的值进行比较。以下命令假设当前目录中有一个 claude 二进制文件。要改为验证已安装的原生二进制文件，请对 ~/.local/share/claude/versions/VERSION 运行相应命令，并将 VERSION 替换为第 2 步中设置的发布版本。

Linux
macOS
Windows PowerShell

sha256sum claude

2.1.89 及之后的发布版本提供 manifest 签名。更早的发布版本只在 manifest.json 中发布 checksum，不提供 detached signature。

平台代码签名

除了已签名的 manifest，各二进制文件在平台支持的情况下也会携带平台原生代码签名。

macOS：由“Anthropic PBC”签名，并经过 Apple 公证。使用 codesign --verify --verbose ./claude 验证。
Windows：由“Anthropic, PBC”签名。使用 Get-AuthenticodeSignature .\claude.exe 验证。
Linux：二进制文件没有单独进行代码签名。如果直接从 claude-code-releases bucket 下载或使用原生安装程序，请通过上述 manifest 签名验证完整性。如果使用 apt、dnf 或 apk安装，包管理器会使用仓库签名 key 自动验证签名。

卸载 Claude Code

要移除 Claude Code，请按照所用安装方式执行相应说明。如果之后 claude 仍能运行，系统中可能还存在第二份安装，或旧版安装程序留下的 shell alias。请参阅检查冲突安装，找到并移除它。

原生安装

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

macOS、Linux、WSL
Windows PowerShell

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

Homebrew 安装

移除已安装的 Homebrew cask。如果安装的是稳定版 cask：

brew uninstall --cask claude-code

如果安装的是最新 cask：

brew uninstall --cask claude-code@latest

WinGet 安装

移除 WinGet package：

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

移除 package 和仓库配置：

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

npm

移除全局 npm package：

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

移除配置文件

移除配置文件会删除所有设置、允许使用的工具、MCP 服务器配置和会话历史。

VS Code 扩展、JetBrains 插件和桌面应用也会写入 ~/.claude/。如果其中任何一个仍处于安装状态，下次运行时都会重新创建该目录。要彻底移除 Claude Code，请先卸载 VS Code 扩展、JetBrains 插件和桌面应用，再删除这些文件。

移除 Claude Code 设置和缓存数据：

macOS、Linux、WSL
Windows PowerShell

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

# 移除项目专用设置（请在项目目录中运行）
rm -rf .claude
rm -f .mcp.json

# 移除用户设置和状态
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