Claude Code 国内安装教程
官方安装脚本要访问 claude.ai,国内网络经常下载失败(Windows 上会出现 System.Xml.XmlDocument 之类的红字)。更稳的办法是先装 Node.js,再从 npm 国内镜像安装 Claude Code。
1. 安装 Node.js(22 或更高版本)
- 打开 nodejs.org 下载页,Windows 下载
.msi安装包、macOS 下载.pkg安装包,一路「下一步」装完。 - 官网打不开或下载很慢时,用 npmmirror 国内镜像:进入版本号最大的
v22.x或v24.x目录,Windows 下载node-v版本号-x64.msi。
装完关掉 PowerShell 或终端,重新打开一个(不重开会找不到 npm),运行:
node -v
npm -v
两行都显示版本号,而且 node -v 是 v22 或更高就可以。
2. 用国内镜像安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
如果 npm -v 显示的版本是 12 开头,先运行下面这行再安装,否则装完会提示 claude native binary not installed:
npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user
运行 claude --version,能看到版本号就装好了。
Windows 常见问题
| 现象 | 解决 |
|---|---|
npm : 无法将“npm”项识别为… | 没装 Node.js,或装完没重开 PowerShell。按第 1 步安装后关掉 PowerShell 重新打开。 |
node -v 有版本号,npm -v 没有或出现红字 | Windows 执行策略拦住了 npm 的脚本。运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned(提示时输入 Y);也可以不改设置,把 npm 都改写成 npm.cmd。 |
无法加载文件 …\claude.ps1,因为在此系统上禁止运行脚本 | 同上,运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,或改用 claude.cmd。 |
No suitable shell found | 安装 Git for Windows(国内可从 npmmirror 下载),装完重开 PowerShell。 |
node -v 低于 v22 | 按第 1 步重新安装新版 Node.js。 |
有海外网络时:官方安装脚本
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
装好之后
Claude Code 第一次启动会要求登录 Anthropic 账号,国内网络会卡在这一步。接着按 Claude Code 配置中转教程 填上接口地址和密钥即可,一行命令就能配好。