系统要求
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,请使用以下方法之一:- 原生安装(推荐)
- Homebrew
- WinGet
macOS、Linux、WSL:Windows PowerShell:Windows 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)。如果安装命令失败并显示 syntax error near unexpected token '<'、403 或其他 curl 错误,请参阅 Troubleshoot installation 以匹配错误并获得修复方案和替代安装方法。建议在原生 Windows 上安装 Git for Windows,以便 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows,Claude Code 将使用 PowerShell 作为 shell 工具。WSL 设置不需要 Git for Windows。原生安装会在后台自动更新,以保持您使用最新版本。
在 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 为 Bash 工具使用 Git Bash。如果 Claude Code 找不到 Git Bash,请在您的 settings.json 文件中设置路径:
CLAUDE_CODE_USE_POWERSHELL_TOOL=1 启用。将其设置为 0 以关闭该工具。有关设置和限制,请参阅 PowerShell 工具。
选项 2:WSL
打开您的 WSL 发行版并从上面的安装说明中运行 Linux 安装程序。您在 WSL 终端内安装和启动 claude,而不是从 PowerShell 或 CMD。
Alpine Linux 和基于 musl 的发行版
在 Alpine 和其他 musl/uClibc 基础发行版上安装 Claude Code 需要bash 和 curl 用于安装命令,以及 libgcc、libstdc++ 和 ripgrep 用于运行时。Alpine 默认不包含 bash 或 curl,因此在您安装它们之前,文档中的安装命令会失败并显示 not found 错误。使用您的发行版的包管理器安装这些包,然后设置 USE_BUILTIN_RIPGREP=0。
此示例在 Alpine 上安装所需的包:
ripgrep 位于社区存储库中。如果 apk 报告该包缺失,请将社区存储库添加到 /etc/apk/repositories,使用您的 Alpine 版本:
apk update 以刷新包索引,然后重试 apk add 命令。
然后在您的 settings.json 文件中将 USE_BUILTIN_RIPGREP 设置为 0:
验证您的安装
安装后,确认 Claude Code 正常工作:2.1.211 (Claude Code)。
如果此命令失败并显示 command not found 或其他错误,请参阅排查安装和登录问题。
要更详细地检查您的安装和配置,请运行 claude doctor:
claude doctor 打印只读的安装和设置诊断信息,无需启动会话,包括安装健康状况、设置文件验证错误以及任何带有建议修复的警告。
身份验证
Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户。免费的 claude.ai 计划不包括 Claude Code 访问权限。您也可以通过第三方 API 提供商(如 Amazon Bedrock、Google Cloud’s Agent Platform 或 Microsoft Foundry)使用 Claude Code。 安装后,通过运行claude 并按照浏览器提示登录。如果设置了 ANTHROPIC_API_KEY 环境变量,Claude Code 会提示您一次以批准该密钥,而不是打开浏览器。有关所有账户类型和团队设置选项,请参阅身份验证。
更新 Claude Code
原生安装会在后台自动更新。您可以配置发布渠道来控制您是立即接收更新还是按延迟的稳定计划接收更新,或者完全禁用自动更新。Homebrew、WinGet 和Linux 包管理器安装默认需要手动更新。自动更新
Claude Code 在启动时和运行时定期检查更新。更新在后台下载和安装,然后在您下次启动 Claude Code 时生效。 运行claude doctor 以查看最近一次更新尝试的结果。
在 macOS 和 Linux 上,原生安装程序将启动器作为 ~/.local/bin/claude 处的符号链接管理到 ~/.local/share/claude/versions/。如果您将该启动器替换为您自己的脚本或符号链接,自动更新和 claude update 会将其保留在原位:新版本仍然安装在 versions/ 目录下,您的启动器决定运行哪个版本。在 v2.1.207 之前,自动更新程序在每次更新时都会将该路径处的自定义启动器替换为其自己的符号链接。
使用自定义启动器,Claude Code 也会在磁盘上保留每个已安装的版本,因为它无法判断启动器需要哪个版本。claude doctor 报告原生安装程序未创建的启动器。
要让 Claude Code 再次管理启动器,请删除 ~/.local/bin/claude 并运行 claude update。
如果 npm 全局安装因为 npm 全局目录不可写而无法自动更新,Claude Code 会在启动时显示一次性通知,claude doctor 会列出可用的修复。有关详细信息,请参阅安装期间的权限错误。
Homebrew、WinGet、apt、dnf 和 apk 安装默认不会自动更新;请参阅下文以选择加入 Homebrew 和 WinGet。要手动升级 Homebrew,请运行
brew upgrade claude-code 或 brew upgrade claude-code@latest,具体取决于您安装的 cask。对于 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 → 自动更新渠道配置此项,或将其添加到您的 settings.json 文件:
claude-code 跟踪稳定版,claude-code@latest 跟踪最新版。
固定最低版本
minimumVersion 设置建立了一个下限。后台自动更新和 claude update 拒绝安装低于此值的任何版本,因此如果您已经在较新的 "latest" 构建上,切换到 "stable" 渠道不会降级您。
通过 /config 从 "latest" 切换到 "stable" 会提示您选择保留当前版本或允许降级。选择保留会将 minimumVersion 设置为该版本。切换回 "latest" 会清除它。
将其添加到您的 settings.json 文件以显式固定下限:
minimumVersion 固定仅约束更新。要使 Claude Code 拒绝在版本范围外启动,请改为使用托管设置 requiredMinimumVersion 和 requiredMaximumVersion。更新也会遵守 requiredMaximumVersion 上限。请参阅 requiredMinimumVersion 和 requiredMaximumVersion。
禁用自动更新
在您的settings.json 文件的 env 键中将 DISABLE_AUTOUPDATER 设置为 "1":
claude doctor 并检查 Auto-updates 行是否显示 disabled (set by env: DISABLE_AUTOUPDATER) 而不是 enabled 来确认更改已生效。
DISABLE_AUTOUPDATER 仅停止后台检查;claude update 和 claude install 仍然有效。要阻止所有更新路径(包括手动更新),请改为设置 DISABLE_UPDATES。当您通过自己的渠道分发 Claude Code 并需要用户保持在您提供的版本上时,请使用此选项。
手动更新
要立即应用更新而不等待下一次后台检查,请运行:Successfully updated from <old version> to version <new version>。如果您已经在最新版本上,它报告 Claude Code is up to date (<version>)。由 Homebrew、WinGet 或 apk 管理的安装改为报告 Claude is up to date!。
高级安装选项
这些选项用于版本固定、Linux 包管理器、npm 和验证二进制完整性。安装特定版本
原生安装程序接受特定版本号或发布渠道(latest 或 stable)。您在安装时选择的渠道将成为自动更新的默认值。有关更多信息,请参阅配置发布渠道。
要安装最新版本(默认):
- macOS、Linux、WSL
- Windows PowerShell
- Windows CMD
- macOS、Linux、WSL
- Windows PowerShell
- Windows CMD
- macOS、Linux、WSL
- Windows PowerShell
- Windows CMD
claude --version:该命令打印您传递的确切版本,例如 2.1.89 (Claude Code)。
使用 Linux 包管理器安装
Claude Code 发布已签名的 apt、dnf 和 apk 存储库。每个存储库提供两个渠道:stable 提供通常约一周前的版本,跳过有重大回归的发布,latest 在每个发布发布时立即提供。以下命令配置 stable 渠道,适合大多数用户;每个选项卡还显示 latest 存储库 URL。包管理器安装不会通过 Claude Code 自动更新;更新通过您的正常系统升级工作流程进行。
所有存储库都使用 Claude Code 发布签名密钥进行签名。在信任密钥之前,请按照每个选项卡中的说明验证它。
- apt
- dnf
- apk
适用于 Debian 和 Ubuntu。以下安装命令使用 下载签名密钥:如果此下载失败,gpg 打印的指纹应该是 要改用 要稍后升级,请运行
curl 下载签名密钥,并使用 gpg 验证它,新安装的 Debian 和 Ubuntu 可能不包含这两个命令。如果任一命令报告 command not found,请先安装两者:apt update 稍后会失败并显示 NO_PUBKEY BAA929FF1A7ECACE。在继续之前,确认密钥已下载并属于 Anthropic:31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。如果 gpg 报告文件无法打开或不包含有效的 OpenPGP 数据,则下载失败或返回了错误的内容:确认您的网络可以到达 downloads.claude.ai,然后重新运行下载命令。在 stable 渠道上注册存储库并安装:latest 渠道,URL 路径和套件名称都会改变。使用此 deb 行:sudo apt update && sudo apt upgrade claude-code。使用 npm 安装
您也可以将 Claude Code 安装为全局 npm 包。从 v2.1.198 开始,npm 包需要 Node.js 22 或更高版本。在较旧的 Node.js 版本上,npm 在安装期间打印EBADENGINE 警告而不是失败;安装完成,claude 仍然运行,因为该包下载了在运行时不使用您的 Node.js 的原生二进制文件。
@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。显示导入的密钥的指纹。确认输出包含此指纹:
2
下载清单和签名
将
VERSION 设置为您要验证的发布。3
验证签名
针对清单验证分离的签名。有效的结果报告
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 步中的指纹比较确认密钥本身是真实的。4
根据清单检查二进制文件
将二进制文件的 SHA256 校验和与
manifest.json 中 platforms.<platform>.checksum 下列出的值进行比较。以下命令假设当前目录中有 claude 二进制文件。要验证已安装的原生二进制文件,请针对 ~/.local/share/claude/versions/VERSION 运行命令,将 VERSION 替换为您在第 2 步中设置的发布。- Linux
- macOS
- Windows PowerShell
清单签名可用于
2.1.89 及以后的发布。较早的发布在 manifest.json 中发布校验和,但没有分离的签名。平台代码签名
除了签名的清单外,各个二进制文件在支持的地方还带有平台原生代码签名。- 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 二进制文件和版本文件:- macOS、Linux、WSL
- Windows PowerShell
Homebrew 安装
删除您安装的 Homebrew cask。如果您安装了稳定版 cask:WinGet 安装
删除 WinGet 包:apt / dnf / apk
删除包和存储库配置:- apt
- dnf
- apk
npm
删除全局 npm 包:删除配置文件
VS Code 扩展、JetBrains 插件和桌面应用也会写入~/.claude/。如果其中任何一个仍然安装,下次运行时目录会被重新创建。要完全删除 Claude Code,请在删除这些文件之前卸载 VS Code 扩展、JetBrains 插件和桌面应用。
要删除 Claude Code 设置和缓存数据:
- macOS、Linux、WSL
- Windows PowerShell