Claude Code 安装后如果无法启动，通常先检查系统要求、终端类型和安装方式是否匹配。原生安装可自动更新，Homebrew、WinGet 和 Linux 包管理器默认需要手动升级；安装后用 claude --version 和 claude doctor 验证。

Claude Code 安装配置：系统要求、更新与卸载

系统要求

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

操作系统：
- macOS 13.0+
- Windows 10 1809+ 或 Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
硬件：4 GB+ 内存，x64 或 ARM64 处理器
网络：需要互联网连接。见 network configuration
Shell：Bash、Zsh、PowerShell 或 CMD
地区：Anthropic supported countries

额外依赖

ripgrep：通常会随 Claude Code 一起提供。如果搜索失败，见 search troubleshooting

安装 Claude Code

如果你更喜欢图形界面，可以使用 Desktop app 在不打开终端的情况下使用 Claude Code。macOS 版和 Windows 版都可下载。

新手如果不熟悉终端，可以先看 terminal guide。

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

如果看到 The token '&&' is not a valid statement separator，说明你在 PowerShell，不是在 CMD。
如果看到 'irm' is not recognized as an internal or external command，说明你在 CMD，不是在 PowerShell。
PowerShell 的提示符通常是 PS C:\，CMD 则是 C:\，前面没有 PS。

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

原生安装会在后台自动更新，始终保持最新版本。

也可以通过 Homebrew 安装：

brew install --cask claude-code

Homebrew 提供两个 cask：

claude-code 跟随稳定发布频道，通常比最新版本滞后约一周，并跳过有重大回归的版本
claude-code@latest 跟随最新频道，新版本发布后尽快获取

Homebrew 安装不会自动更新。要获取最新功能和安全修复，请运行 brew upgrade claude-code 或 brew upgrade claude-code@latest，取决于你安装的是哪个 cask。

Windows 也可以用 WinGet：

winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新。请定期运行 winget upgrade Anthropic.ClaudeCode 获取最新功能和安全修复。

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

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

claude

如果安装过程中遇到问题，见 Troubleshoot installation and login。

Windows 上怎么安装 Claude Code

Windows 上可以原生运行 Claude Code，也可以在 WSL 中运行。按项目所在位置和你需要的功能来选：

选项	需要	Sandboxing	适用场景
Native 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 tool。

从 PowerShell 还是 CMD 安装，只影响你要运行哪条安装命令。PowerShell 的提示符一般显示为 PS C:\Users\YourName>，CMD 则是 C:\Users\YourName>。如果你对终端不熟，[terminal guide](/ai/ai-tools/claude-code/terminal-guide#windows) 会逐步说明每一步。

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

未安装 Git for Windows：Claude Code 通过 PowerShell tool 执行 shell 命令
已安装 Git for Windows：Claude Code 使用 Git Bash 作为 Bash tool。如果 Claude Code 找不到 Git Bash，可以在 settings.json file 中指定路径：

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

安装了 Git for Windows 之后，PowerShell tool 会逐步开放为 Bash 之外的附加选项。设置 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 可启用，设置为 0 可停用。详见 PowerShell tool 的配置和限制。

方式 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 或其他错误，见 Troubleshoot installation and login。

如果你想更完整地检查安装和配置，运行 claude doctor：

claude doctor

认证

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

安装完成后，运行 claude，按浏览器提示登录。所有账户类型和团队设置选项见 Authentication。

更新 Claude Code

原生安装会在后台自动更新。你可以通过 configure release channel 控制是立即获取更新，还是延迟到稳定发布节奏；也可以通过 disable auto-updates 完全关闭自动更新。Homebrew、WinGet 和 Linux package manager 安装默认需要手动更新。

自动更新

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

Homebrew、WinGet、apt、dnf 和 apk 安装默认不会自动更新；如果你使用 Homebrew 或 WinGet，可以按下文启用自动升级。

如果要让 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 file：

{
  "autoUpdatesChannel": "stable"
}

企业部署时，可以通过 managed settings 统一强制整个组织使用同一个发布频道。

Homebrew 安装不是靠这个设置决定频道，而是按 cask 名称决定：claude-code 跟随 stable，claude-code@latest 跟随 latest。

怎么固定最低版本

minimumVersion 设置会建立一个下限。后台自动更新和 claude update 都不会安装低于这个值的版本，所以如果你已经在更高的 "latest" 构建上，切到 "stable" 也不会自动降级。

如果你在 /config 中把频道从 "latest" 切到 "stable"，Claude Code 会提示你保留当前版本，还是允许降级。选择保留会把 minimumVersion 设成当前版本；切回 "latest" 时会清掉这个限制。

你也可以直接在 settings.json file 里显式固定下限：

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

在 managed settings 中，这个设置可以强制整个组织的最低版本，用户和项目设置都不能覆盖。

怎么关闭自动更新

在 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）。你在安装时选择的频道，会成为后续自动更新的默认频道。更多内容见 configure release channel。

安装最新版本（默认）：

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 release signing key 签名。信任该密钥前，请先按各选项卡说明验证。

Debian 和 Ubuntu

如果想用滚动频道，把 deb 行里的两个 stable 都改掉：URL 路径和 suite 名称都要改。

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。

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

dnf 会在首次安装时下载密钥并提示你确认指纹。确认它与 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE 一致后再接受。

后续升级运行 sudo dnf upgrade claude-code。

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

用 sha256sum /etc/apk/keys/claude-code.rsa.pub 验证下载的密钥，结果应为 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6。

后续升级运行 apk update && apk upgrade claude-code。

用 npm 安装

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

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

npm 包会安装同一个原生二进制文件，而不是通过 Node 运行。它通过按平台拆分的可选依赖，例如 @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。你的包管理器必须允许可选依赖。如果安装后缺少二进制文件，见 troubleshooting。

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

不要使用 sudo npm install -g，这会导致权限问题和安全风险。如果你遇到权限错误，见 troubleshooting permission errors。

二进制完整性和代码签名

每个版本都会发布一个 manifest.json，其中包含所有平台二进制文件的 SHA256 校验和。该清单由 Anthropic 的 GPG 密钥签名，因此验证清单签名就等于间接验证了其中列出的每个二进制文件。

验证清单签名

步骤 1-3 需要带有 gpg 和 curl 的 POSIX shell。在 Windows 上，请在 Git Bash 或 WSL 中运行。第 4 步提供了 PowerShell 方案。

发布签名密钥位于固定 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

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

用分离签名验证清单。
```
gpg --verify manifest.json.sig manifest.json
```
有效结果会显示 Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>"。

gpg 还会对新导入的密钥显示 WARNING: This key is not certified with a trusted signature!，这是正常现象。Good signature 这一行才代表加密校验通过；第 1 步中的指纹比对用于确认密钥本身可信。
将你下载的二进制文件的 SHA256 校验和与 manifest.json 中 platforms.<platform>.checksum 的值对比。
```
sha256sum claude
```
```
shasum -a 256 claude
```
```
(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-releases bucket 下载，或使用原生安装器，请用上面的清单签名验证完整性。如果你通过 apt, dnf, or apk 安装，包管理器会自动使用仓库签名密钥验证签名

卸载 Claude Code

按你的安装方式移除 Claude Code。
如果卸载后 claude 仍然可以运行，通常是因为系统里还有另一份安装，或者旧安装留下了 shell alias。见 Check for conflicting installations 排查并删除冲突项。

原生安装

删除 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

删除配置文件

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

VS Code 扩展、JetBrains 插件和 Desktop app 也会写入 ~/.claude/。如果它们任何一个仍然安装，目录会在下次运行时重新创建。要彻底移除 Claude Code，请先卸载 VS Code extension、JetBrains 插件和 Desktop app，再删除这些文件。

删除 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

常见问题

Claude Code 安装后怎么确认是否成功？

运行 claude --version。如果输出版本号，说明基本安装成功；如果报 command not found 或其他错误，再执行 claude doctor 进一步排查。

Windows 上应该用 PowerShell、CMD 还是 WSL 安装？

原生 Windows 可以用 PowerShell 或 CMD；如果你的项目和 Linux 工具链更匹配，或者需要沙箱能力，优先考虑 WSL 2。安装命令不同，关键是要在对应终端里执行。

为什么安装后 `claude` 还是能运行，卸载却没生效？

通常是系统里还有第二份 Claude Code，或者旧版本留下了 shell alias。先按当前安装方式卸载，再检查是否存在冲突安装。

Claude Code 安装配置：系统要求、更新与卸载 #

系统要求 #

额外依赖 #

安装 Claude Code #

Windows 上怎么安装 Claude Code #

方式 1：原生 Windows #

方式 2：WSL #

Alpine Linux 和基于 musl 的发行版 #

验证安装 #

认证 #

更新 Claude Code #

自动更新 #

怎么配置发布频道 #

怎么固定最低版本 #

怎么关闭自动更新 #

手动更新 #

高级安装选项 #

安装指定版本 #

用 Linux 包管理器安装 #

Debian 和 Ubuntu #

Fedora 和 RHEL #

Alpine Linux #

用 npm 安装 #

二进制完整性和代码签名 #

验证清单签名 #

平台代码签名 #

卸载 Claude Code #

原生安装 #

Homebrew 安装 #

WinGet 安装 #

apt / dnf / apk #

npm #

删除配置文件 #

常见问题 #

Claude Code 安装后怎么确认是否成功？ #

Windows 上应该用 PowerShell、CMD 还是 WSL 安装？ #

为什么安装后 claude 还是能运行，卸载却没生效？ #