Claude Code 安装教程

更新于 2026-10-21 · 阅读约 15 分钟

这篇 Claude Code 安装教程覆盖 Windows、macOS、Linux 和 WSL，重点讲国内网络下怎么装得上。先看怎么选：

• 国内网络：用 npm 国内镜像安装，不需要代理，最省事。
• 能正常访问 Anthropic 官网：用官方安装脚本，会自动更新。
• 习惯用包管理器：Mac 可以用 Homebrew，Windows 可以用 WinGet。

几种方式装的都是 Anthropic 发布的同一个 Claude Code 程序，区别只在下载渠道和更新方式。装好以后按安装后配置 cdnd 设置两个环境变量，不用登录 Claude 账号就能直接使用。

安装前准备：系统要求

Windows 上不需要管理员权限，也不必装 WSL。Git for Windows 是可选的：装了以后 Claude Code 用 Git Bash 执行命令，没装就用 PowerShell。

国内推荐：用 npm 安装 Claude Code

npm 方式装的是和官方安装脚本同一个程序：npm 会按你的系统下载对应的平台包，比如 @anthropic-ai/claude-code-darwin-arm64，装完后 claude 命令直接运行这个程序，不依赖 Node.js。国内镜像 npmmirror 同步了主包和全部 8 个平台包，所以换镜像就能正常安装。

安装 Node.js 22+

从 Node.js 官网 下载 LTS 版本安装，装好后打开一个新终端确认版本：

node -v

输出 v22 或更高就可以。版本低一些时 npm 只会提示 EBADENGINE 警告，安装仍然能完成，但建议还是升级。

用 npmmirror 国内镜像安装

只这一次用国内镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

或者把 npm 默认源永久改成国内镜像，以后安装、更新都不用再加参数：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

Windows 的 PowerShell 和 CMD 里命令完全一样。

不要用 sudo；遇到 EACCES 权限错误怎么办

官方明确不建议用 sudo npm install -g，会带来权限问题和安全风险。macOS 或 Linux 上报 EACCES: permission denied，说明 npm 的全局目录普通用户写不进去。按 npm 官方文档的做法，把全局目录换到自己的用户目录下（zsh 用户把 ~/.bashrc 换成 ~/.zshrc）：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

用 nvm 管理 Node.js 的话，全局目录本来就在用户目录下，不会遇到这个问题。

官方安装脚本（原生安装）

这是 Claude Code 官方推荐的安装方式，装好后会在后台自动更新。脚本要从 claude.ai 和 downloads.claude.ai 下载，国内网络经常连不上，连不上看国内网络装不上怎么办。

macOS / Linux / WSL

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

Windows PowerShell

提示符以 PS C:\ 开头的是 PowerShell：

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

Windows CMD

提示符是 C:\、前面没有 PS 的是 CMD：

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

安装过程中不显示进度，等命令结束后打开一个新终端窗口，再验证安装。

安装指定版本或 stable 渠道

在命令后面加版本号或 stable。stable 渠道的版本通常比最新版晚一周左右，会跳过有严重问题的版本：

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

PowerShell 的写法：

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

用 Homebrew、WinGet 或 apt 安装

macOS 用 Homebrew：

brew install --cask claude-code

claude-code 跟随 stable 渠道；想要最新版装 claude-code@latest。

Windows 用 WinGet：

winget install Anthropic.ClaudeCode

这两种方式默认都不会自动更新，需要手动升级，命令见更新与升级。Debian、Ubuntu、Fedora、RHEL 和 Alpine 还可以用官方的 apt、dnf、apk 软件源安装，具体命令见 Claude Code 官方安装文档。要注意的是，Homebrew、WinGet 和这些软件源最终都从 downloads.claude.ai 下载，官方脚本连不上的网络，换成它们通常也连不上。

分系统注意事项

Windows：PowerShell、CMD 和 WSL

• 别用错命令：PowerShell 和 CMD 的安装命令不一样。报 'irm' is not recognized 说明你在 CMD 里，报 The token '&&' is not a valid statement separator 说明你在 PowerShell 里，换成对应的命令即可。
• Git for Windows 可选：装了它，Claude Code 能用 Bash 执行命令；不装就用 PowerShell，也能正常工作。
• WSL：在 WSL 的终端里按 Linux 的方式安装和运行 claude，不要在 PowerShell 或 CMD 里运行。WSL 里不需要 Git for Windows。

macOS：zsh 和 PATH

macOS 默认的终端是 zsh。官方安装脚本把 claude 放在 ~/.local/bin，如果装完提示 zsh: command not found: claude，按找不到 claude 命令把这个目录加进 PATH。

Linux：Alpine 和小内存服务器

• Alpine 等 musl 系统：要先装依赖：apk add bash curl libgcc libstdc++ ripgrep，然后在 settings.json 的 env 里设置 "USE_BUILTIN_RIPGREP": "0"。
• 小内存服务器：内存不到 4 GB 时安装可能被系统杀掉（报 Killed），先加 swap 再重新安装。

验证安装是否成功

打开一个新终端，运行：

claude --version

能打印出版本号（类似 2.1.306 (Claude Code)）就说明装好了。想做更完整的检查，运行：

claude doctor

claude doctor 只读取、不修改任何东西，会列出安装状态、配置文件错误和修复建议。

安装后配置 cdnd，直接使用

第一次运行 claude 时，默认会要求登录 Claude 账号。在第一次运行之前，先在 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json）里写好 cdnd 的地址和 Key，就不会进入登录流程：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.cdnd.sh",
    "ANTHROPIC_AUTH_TOKEN": "sk-cdnd-你的Key"
  }
}

API Key 在 cdnd 控制台 注册后创建。然后进入你的项目目录，运行 claude 就可以开始用了。环境变量的写法、VS Code 插件的配置和报错排查，见 Claude Code 第三方 API 配置教程；装好以后怎么用，看 Claude Code 使用教程。

国内网络装不上怎么办

官方安装脚本出现下面这些情况，基本都是网络连不上 Anthropic 的服务器，或者当前地区不在支持范围内：

可以用下面的命令自查（Windows PowerShell 里把 curl 换成 curl.exe）。第一行显示 200 才说明能连上：

curl -sI https://downloads.claude.ai/claude-code-releases/latest

办法一：改用 npm 国内镜像

最省事，不需要代理，按上面用 npm 安装的命令操作即可，装的是同一个官方程序。

办法二：设置代理后再运行官方脚本

如果你有可用的 HTTP 代理，先设置 HTTPS_PROXY 和 HTTP_PROXY，再在同一个终端里运行安装脚本。把地址换成你自己的代理：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
curl -fsSL https://claude.ai/install.sh | bash

PowerShell 的写法：

$env:HTTP_PROXY = 'http://127.0.0.1:7890'
$env:HTTPS_PROXY = 'http://127.0.0.1:7890'
irm https://claude.ai/install.ps1 | iex

Claude Code 更新与升级

更新命令：claude update

官方脚本安装的版本会在后台自动更新，下次启动时生效。想立刻更新到最新版本，运行：

claude update

npm、Homebrew、WinGet 安装的怎么升级

npm 不要用 npm update -g 升级，它可能停在旧版本上，不会升到最新版。

查看最新版本、关闭自动更新

查看 Claude Code 当前的最新版本：

npm view @anthropic-ai/claude-code version --registry=https://registry.npmmirror.com

国内网络下自动更新可能因为连不上下载服务器而失败，界面底部会显示 Auto-update failed。这不影响使用，用上面的 npm 命令手动升级即可。不想要自动更新，在 settings.json 里关掉：

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

常见安装报错

command not found: claude

安装成功但找不到命令，说明安装目录不在 PATH 里。先关掉终端重新打开一次；还不行的话，官方脚本安装的按下面加 PATH（bash 用户把 ~/.zshrc 换成 ~/.bashrc）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell：

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

改完重新打开终端。在 VS Code 等编辑器的内置终端里，要把编辑器整个退出再打开。npm 安装的找不到命令，检查 npm config get prefix 输出的目录（macOS/Linux 下是其中的 bin 子目录）是否在 PATH 里。

EACCES: permission denied

npm 全局目录没有写权限，按不要用 sudo 一节把全局目录换到用户目录下。

running scripts is disabled on this system

Windows 上用 npm 安装后运行 npm 或 claude 报这个错，是 PowerShell 的执行策略拦住了 npm 生成的脚本。允许当前用户运行本地脚本后重试：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

不想改执行策略的话，也可以改用 npm.cmd 和 claude.cmd，这两个不受执行策略限制。

Error: claude native binary not installed

npm 安装时跳过了平台包或安装脚本。去掉 --omit=optional、--ignore-scripts 这类参数，检查 .npmrc 里没有 optional=false，然后重新安装。

卸载 Claude Code

按安装方式选择对应的命令：

官方脚本在 Windows 上装的，用 PowerShell 卸载：

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

想连配置一起删，再删掉用户目录下的 ~/.claude 文件夹和 ~/.claude.json 文件。这会清掉所有设置（包括 cdnd 的 Key 配置）、MCP 配置和会话记录。

常见问题

安装 Claude Code 需要 Node.js 吗？

只有用 npm 安装时需要 Node.js 22 或以上。官方安装脚本、Homebrew、WinGet 都不需要 Node.js。npm 装好的 claude 运行时也不依赖 Node.js。

npm 安装和官方脚本安装有什么区别？

装的是同一个官方程序。区别在下载渠道和更新方式：npm 可以走国内镜像，用 npm 命令升级；官方脚本从 Anthropic 的服务器下载，会在后台自动更新。国内网络推荐用 npm 镜像安装。

Windows 安装 Claude Code 必须用 WSL 吗？

不需要。Claude Code 可以直接在 Windows 的 PowerShell 或 CMD 里安装和运行，也不需要管理员权限。只有想用 Linux 工具链时才需要装在 WSL 里。

有 Claude Code 离线安装包吗？

官方没有提供单独的离线安装包，cdnd 也不提供第三方打包的安装包，来源不明的安装包有被篡改的风险。网络不好时用 npm 国内镜像安装即可，装的就是官方发布的程序。

安装后需要 Claude 账号才能用吗？

用 cdnd 不需要。安装后在 settings.json 里配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，Claude Code 会直接使用 cdnd 的 Key，不需要登录 Claude 账号，也不需要海外信用卡。