Claude Code 高级安装指南：多平台安装、版本管理与完整性校验

本页目录12

AI 摘要 · 已核查整理于 2026-05-22原文:Advanced setup(Anthropic)配置

要点速览

原生安装脚本（install.sh / install.ps1）是推荐方式，支持后台自动更新；npm 安装的是同一原生二进制，同样自动更新，而 Homebrew、WinGet 及 Linux 包管理器安装默认需手动升级。
Windows 用户可选原生安装或 WSL 2；安装 Git for Windows 后可用 Bash 工具，否则默认使用 PowerShell 工具。
通过 settings.json 中的 `autoUpdatesChannel` 字段可在 `latest` 与 `stable` 频道间切换；`minimumVersion` 可防止意外降级。
企业部署可使用托管设置强制统一版本范围，包括 `requiredMinimumVersion` 与 `requiredMaximumVersion`。
官方对每个发布都提供含 SHA256 校验值的 `manifest.json` 以验证二进制完整性，其 GPG detached 签名（manifest.json.sig）自 2.1.89 版起提供；macOS/Windows 还支持平台原生代码签名。
卸载时注意同步删除配置目录 `~/.claude` 与 `~/.claude.json`，否则设置、MCP 配置和会话历史将被保留。

本文是对官方文档「Advanced setup」的中文要点摘要，完整内容以原文为准。原文链接：https://code.claude.com/docs/en/setup

系统要求

Claude Code 对运行环境有明确要求：

操作系统：macOS 13.0+、Windows 10 1809+/Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+
硬件：4 GB+ 内存，x64 或 ARM64 处理器
网络：必须联网
Shell：Bash、Zsh、PowerShell 或 CMD
账号：需要 Pro、Max、Team、Enterprise 或 Console 账号；免费版 Claude.ai 不含 Claude Code 权限

安装方式

原生安装脚本（推荐）

macOS / Linux / WSL：

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

Windows PowerShell：

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

原生安装在后台自动更新，无需手动干预，是大多数用户的首选。

其他安装方式对比

方式	命令	是否自动更新
Homebrew stable	`brew install --cask claude-code`	否，需手动 `brew upgrade claude-code`
Homebrew latest	`brew install --cask claude-code@latest`	否
WinGet	`winget install Anthropic.ClaudeCode`	否，需手动 `winget upgrade Anthropic.ClaudeCode`
npm	`npm install -g @anthropic-ai/claude-code`	是，安装的是与原生安装相同的二进制，同样后台自动更新；手动升级用 `npm install -g @anthropic-ai/claude-code@latest`

注意：npm 安装切勿使用 sudo npm install -g，会导致权限和安全问题。若 npm 全局目录不可写导致无法自动更新，Claude Code 会在启动时给出一次性提示，claude doctor 也会列出可行的修复方案。

Linux 包管理器（apt / dnf / apk）

官方提供签名的 apt、dnf、apk 仓库，分 stable（通常延迟一周）和 latest 两个频道。以 Debian/Ubuntu apt 为例：

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 签名指纹（安装前核对）：31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE

Windows 安装选择

选项	依赖	沙箱支持	适用场景
原生 Windows	Git for Windows（可选）	不支持	Windows 原生项目
WSL 2	需启用 WSL 2	支持	Linux 工具链或需要沙箱
WSL 1	需启用 WSL 1	不支持	WSL 2 不可用时

安装 Git for Windows 后，Claude Code 可使用 Bash 工具；否则默认使用 PowerShell 工具。若找不到 Git Bash，可在 settings.json 中通过 env.CLAUDE_CODE_GIT_BASH_PATH 手动指定路径。

版本与更新管理

发布频道

通过 /config 菜单或 settings.json 中的 autoUpdatesChannel 字段控制：

latest（默认）：新版本发布即推送
stable：延迟约一周，跳过有重大回归问题的版本

版本下限锁定

minimumVersion 字段可防止切换到 stable 频道时意外降级：

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

企业部署可通过**托管设置（managed settings）**强制统一，并以 requiredMinimumVersion / requiredMaximumVersion 限制可启动的版本范围。

禁用与手动更新

停止后台检查：在 settings.json 的 env 中设置 DISABLE_AUTOUPDATER 为 1
屏蔽所有更新路径（含手动）：改用 DISABLE_UPDATES
立即手动更新：运行 claude update

Homebrew 和 WinGet 用户可将 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设为 1，由 Claude Code 在有新版本时自动调用对应的升级命令。

安装验证与二进制完整性

claude --version   # 验证安装成功
claude doctor      # 诊断配置与最近一次更新状态

官方对每个发布都提供含 SHA256 校验值的 manifest.json，可验证二进制完整性；该 manifest 由 Anthropic GPG 密钥签名，验证 manifest 的签名即可间接验证其列出的所有二进制。需要留意：附带的 detached 签名（manifest.json.sig）自 2.1.89 版起才提供，更早的发布只在 manifest.json 中给出校验值、不含 detached 签名。完整验证流程：

导入公钥并核对指纹：31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE
下载对应版本的 manifest.json 及 manifest.json.sig
执行 gpg --verify manifest.json.sig manifest.json，确认输出含 Good signature
用 sha256sum（Linux）或 shasum -a 256（macOS）对比本地二进制的哈希值

此外，macOS 二进制由「Anthropic PBC」签名并经 Apple 公证（可用 codesign --verify 检查）；Windows 二进制由「Anthropic, PBC」签名（可用 Get-AuthenticodeSignature 检查）。

卸载

安装方式	卸载命令
原生（macOS/Linux）	`rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude`
Homebrew	`brew uninstall --cask claude-code`
WinGet	`winget uninstall Anthropic.ClaudeCode`
npm	`npm uninstall -g @anthropic-ai/claude-code`

卸载后如 claude 仍可运行，说明存在第二份安装或旧安装遗留的 shell 别名，参考官方故障排查文档处理。

完全清除用户配置与会话历史（操作不可恢复，且若 VS Code 扩展等仍在运行会自动重建目录）：

rm -rf ~/.claude && rm ~/.claude.json
# 清除项目级配置（在项目目录下运行）
rm -rf .claude && rm -f .mcp.json

查看官方原文:Advanced setup ← 返回 Blog