如何在 macOS、Windows 和 Linux 上安装 Claude Code

要安装 Claude Code，也就是 Anthropic 的终端编程代理，请在满足文档所列操作系统最低要求，并具备 4 GB 内存、x64 或 ARM64 处理器、Bash、Zsh、PowerShell 或 CMD、互联网连接，且位于 Anthropic 支持的国家/地区的机器上运行原生安装程序。在 macOS、Linux 和 WSL 上，该命令是 curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell 使用 install.ps1，命令提示符使用 install.cmd。

Anthropic 把原生安装程序记为推荐方式。在 macOS、Linux 和 Windows Subsystem for Linux（WSL）上，把 https://claude.ai/install.sh 通过管道交给 bash。Windows PowerShell 使用 install.ps1，命令提示符使用 install.cmd。stable 和固定版本按 shell 使用不同参数：Unix 用 bash -s，PowerShell 用 scriptblock，CMD 用 install.cmd <channel-or-version>。二进制文件落到磁盘后，claude --version 应打印版本号并紧跟 (Claude Code)，然后 claude 会开始浏览器登录。如果设置了 ANTHROPIC_API_KEY，Claude Code 不会打开浏览器，而是要求对该密钥批准一次。

原生安装会在后台下载更新。Homebrew、WinGet、apt、dnf 和 apk 通过各自的包管理器升级。npm 把同一份原生二进制文件作为全局包，经 optional dependency 分发，并且会自动更新，除非 npm 全局目录不可写。升级和卸载都要用与所选方式对应的命令。

安装之前必须满足的条件

安装成功之后，你会得到一个能用的 claude 二进制文件、一个 Claude Code 接受的账户、你选定的发布通道，以及与安装程序对应的卸载路径。Claude Code 是 Anthropic 的终端编程代理：一个在项目目录中打开的命令行程序，读取它需要的文件，并在 shell 里帮你编写和修改代码。Anthropic 的 Desktop 应用是使用 Claude Code 的图形界面选择。本文涵盖终端安装程序、更新和卸载。

Anthropic 的 setup 页面列出的操作系统最低要求是：macOS 13.0+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+。硬件为 4 GB 或更多内存，以及 x64 或 ARM64 处理器。需要互联网连接。文档中的 shell 是 Bash、Zsh、PowerShell 和 CMD。setup 页面的地区要求是 Anthropic 支持的国家/地区。

Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户，或者 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。Anthropic 的文档写明，免费的 claude.ai 方案不包含 Claude Code 访问权限。提供方凭据使用这些云产品自己的 setup 页面。

claude 能运行之后再登录。最初的编程提示在 Anthropic 的 quickstart 上。安装期间出现 command not found、PATH 问题、EACCES、TLS 错误或 curl 403 时，使用 Anthropic 的 Troubleshoot installation and login 页面。登录循环、OAuth 错误，以及登录时的 403 Forbidden，属于同一页面的 login and authentication 一节。

Claude Code 安装配置

Anthropic 支持的国家/地区

安装与登录故障排除

推荐方式：原生安装程序

Anthropic 把原生安装程序记为推荐方式。在 macOS、Linux 和 Windows Subsystem for Linux（WSL）上，把安装脚本通过管道交给 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 里。如果看到 'irm' is not recognized as an internal or external command，你在 CMD 里。PowerShell 提示符以 PS C:\ 开头；CMD 提示符显示不带 PS 的 C:\。

在 macOS 和 Linux 上，启动器是 ~/.local/bin/claude，它是指向 ~/.local/share/claude/versions/ 的符号链接。安装程序结束后，在项目里打开终端并运行 claude。

原生安装程序接受 latest、stable，或 2.1.89 这样的版本（Anthropic 的固定版本示例）。安装时选择的通道会成为自动更新的默认值。每种 shell 有自己的语法：bash 使用 bash -s，PowerShell 使用 scriptblock，CMD 把参数传给 install.cmd。

• macOS、Linux、WSL（latest）：curl -fsSL https://claude.ai/install.sh | bash
• Windows PowerShell（latest）：irm https://claude.ai/install.ps1 | iex
• Windows CMD（latest）：curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
• stable，macOS/Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash -s stable
• stable，PowerShell：& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
• stable，CMD：curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
• 固定版本示例 2.1.89，macOS/Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
• 固定版本示例 2.1.89，PowerShell：& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
• 固定版本示例 2.1.89，CMD：curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

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

Homebrew、WinGet、Linux 软件源和 npm

Homebrew 用 brew install --cask claude-code 安装，这个 cask 跟踪 stable 通道（通常大约滞后一周，并跳过有重大回归的版本）。brew install --cask claude-code@latest 跟踪 latest。升级时使用对应的 brew upgrade cask。Homebrew 会把旧版本留在磁盘上；brew cleanup 可以收回空间。

WinGet 用 winget install Anthropic.ClaudeCode 安装，用 winget upgrade Anthropic.ClaudeCode 升级。

Claude Code 发布经过签名的 apt、dnf 和 apk 软件源，每个都有 stable 和 latest 通道。stable 通常大约是一周前的版本，并跳过有重大回归的版本；latest 则在每个版本发布后立即提供。下面的命令配置的是 stable，setup 页面说它适合大多数用户。通过包管理器安装时，更新走你平时的系统升级流程。

在 Debian 和 Ubuntu 上，如果缺少 curl 和 gnupg，先安装它们（sudo apt install curl gnupg）。代码块中的命令会创建 /etc/apt/keyrings，下载签名密钥，打印出来供核对指纹，写入 /etc/apt/sources.list.d/claude-code.list，然后安装软件包。指纹应为 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。如果密钥下载失败，之后的 apt update 会以 NO_PUBKEY BAA929FF1A7ECACE 失败。latest 需要同时改 URL 路径和 suite 名称：deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main。之后升级用 sudo apt update && sudo apt upgrade claude-code。

在 Fedora 和 RHEL 上，代码块中的命令会写入 /etc/yum.repos.d/claude-code.repo 并安装软件包。latest 则把 baseurl 设为 https://downloads.claude.ai/claude-code/rpm/latest。dnf 会在首次安装时下载密钥并提示确认指纹；接受前核对 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE。之后升级用 sudo dnf upgrade 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

在 Alpine 上，把 https://downloads.claude.ai/keys/claude-code.rsa.pub 下载到 /etc/apk/keys/claude-code.rsa.pub，把 https://downloads.claude.ai/claude-code/apk/stable 加入 /etc/apk/repositories，然后执行 apk add claude-code。要改用 latest，运行 sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories，并加入 https://downloads.claude.ai/claude-code/apk/latest。sha256sum /etc/apk/keys/claude-code.rsa.pub 应报告 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6。之后升级用 apk update && apk upgrade claude-code。

npm 安装的是同一份原生二进制文件：npm install -g @anthropic-ai/claude-code。npm 通过按平台划分的 optional dependency 拉取该二进制文件，例如 @anthropic-ai/claude-code-darwin-arm64，因此包管理器必须允许 optional dependency。从 v2.1.198 起，该包需要 Node.js 22 或更高版本。在更旧的 Node 上，npm 会打印 EBADENGINE，安装仍可能完成，因为 CLI 下载的是原生二进制文件，运行时并不在 Node 上执行。npm 包会自动更新，除非 npm 全局目录不可写；那种情况下，启动时会显示一次通知，claude doctor 会列出修复办法。升级用 npm install -g @anthropic-ai/claude-code@latest。Anthropic 警告不要使用 npm update -g，它可能停留在最初的 semver 范围内；也警告不要使用 sudo npm install -g，那可能带来权限问题和安全风险。npm 支持的平台是 darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64 和 win32-arm64。

• brew install --cask claude-code
• brew install --cask claude-code@latest
• winget install Anthropic.ClaudeCode
• npm install -g @anthropic-ai/claude-code
• latest 的 apt suite 行：deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main
• latest 的 dnf baseurl：https://downloads.claude.ai/claude-code/rpm/latest
• latest 的 apk 软件源：https://downloads.claude.ai/claude-code/apk/latest

按安装方式列出的文档更新路径

方式	后台自动更新	升级命令
原生	是。启动时以及运行期间	claude update
Homebrew	默认手动；CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1	brew upgrade claude-code 或 brew upgrade claude-code@latest
WinGet	默认手动；CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1	winget upgrade Anthropic.ClaudeCode
apt	手动（需要提升权限）	sudo apt update && sudo apt upgrade claude-code
dnf	手动（需要提升权限）	sudo dnf upgrade claude-code
apk	手动（需要提升权限）	apk update && apk upgrade claude-code
npm	是，除非 npm 全局目录不可写	npm install -g @anthropic-ai/claude-code@latest

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
gpg --show-keys /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

Windows 原生与 WSL，以及 Alpine 的额外要求

原生 Windows 安装从 PowerShell 或 CMD 运行，不需要管理员权限。安装时 Git for Windows 是可选项。没有它时，Claude Code 通过 PowerShell 工具运行 shell 命令。有 Git for Windows 时，Claude Code 为 Bash 工具使用 Git Bash。WSL 环境不需要 Git for Windows。如果 Claude Code 找不到 Git Bash，在用户设置文件 ~/.claude/settings.json 里把 CLAUDE_CODE_GIT_BASH_PATH 设为 C:\Program Files\Git\bin\bash.exe。这项覆盖只用于已经安装 Git Bash 但没有被找到的 Windows。

Anthropic 的 Windows 表格把沙箱记为：原生 Windows 不支持，WSL 2 支持，WSL 1 不支持。走 WSL 时，要在 WSL 终端里安装并启动 claude。在 WSL 上，即使 claude doctor 把 Search 显示为 OK，跨越 /mnt/c 的搜索仍可能返回更少的匹配。文档中的缓解办法是：缩小搜索范围，把项目放在 /home/ 下，或者改用原生 Windows。

Alpine 和其他 musl/uClibc 系统在安装命令上需要 bash 和 curl，在运行时需要 libgcc、libstdc++ 和 ripgrep。Alpine 默认不带 bash 和 curl，所以在这些包就位之前，文档中的 curl 命令会以 not found 失败。文档中的 Alpine 示例是 apk add bash curl libgcc libstdc++ ripgrep。在 Alpine 上，ripgrep 位于 community 软件源。如果 apk 找不到 ripgrep，把该版本的 community 软件源加入 /etc/apk/repositories，运行 apk update，再重试 apk add。文档中的 https://dl-cdn.alpinelinux.org/alpine/v3.22/community URL 是 Alpine 3.22 的示例。包安装完成之后，在 ~/.claude/settings.json 的 env 键里把 USE_BUILTIN_RIPGREP 设为 0。这个标志与 Windows 的 Git Bash 路径是分开的开关。

文档中的 Windows 安装选项

| 选项 | 需要 | 沙箱 | 适用场景 |

| — | — | — | — |

| 原生 Windows | 无；Git for Windows 可选 | 不支持 | Windows 原生项目和工具 |

| WSL 2 | 已启用 WSL 2 | 支持 | Linux 工具链或沙箱中的命令执行 |

| WSL 1 | 已启用 WSL 1 | 不支持 | 无法使用 WSL 2 时 |

~/.claude/settings.json

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

先确认二进制文件，再登录

运行 claude --version。安装成功时会打印版本号，并紧跟 (Claude Code)。Anthropic 的示例字符串是 2.1.211 (Claude Code)。

claude doctor 会打印只读的安装和设置诊断，而不启动会话，包括安装健康状况、设置文件校验错误，以及带建议修复的警告。安装之后，以及更改自动更新标志之后，都运行它。它的报告与版本那一行是分开的诊断。

运行 claude 并按照浏览器提示登录。如果设置了环境变量 ANTHROPIC_API_KEY，Claude Code 会提示你批准该密钥一次。在正在运行的会话里，输入 /login 可以切换账户。如果组织在运行自托管的 Claude apps gateway，管理员会预先配置 gateway URL，/login 会打开 Cloud gateway 画面，以便使用企业 SSO。

如果 Search 工具、@file 提及、自定义代理或自定义技能找不到文件，安装你平台的 ripgrep 包，并在 ~/.claude/settings.json 的 env 键里把 USE_BUILTIN_RIPGREP 设为 0。在 claude doctor 中确认 Search 显示的是系统路径，而不是 OK (bundled)。

claude --version

示例输出：2.1.211 (Claude Code)

Claude Code 快速入门

搜索与发现问题

自动更新、通道、版本下限与停止更新的标志

原生安装会在启动时以及运行期间定期检查更新。更新在后台下载，并在你下次启动 Claude Code 时生效。claude update 会立即应用。原生更新成功时会报告 Successfully updated from <old version> to version <new version>。已经是当前版本的原生安装会报告 Claude Code is up to date (<version>)。对于已经是当前版本的 Homebrew、WinGet 或 apk 安装，claude update 会报告 Claude is up to date!。

autoUpdatesChannel 默认为 latest，也可以是 stable（通常大约是一周前的版本，并跳过有重大回归的版本）。通过 /config → Auto-update channel 设置，或写在用户设置文件 ~/.claude/settings.json 里。Homebrew 不靠这项设置，而是按 cask 名称选择通道：claude-code 跟踪 stable，claude-code@latest 跟踪 latest。

minimumVersion 是一条下限：后台自动更新和 claude update 会拒绝任何低于它的版本。设置了这条下限之后，改到 stable 仍会留下较新的 latest 构建。通过 /config 从 latest 切换到 stable 时，会询问你是留在当前版本，还是允许降级。选择留下会把 minimumVersion 设为当前版本。切回 latest 会清除这条下限。要自己固定下限，在 ~/.claude/settings.json 里加入 minimumVersion。Anthropic 的 setup 页面用 2.1.100 作为示例值，下限由你自己设定。托管的 requiredMinimumVersion 和 requiredMaximumVersion 会让 Claude Code 拒绝在版本范围之外启动，更新也会遵守 requiredMaximumVersion 的上限。

要停止后台检查，在 ~/.claude/settings.json 的 env 键里把 DISABLE_AUTOUPDATER 设为 1。claude update 和 claude install 仍然可用。在原生或 npm 安装上，claude doctor 应把 Auto-updates 显示为 disabled (set by env: DISABLE_AUTOUPDATER)。DISABLE_UPDATES 会阻断每一条更新路径，包括手动更新。

Homebrew、WinGet、apt、dnf 和 apk 安装默认不自动更新。设置 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 后，Claude Code 会在后台运行 Homebrew 或 WinGet 升级，成功时显示重启提示。在 WinGet 上，Claude Code 正在运行时升级可能失败，因为 Windows 会锁定可执行文件；这时 Claude Code 会显示手动命令。apt、dnf 和 apk 仍然需要手动升级，因为这些命令需要提升权限。Anthropic 记录了一个已知问题：Claude Code 可能在该版本进入 Homebrew、WinGet、apt、dnf 或 apk 之前就通知你有更新。如果升级失败，先等一等，稍后再试。

从 v2.1.207 起，自动更新和 claude update 会保留 ~/.local/bin/claude 上的自定义启动器。在该版本之前，更新程序每次更新都会用自己的符号链接替换自定义启动器。要让原生安装程序重新管理启动器，删除 ~/.local/bin/claude 并运行 claude update。

从 2.1.89 起，每个版本都会发布一份经过 GPG 签名的 manifest.json，其中是 SHA256 校验和。从 https://downloads.claude.ai/keys/claude-code.asc 导入密钥，并确认指纹 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE。macOS 二进制文件由 Anthropic PBC 签名，并由 Apple 公证。Windows 二进制文件由 Anthropic, PBC 签名。Linux 二进制文件没有单独的代码签名；使用 manifest，或 apt、dnf、apk 软件源密钥。

~/.claude/settings.json

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

用当初的安装方式卸载，再决定是否删除配置

用当初安装 Claude Code 的同一种方式移除它。下面的列表与每种安装程序对应。如果之后 claude 仍能运行，Anthropic 的说法是，很可能还有第二次安装，或旧安装程序留下的 shell 别名。使用 Troubleshoot installation 页面上的 Check for conflicting installations。

用户设置在 ~/.claude 和 ~/.claude.json。项目设置在仓库里的 .claude 和 .mcp.json。MCP（Model Context Protocol）服务器是 Claude Code 从这些配置文件加载的额外工具。删除这些路径会移除设置、已允许的工具、MCP 服务器配置和会话历史。如果 VS Code 扩展、JetBrains 插件和 Desktop 应用仍安装着，它们会重新创建 ~/.claude。

changelog 页面由 GitHub 上的 CHANGELOG.md 生成。用 claude --version 查看你安装的版本。

• 原生 macOS、Linux、WSL：rm -f ~/.local/bin/claude 以及 rm -rf ~/.local/share/claude
• 原生 Windows PowerShell：Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force，然后 Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
• brew uninstall --cask claude-code
• brew uninstall --cask claude-code@latest
• winget uninstall Anthropic.ClaudeCode
• 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 uninstall -g @anthropic-ai/claude-code

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

选择与操作系统匹配的安装程序，运行 claude --version 和 claude doctor，用 claude 登录，之后的升级和卸载也沿用同一种方式。

相关

• 入门

Guide

如何使用 Claude Code Plan Mode：在改任何代码之前先审阅计划

用一次截止日期改动走完步骤：Shift+Tab、/plan，或 claude --permission-mode plan。Claude 会读取文件并提出计划，其间不修改源码。带有 bypass permissions 的交互式终端除外，编辑会一直被拦住，直到你批准。

Build 阅读

X

ClaudeDevs称，Code Review已向Team与Enterprise全面提供

ClaudeDevs称，Code Review现已面向Claude的Team与Enterprise计划全面提供。 该账号表示，审查变得更快，也能抓住真正要紧的bug中的更多一部分，管理员还可以为每个仓库在Quick、Standard、Deep中选择。 帖子没有给出样本、基线或基于测量的对比。

2026年10月16日 阅读

来源

• Advanced setup · 核对 2026-09-24
• Quickstart · 核对 2026-09-24
• Troubleshooting · 核对 2026-09-24
• Claude Code changelog · 核对 2026-09-24

延伸阅读

• Guide 如何使用 Claude Code Plan Mode：在改任何代码之前先审阅计划 用一次截止日期改动走完步骤：Shift+Tab、/plan，或 claude --permission-mode plan。Claude 会读取文件并提出计划，其间不修改源码。带有 bypass permissions 的交互式终端除外，编辑会一直被拦住，直到你批准。
• Guide 如何为反复做的工作编写 Claude Code skills 每个 skill 都是带 SKILL.md 的目录。本教程会做一个只报告当前 git diff 的评审 skill。