T7 API
首页 / 教程 / Claude Code 国内安装教程

Claude Code 国内安装教程

更新于 2026-11-19

官方安装脚本要访问 claude.ai,国内网络经常下载失败(Windows 上会出现 System.Xml.XmlDocument 之类的红字)。更稳的办法是先装 Node.js,再从 npm 国内镜像安装 Claude Code。

1. 安装 Node.js(22 或更高版本)

装完关掉 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 配置中转教程 填上接口地址和密钥即可,一行命令就能配好。