Claude Code + DeepSeek 国内使用教程

适用于:

  • Windows 10/11
  • VSCode
  • Qt/C++
  • DeepSeek/Qwen
  • 国内网络环境

一、安装 Node.js

下载 Node.js LTS 版本:

Node.js 官网

验证:

node -v
npm -v

二、配置 npm 国内镜像

避免安装速度过慢:

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

查看:

npm config get registry

输出:

https://registry.npmmirror.com

三、安装 Claude Code

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

验证:

claude --version

例如:

2.1.148 (Claude Code)

四、安装 Claude Code Router

Claude Code 默认连接 Anthropic。

国内推荐通过 Router 接入 DeepSeek。

安装:

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

验证:

ccr --version

查看帮助:

ccr

正常会看到:

Commands:
  start
  stop
  restart
  status
  code
  model
  ui

五、注册 SiliconFlow

官网:

SiliconFlow 官方网站

创建:

API Key

获得:

sk-xxxxxxxxxxxxxxxx

六、创建 Router 配置

配置目录:

C:\Users\用户名\.claude-code-router

创建:

config.json

示例:

{
  "Providers": [
    {
      "name": "siliconflow",
      "api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
      "api_key": "你的APIKey",
      "models": [
        "deepseek-ai/DeepSeek-V3"
      ],
      "transformer": {
        "use": [
          "openai"
        ]
      }
    }
  ],
  "Router": {
    "default": "siliconflow,deepseek-ai/DeepSeek-V3"
  }
}

七、启动 Router

启动服务:

ccr start

查看状态:

ccr status

重启:

ccr restart

八、启动 Claude Code

正确方式:

ccr code

不要:

claude

原因:

claude
    ↓
Anthropic 官方

ccr code
    ↓
Router
    ↓
DeepSeek

九、验证是否成功

输入:

你好

正常回复即可。

注意:

如果问:

你的模型是什么?

它可能回答:

我是 Claude Opus

这是因为 Claude Code 的系统提示词导致的。

不能作为判断依据。


十、常见错误

1. Unable to connect to Anthropic services

报错:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com

原因:

仍然在连接官方 Anthropic

解决:

ccr code

不要:

claude

2. Auth conflict

报错:

ANTHROPIC_AUTH_TOKEN
ANTHROPIC_API_KEY

同时存在。

解决:

claude logout

然后删除环境变量:

ANTHROPIC_AUTH_TOKEN

3. Please run /login

报错:

Please run /login

原因:

Router 没接管成功

检查:

ccr status

4. Missing model in request body

报错:

Missing model in request body

原因:

模型名配置错误

检查:

"default": "siliconflow,deepseek-ai/DeepSeek-V3"

是否正确。


5. PowerShell 无法执行脚本

报错:

PSSecurityException
无法加载 ccr.ps1

解决:

管理员 PowerShell:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入:

Y

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐