博客

Claude Code 国内安装:官方脚本报错时用 npm 镜像安装

Claude Code 官方推荐用安装脚本安装,脚本要从 downloads.claude.ai 下载程序,在国内经常下载失败。Claude Code 也发布在 npm 上,从国内的 npm 镜像安装不经过 downloads.claude.ai。以下按 Claude Code 2.1.312 核对(2026 年 10 月 30 日)。

RoamAI 团队发布于 2026年10月30日

官方脚本的报错

官方的安装命令是:

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

Windows PowerShell 是 irm https://claude.ai/install.ps1 | iex。两个脚本都先从 downloads.claude.ai 取最新的版本号,取不到时停下来,报:

Failed to get a valid version from downloads.claude.ai (got unexpected content).

下一行提示下载服务连不上,或者所在地区不能用。claude.ai 本身打不开时,连脚本都下载不下来。两种情况都改用下面的 npm 安装。

先装 Node.js 22 或更新的版本

npm 上的 Claude Code 要求 Node.js 22 或更新的版本。先看当前版本:

node --version

没装,或者版本低于 22,到 nodejs.org 下载 LTS 版本安装。国内下载慢的话,npmmirror 镜像有同样的安装包:https://npmmirror.com/mirrors/node/

用国内镜像安装

macOS 和 Linux 在终端里运行,Windows 在 PowerShell 或命令提示符里运行同一条命令:

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

装好后确认:

claude --version

能看到版本号就装好了。npm 包会按你的系统另外装上对应的程序包,程序包也从同一个镜像下载,不经过 downloads.claude.ai。

macOS 或 Linux 报 EACCES 权限错误,是因为 npm 的全局目录要管理员权限。不要用 sudo npm install,改用 nvm 安装 Node.js,或者把 npm 的全局目录设到自己的家目录下。

更新

把安装命令加上 @latest 再运行一次:

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

不想每次都写 --registry,可以把 npm 的默认源换成镜像。这会影响这台电脑上所有的 npm 安装:

npm config set registry https://registry.npmmirror.com

Claude Code 自己也会自动更新。想关掉自动更新、自己决定什么时候升级,设环境变量 DISABLE_AUTOUPDATER=1。

装好之后接 API Key

Anthropic 的服务地区不包括中国大陆,所以在国内要用 API Key 和服务地址接入 Claude Code,不用 claude.ai 账号登录。设置方法见《用 API Key 接入 Claude Code》,接不上时按报错原文查《Claude Code 接 API 常见报错》。

每人一个 Key,接上 Claude Code

RoamAI 是给团队用的 Claude API:在控制台创建 API Key,填到 Claude Code、Claude Desktop 或 SDK 里就能用。开通 VIP 用量更便宜,另有专属服务器和专人对接。

开始使用

← 全部文章