← 返回文章列表

READING MODE

中国大陆安装 Claude Code 完全指南：不翻墙、零成本

·15 分钟
claude-codetutorialchina

Claude Code 是 Anthropic 出品的 AI 编程助手，直接在终端里运行，能帮你读代码、改代码、跑命令。但它有两个问题：官方不对中国大陆开放，而且需要付费订阅（$20/月起）。

这篇教程用一条曲线绕过这两个限制：装 Claude Code 本体 + 用 claude-code-router 把请求转发给免费的国产模型（DeepSeek）。全程不需要翻墙，不需要海外信用卡。

预计耗时：30 分钟。

教程同时覆盖 Windows 和 Mac，每一步都标注了你应该看到的结果，方便自检。

第零步：三条路线，你走哪条？

在国内用 Claude Code 有三种方式，本教程走路线 A：

路线成本翻墙？说明
A. 免费国产模型¥0不需要Claude Code + DeepSeek，本文重点
B. API 中转站按量付费不需要用真正的 Claude 模型，文末简要介绍
C. 官方订阅$20-200/月需要需海外信用卡，有封号风险，本文不涉及

第一步：打开终端

终端（Terminal）就是一个输入命令的窗口。后面所有操作都在这里进行。

Windows

按键盘上的 Win 键，输入 PowerShell，点击打开。你会看到一个蓝色背景的窗口，开头显示 PS C:\Users\你的用户名>。

注意：不需要"以管理员身份运行"。

输入以下命令测试终端是否正常：

echo hello

看到输出 hello = 终端正常工作。

Mac

按 Command + 空格，输入 终端（或 Terminal），回车打开。你会看到一个窗口，末尾有 $ 或 % 符号。

echo hello

看到输出 hello = 终端正常工作。

第二步：安装 Git

Git 是版本管理工具，Claude Code 在 Windows 上依赖它运行。Mac 上也需要，但安装更简单。

先检查是否已安装：

git --version

如果看到类似 git version 2.xx.x 的输出，说明已经装好了，跳过这一步。

如果看到"不是内部命令"或"command not found"，继续往下。

Windows 安装 Git

从清华大学镜像下载（国内高速，不用翻墙）：

清华镜像 - Git for Windows

找到 Git-2.53.0.2-64-bit.exe（或更新版本的 64-bit.exe），下载后双击安装。安装过程中注意：

  • 一路点 Next 即可，默认选项就够用
  • 确保 "Git Bash Here" 和 "Add to PATH" 选项被勾选（默认就是勾选的）

安装完成后，关闭 PowerShell，重新打开，再次验证：

git --version

看到 git version 2.53.x = 安装成功。

Mac 安装 Git

在终端输入：

git --version

如果 Mac 没装过 Git，系统会自动弹出一个对话框，提示你安装"命令行开发者工具"（Command Line Tools）。点击 "安装"，等几分钟自动完成。

安装后再次运行 git --version，看到版本号 = 成功。

第三步：安装 Node.js

Node.js 是 JavaScript 运行环境。虽然 Claude Code 本体不再需要它，但我们后面要装的 claude-code-router 需要 Node.js。

先检查是否已安装：

node -v

看到 v18.x.x 或更高版本 = 跳过这一步。

Windows 安装 Node.js

直接去 Node.js 官网下载页（国内可直连）：

https://nodejs.org/zh-cn/download

页面上找到 Windows 一栏，点击下载 .msi 安装包（选 LTS 长期支持版）。下载后双击安装，一路 Next。

关闭 PowerShell，重新打开，验证：

node -v

看到版本号（如 v22.x.x）= Node.js 安装成功。接下来试 npm：

npm -v

如果 npm 正常显示版本号，跳到下面的"配置 npm 国内镜像"。

⚠️ 如果 npm 报错"无法加载文件...因为在此系统上禁止运行脚本"：

这是 Windows PowerShell 默认的安全策略，禁止运行所有脚本。运行以下命令解除限制：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

系统会提示你确认，输入 Y 回车。然后再次运行 npm -v，应该能看到版本号了。

Mac 安装 Node.js

方式一（推荐）：去 Node.js 官网下载页 下载 macOS 安装包（.pkg），双击安装。

方式二：如果你已经有 Homebrew：

brew install node

验证：

node -v
npm -v

看到版本号 = 成功。

配置 npm 国内镜像（重要！）

npm 默认从国外服务器下载包，在国内会很慢甚至超时。一条命令切换到淘宝镜像：

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

验证：

npm config get registry

看到 https://registry.npmmirror.com/ = 配置成功。

第四步：安装 Claude Code

Claude Code 官方推荐的安装方式需要从 Google 服务器下载文件，在国内基本会失败。既然我们已经装好了 npm，直接用它安装最稳。

Windows

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

Mac

方式一：Homebrew（推荐，如果你已经有 Homebrew）

brew install --cask claude-code

方式二：npm 安装

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

验证安装

无论用哪种方式，安装完成后关闭终端，重新打开，输入：

claude --version

看到版本号（如 2.1.x）= 安装成功。

如果提示"不是内部命令"或"command not found"：

  • Windows：检查 %USERPROFILE%\.local\bin 是否在系统 PATH 中。搜索"环境变量" → 编辑用户变量 → Path → 添加 %USERPROFILE%\.local\bin
  • Mac：检查 ~/.local/bin 是否在 PATH 中。运行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

到这里，Claude Code 已经装好了。但先别运行 claude 命令——它会要求你登录 Anthropic 账号（需要翻墙 + 付费订阅）。我们用下面的方法绕过它。

第五步：注册硅基流动获取免费 API Key

我们用硅基流动（SiliconFlow）作为模型提供方——注册送 ¥14 免费额度（约 2000 万 tokens），是目前国内最大方的免费方案。它支持 DeepSeek V3 等多个模型，国内直连，速度快。

操作步骤：

  1. 打开 cloud.siliconflow.cn
  2. 右上角点击登录，用手机号注册（+86 国内号码）
  3. 登录后，左侧菜单找到 "API 密钥"
  4. 点击 "新建密钥"
  5. 复制并保存你的 Key（格式如 sk-xxxxxxxxxxxxxxxx）

⚠️ API Key 只会显示一次！请立即复制到记事本或安全的地方保存。如果忘了复制，删掉这个 Key 再创建一个新的就行。

第六步：安装 claude-code-router

claude-code-router 是一个开源工具，它拦截 Claude Code 发出的请求，转发给你指定的模型（比如硅基流动上的 DeepSeek V3），这样你就不需要 Anthropic 账号了。

npm install -g @musistudio/claude-code-router

验证：

ccr --help

看到帮助信息 = 安装成功。

如果提示 ccr 不是命令，尝试关闭终端重新打开。

第七步：配置模型

我们需要创建一个配置文件，告诉 claude-code-router 把请求发给硅基流动上的 DeepSeek V3。

Windows

在 PowerShell 里逐行运行以下命令，创建配置文件夹并用记事本打开配置文件：

New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude-code-router" -Force
notepad "$env:USERPROFILE\.claude-code-router\config.json"

记事本会打开（可能提示文件不存在，选"是"创建新文件）。粘贴以下内容，把 sk-xxx 换成你第五步拿到的硅基流动 API Key：

{
  "Providers": [
    {
      "name": "siliconflow",
      "api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
      "api_key": "sk-xxx",
      "models": ["deepseek-ai/DeepSeek-V3"],
      "transformer": {
        "use": [
          ["maxtoken", {"max_tokens": 16384}]
        ]
      }
    }
  ],
  "Router": {
    "default": "siliconflow,deepseek-ai/DeepSeek-V3",
    "think": "siliconflow,deepseek-ai/DeepSeek-V3"
  }
}

保存并关闭记事本。

Mac

mkdir -p ~/.claude-code-router
nano ~/.claude-code-router/config.json

粘贴上面同样的 JSON 内容（记得替换 sk-xxx）。然后按 Ctrl+O 回车保存，Ctrl+X 退出。

字段说明

  • api_base_url：硅基流动的 API 地址
  • api_key：你在硅基流动获取的 API Key
  • models：要使用的模型。deepseek-ai/DeepSeek-V3 是硅基流动上的 DeepSeek V3 模型，编程能力强
  • transformer：协议转换配置，maxtoken 限制单次最大输出长度
  • Router：路由规则，格式为 provider名,模型名（逗号分隔）。default 是默认模型，think 是深度思考时用的模型

第八步：启动 Claude Code！

一切准备就绪。在终端里进入你想要工作的项目目录（或者任意一个文件夹），然后运行：

ccr code

你应该看到：

  1. claude-code-router 启动，显示本地代理地址（http://127.0.0.1:xxxx）
  2. Claude Code 自动启动
  3. 出现 claude> 提示符

试一试：

> 帮我写一个 Python 的 hello world 程序并保存到 hello.py

看到它生成代码并创建文件 = 一切正常，恭喜！你已经在国内成功运行 Claude Code 了。

日常使用备忘

每次使用 Claude Code，只需要：

cd 你的项目目录
ccr code

一些常用操作：

  • /help — 查看所有命令
  • /model — 切换模型
  • /config — 修改配置
  • Ctrl+C — 中断当前操作
  • 输入 exit 或按 Ctrl+D — 退出 Claude Code

进阶：更多模型选择

硅基流动 + DeepSeek V3 是零成本起步的最佳方案，但不是唯一的选择。以下是其他值得了解的方案：

火山引擎 · 豆包编程模型（推荐升级）

字节跳动出品，专门为 AI 编程优化的模型（Doubao-Seed-Code），官方兼容 Anthropic API 格式。首次使用赠 50 万 tokens，首月套餐 ¥9.9。编程场景下效果比通用模型更好。

注册地址：volcengine.com

DeepSeek 官方 API

如果你愿意花 ¥1 充值，DeepSeek 官方 API 价格极低，而且支持 DeepSeek-Reasoner 推理模型。注册地址：platform.deepseek.com（需实名认证）。

API 中转站（用真正的 Claude 模型）

如果你想用 Anthropic 原版的 Claude 模型，可以通过 API 中转站实现。原理是中转站在海外部署服务器代理请求，你只需要改 config.json 里的 provider 配置。支持支付宝/微信付款，按量计费，不需要翻墙。具体推荐搜索"Claude Code 中转站 2026"。

常见问题

"claude 不是内部命令" / "command not found"

安装后没有重新打开终端。关闭终端，重新打开再试。如果还不行，检查 PATH 环境变量（见第四步的故障排查）。

npm install 很慢或超时

确认已经配置了国内镜像：

npm config get registry

应该显示 https://registry.npmmirror.com/。如果不是，重新运行第三步的镜像配置命令。

ccr code 启动后报错

最常见的原因是 config.json 格式错误（比如多了逗号或少了引号）。把你的配置粘贴到 jsonlint.com 检查语法。

API 返回 500 错误 "Cannot read properties of undefined"

config.json 里的 Providers 和 Router 必须首字母大写，路由格式必须是逗号分隔（如 siliconflow,deepseek-ai/DeepSeek-V3）。请对照第七步的配置模板仔细检查。

API 返回 401 错误

API Key 不正确或已过期。去 硅基流动控制台 确认 Key 状态，必要时重新创建一个。

生成的代码质量不如预期

DeepSeek V3 在大部分编程任务上表现不错，但和 Claude 原版确实有差距。可以考虑换用火山引擎的豆包编程模型（专为编程优化），或者通过 API 中转站使用 Claude 原版模型。

免费额度用完了怎么办？

硅基流动的 ¥14 额度用完后可以直接充值，DeepSeek V3 的 API 价格很便宜，日常编程使用每月几块钱就够了。也可以注册 DeepSeek 官方（¥1 起充）或火山引擎（首月 ¥9.9 套餐）作为备选。