2026年 Claude Code 国内安装指南：免科学上网，8秒上手

如果你身处国内，希望使用 Claude Code 却又不想折腾科学上网工具，本教程将为你提供一条快捷通道。我们在 Windows 系统（也兼容 macOS 和 Linux）上完成了全流程实测，全程使用国内网络，安装 Claude Code v2.1.138 仅耗时 8 秒，并将后端模型切换为国产 DeepSeek API，彻底摆脱对 Anthropic 官网的依赖。

核心理念非常简单：将 Claude Code 的命令行交互界面安装好，然后用 DeepSeek 等国内大模型驱动对话。这意味着你无需访问 Anthropic 的官方网站，即可顺畅使用所有编码辅助功能。

安装前准备：必备软件与版本环境

本次验证的电脑环境如下，建议你对照自己的机器提前配齐相关工具。

1. Node.js（必须安装）
下载地址（国内直接可访）：
👉 https://nodejs.org/zh-cn/
请选择 LTS（长期支持）版本安装，一路默认设置即可。

2. Git（必须安装）
下载地址（国内直接可访）：
👉 https://git-scm.com/downloads
下载后按照默认选项完成安装。务必将 Git 加入环境变量，后面会用到。

3. npm 国内镜像源（建议配置）
打开终端并执行以下指令，将 npm 源切换至 npmmirror.com，提升后续下载速度：

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

验证设置是否成功：

npm config get registry

终端若显示 https://registry.npmmirror.com 即表示镜像生效。

第一步：通过 npm 全局安装 Claude Code

官方推荐的一键安装脚本指向非国内可访问的服务器，因此我们改用 npm 全局安装的方式，实测一切顺利。

在终端中输入：

npm install -g @anthropic-ai/claude-code

安装过程终端会回馈类似信息：

added 2 packages in 8s

借助 npmmirror.com 镜像，整个下载耗时仅 8 秒。安装完成后，npm 会自动在你的用户目录生成 .claude 配置文件目录。

重要提醒：如果电脑上还没有安装 Git，在执行 claude 相关命令时可能会遭遇 Git 缺失报错，请务必提前装好 Git 再继续。

第二步：确认安装成功

为避免环境变量未及时刷新，请先关闭当前终端，再重新打开一个新的终端窗口，执行：

claude --version

实机会输出版本号：

2.1.138 (Claude Code)

若出现 'claude' 不是内部或外部命令 的提示，说明 npm 全局目录未包含在系统 PATH 中。执行 npm config get prefix 查看实际路径，将返回的路径手动添加到系统环境变量的 PATH 条目中，重启终端后即可正常识别。

第三步：绕过登录认证（国内网络必要步骤）

安装后若直接运行 claude，程序会尝试引导你到 Anthropic 官网登录，在国内网络下显然无法完成。我们只需修改一个配置文件即可跳过该弹窗。

用任意文本编辑器（如记事本）打开以下文件，具体路径因操作系统而异：

• Windows： C:\Users\你的用户名\.claude.json
• macOS / Linux： ~/.claude.json

在 JSON 对象内增加一行 "hasCompletedOnboarding": true，完成后文件内容示意如下：

{
    "firstStartTime": "2026-05-10T12:25:29.445Z",
    "hasCompletedOnboarding": true,
    "userID": "fe973fefc5e80881c837c1efdba18eb00fe24c35d487bf3478e38052463a3e3c"
}

保存后关闭文件，重新运行 claude，就不会再弹出登录界面，直接进入命令行对话模式。

第四步：配置 DeepSeek API 驱动

跳过认证后，Claude Code 仍会默认连接 Anthropic 官方 API，我们需要将其转向可访问的国产模型。这里以 DeepSeek 为例进行配置。

4.1 获取 DeepSeek 的 API 密钥
访问 https://platform.deepseek.com/ ，注册并登录。进入「API密钥」页面创建一个以 sk- 开头的密钥。DeepSeek 为新用户提供一定免费额度，足够日常开发使用。

4.2 编写模型配置
在 .claude 目录下新建一个名为 settings.json 的文件，填入以下内容（请将密钥替换为你的真实值）：

{
    "env": {
      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/v1",
      "ANTHROPIC_API_KEY": "sk-你的DeepSeek API密钥",
      "ANTHROPIC_MODEL": "deepseek-chat"
    }
}

• ANTHROPIC_BASE_URL：指向 DeepSeek 的 API 地址。
• ANTHROPIC_API_KEY：你的 DeepSeek 密钥。
• ANTHROPIC_MODEL：指定使用的对话模型。

你也可以临时通过环境变量设置（重启终端后失效）：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-你的DeepSeek API密钥"
export ANTHROPIC_MODEL="deepseek-chat"

设置完成后运行 claude --print，若看到 Invalid API key 的提示，则说明配置已被正确读取，只是密钥值还需换成真实可用的。

第五步：开始使用 Claude Code

进入你的项目文件夹，打开终端，直接输入：

claude

现在你可以像和同事聊天一样提出需求，例如：

• “帮我写一个 Python 爬虫”
• “检查一下这段 JS 文件有没有潜在 bug”
• “为这个项目生成一个 README 文档”

如果运行时出现 Model Not Exist 的提示，在 Claude Code 的交互界面里输入 /model deepseek-chat，手动切换一次模型即可。

常用命令速查

常见问题与处理方式

npm install 报错或下载极慢
执行 npm config set registry https://registry.npmmirror.com 切换至 npmmirror 镜像，然后重新执行安装命令即可。

提示 ‘claude’ 不是内部或外部命令
运行 npm config get prefix 找出 npm 全局安装目录，将该路径手动添加到系统环境变量 PATH 中，重启终端。

提示 Invalid API key
这是正常现象，表明配置已生效。只需确认 settings.json 中的 ANTHROPIC_API_KEY 已填入你的真实 DeepSeek 密钥。

提示 Model Not Exist
在 Claude Code 界面输入 /model deepseek-chat 切换模型即可。

总结

在国内环境安装 Claude Code，只需这五步：装好 Node.js 与 Git → 切换 npm 镜像源 → 通过 npm 全局安装 → 修改配置文件跳过登录 → 对接 DeepSeek API。全程不需要任何科学上网工具，所有下载地址国内正常可访。从开始安装到启动对话，实测耗时不过 8 秒。