文档索引

在此获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

高级设置

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，请使用以下方法之一：

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

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

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

brew install --cask claude-code

winget install Anthropic.ClaudeCode

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

安装完成后，在你想工作的项目中打开终端并启动 Claude Code：

claude

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

在 Windows 上设置

你可以在 Windows 上原生运行 Claude Code 或在 WSL 内运行。根据你的项目位置和所需功能选择：

选项 1：原生 Windows

从 PowerShell 或 CMD 运行安装命令。你不需要以管理员身份运行。安装 Git for Windows 是可选的。它通过提供 Git Bash 启用 Bash 工具。

从 PowerShell 还是 CMD 安装只影响你运行哪个安装命令。在 PowerShell 中提示符显示 PS C:\Users\YourName>，在 CMD 中显示 C:\Users\YourName>（没有 PS）。如果你是终端新手，终端指南逐步引导每个步骤。

安装后，从任何终端启动 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 访问权限。你也可以使用第三方 API 提供商（如 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry）使用 Claude Code。

安装后，运行 claude 并按照浏览器提示登录。参见认证了解所有账户类型和团队设置选项。

更新 Claude Code

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

自动更新

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

配置发布渠道

使用 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 拒绝安装低于此值的任何版本，因此切换到 "stable" 渠道不会降级你已经使用的更新的 "latest" 构建。

通过 /config 从 "latest" 切换到 "stable" 会提示你保持当前版本或允许降级。选择保持会将 minimumVersion 设置为该版本。切换回 "latest" 会清除它。

将其添加到你的 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 Code 并需要用户保持你提供的版本时使用此选项。

手动更新

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

claude update

高级安装选项

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

安装特定版本

原生安装程序接受特定版本号或发布渠道（latest 或 stable）。你在安装时选择的渠道成为自动更新的默认值。参见配置发布渠道了解更多信息。

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

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

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

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

要安装稳定版本：

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

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

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

要安装特定版本号：

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

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

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 自动更新；更新通过你的正常系统升级工作流到达。

所有仓库都使用 Claude Code 发布签名密钥签名。在信任密钥之前，请按照每个标签页中的说明验证它。

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

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

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

使用 npm 安装

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

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

npm 包安装与独立安装程序相同的原生二进制文件。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 范围，可能不会将你移到最新版本。

二进制完整性和代码签名

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

验证清单签名

步骤 1-3 需要带有 gpg 和 curl 的 POSIX shell。在 Windows 上，在 Git Bash 或 WSL 中运行它们。步骤 4 包含 PowerShell 选项。

1. 下载并导入公钥

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

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

   显示导入密钥的指纹。

   gpg --fingerprint [email protected]
   

   确认输出包含此指纹：

   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 <[email protected]>"。

   gpg 也会为任何新导入的密钥打印 WARNING: This key is not certified with a trusted signature!。这是预期的。Good signature 行确认加密检查通过。步骤 1 中的指纹比较确认密钥本身是真实的。

4. 根据清单检查二进制文件

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

   LinuxmacOSWindows PowerShell

   sha256sum claude
   

   shasum -a 256 claude
   

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

平台代码签名

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

• macOS：由 "Anthropic PBC" 签名并由 Apple 公证。使用 codesign --verify --verbose ./claude 验证。
• Windows：由 "Anthropic, PBC" 签名。使用 Get-AuthenticodeSignature .\claude.exe 验证。
• Linux：二进制文件没有单独的代码签名。如果你直接从 claude-code-releases 存储桶下载或使用原生安装程序，请使用上面的清单签名验证完整性。如果你使用 apt、dnf 或 apk 安装，你的包管理器会使用仓库签名密钥自动验证签名。

卸载 Claude Code

要移除 Claude Code，请按照你的安装方法的说明操作。如果之后 claude 仍然运行，你可能有第二个安装或旧安装程序遗留的 shell 别名。参见检查冲突安装找到并移除它。

原生安装

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

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

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

Homebrew 安装

移除你安装的 Homebrew cask。如果你安装了 stable cask：

brew uninstall --cask claude-code

如果你安装了 latest cask：

brew uninstall --cask claude-code@latest

WinGet 安装

移除 WinGet 包：

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

移除包和仓库配置：

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

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

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 包：

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

移除配置文件

VS Code 扩展、JetBrains 插件和桌面应用也会写入 ~/.claude/。如果其中任何一个仍然安装，目录会在下次运行时重新创建。要完全移除 Claude Code，请在删除这些文件之前卸载 VS Code 扩展、JetBrains 插件和桌面应用。

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

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