摘要：很多同学直接执行
npm i -g @anthropic-ai/claude-code会卡在最后一动不动，就算切换 npmmirror 淘宝镜像也没用。核心原因：npm 包本身只是一个包装器，安装后期会从cdn.anthropic.com拉取 Claude Code 官方二进制程序，国内镜像站无法代理这个 CDN 资源，这是最容易踩的坑。
前置说明
- npm 方式依赖 Node.js，要求 Node >= 18，推荐 22 LTS
- 卡的时候先
Ctrl + C终止卡住的安装进程，不要一直等 - 验证安装成功命令：
claude --version
方案一：优先推荐｜官方原生一键安装脚本（避开 npm 二进制下载坑）
这个方案不依赖 npm，自带 runtime，绕开了最容易卡死的二进制下载环节，是官方主推方式。
macOS / Linux / WSL：
curl -fsSL https://claude.ai/install.sh | bash
Windows（PowerShell）二选一：
winget install Anthropic.ClaudeCode
# 或者官方脚本
irm https://claude.ai/install.ps1 | iex
Mac 用户也可以用 Homebrew：
brew install --cask claude-code
方案二：坚持用 npm 安装｜镜像 + 详细日志排查
如果你习惯 npm 全局管理包，可以先清理缓存，带上镜像和 verbose 日志，定位卡点。
# 清理npm缓存
npm cache clean --force
# 带镜像 + 详细日志执行安装
npm i -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com --verbose
看日志重点：
- 如果卡在
registry.npmmirror.com：npm 包下载慢，换网络或者换镜像源 - 如果日志出现
https://cdn.anthropic.com/并且停滞：镜像无效，二进制下载被墙，直接换方案一或者配置代理
方案三：npm 安装 + 代理环境（解决cdn.anthropic.com下载）
macOS / Linux / WSL 终端先注入代理环境变量，再执行安装：
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
npm i -g @anthropic-ai/claude-code
Windows PowerShell 代理写法：
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
npm i -g @anthropic-ai/claude-code
高频踩坑清单（避坑）
- ❌ 不要加 sudo 全局安装，极易造成权限锁死、后续命令找不到
- WSL 用户额外坑：平台识别错乱，提前执行
npm config set os linux - 安装完提示
claude: command not found- 新开终端加载 PATH
- 打印全局 bin 目录，加入环境变量：
npm bin -g
- Node 版本过低，会静默卡死、无报错，先校验版本：
node -v
小结
- 追求省心：直接上官方
install.sh/winget，避开 npm 二进制下载陷阱 - 想继续 npm 管理：要么开代理，要么接受大概率卡在 cdn.anthropic.com
- 排查优先加
--verbose，一眼分清是 npm 源问题，还是二进制 CDN 下载问题
正文完
可以使用微信扫码关注公众号（ID：xzluomor）
