编程助手 Claude Code 配置指南

Claude Code 是 Anthropic 推出的一款专注于代码辅助的工具，基于 Claude 大模型构建，能提供实时代码建议、代码解释与优化、多语言支持等功能，可与主流 IDE 集成，通过自然语言交互帮助开发者高效编程。

而 Claude Code Router 作为其增强工具，主要解决了 Claude Code 原生仅支持 Anthropic 自家模型的限制：它能将请求路由到七牛云、OpenRouter 等多个提供商的不同模型，可根据任务类型（如简单补全、复杂推理、长上下文处理）灵活选择适配模型，优化成本与性能平衡，还支持请求 / 响应转换、动态模型切换及 GitHub Actions 集成等，让代码辅助更灵活高效，其核心功能包括：

• 模型路由：根据需求将请求路由到不同模型（如后台任务、思考过程、长上下文处理等）
• 多提供商支持：兼容多种模型提供商的 API 接口
• 请求/响应转换：通过转换器适配不同提供商的 API 格式
• 动态模型切换：支持通过命令实时切换模型
• UI 管理界面：提供直观的 Web 界面管理配置

安装步骤

1. 安装 npm（如果尚未安装）

在开始之前，请确保您的系统已安装 Node.js 和 npm。如果尚未安装：

访问 Node.js 官网 下载对应操作系统的安装包并运行安装。

验证安装

node --version
npm --version

2. 安装 Claude Code

首先安装官方的 Claude Code 工具：

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

3. 安装 Claude Code Router

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

配置指南

1. 创建配置文件

创建并编辑配置文件 ~/.claude-code-router/config.json

{
  "Providers": [
    {
      "name": "qiniu",
      "api_base_url": "https://openai.qiniu.com/v1/chat/completions",
      "api_key": "你的七牛云大模型推理服务 apikey",
      "models": [
        "deepseek-v3.1",
        "nvidia/llama-3.3-nemotron-super-49b-v1.5",
        "gpt-oss-120b"
      ],
      "transformer": {
        "use": [],
        "deepseek-v3.1": {
          "use": [
            [
              "maxtoken",
              {
                "max_tokens": 8192
              }
            ]
          ]
        }
      }
    }
  ],
  "Router": {
    "default": "qiniu,deepseek-v3.1",
    "background": "qiniu,deepseek-v3.1",
    "think": "qiniu,deepseek-v3.1",
    "longContext": "qiniu,deepseek-v3.1",
    "longContextThreshold": 60000,
    "webSearch": "qiniu,deepseek-v3.1"
  }
}

1.1 DeepSeek V3.1 兼容性转换

由于目前 DeepSeek V3.1 的 max_token 参数的可接受范围在 [1,8192]，这和 Claude Code 默认的参数有区别，所以我们需要对这个参数进行覆盖处理，对于其他模型，默认无需配置：

{
  "transformer": {
    "use": [],
    "deepseek-v3.1": {
      "use": [
        [
          "maxtoken",
          {
            "max_tokens": 8192
          }
        ]
      ]
    }
  }
}

2. 配置说明

• 基本设置：可根据需要配置代理、日志级别、超时时间等
• 七牛云配置：
  • name：自定义提供商标识，用于路由配置
  • api_base_url：七牛云API地址（固定值）
  • api_key：需替换为你的七牛云API密钥
  • models：七牛云提供的可用模型列表
• 路由设置：
  • default：默认使用的模型
  • 其他场景可根据需求指定不同模型

使用方法

1. 启动服务

ccr code

2. 重启服务（配置修改后需要）

ccr restart

3. 使用UI管理界面

启动Web界面以便直观管理配置：

ccr ui

4. 动态切换模型

在 Claude Code 中使用/model命令切换模型：

# 切换到七牛云的 nvidia/llama-3.3-nemotron-super-49b-v1.5 模型
/model qiniu,nvidia/llama-3.3-nemotron-super-49b-v1.5

# 切换到七牛云的 gpt-oss-120b 模型
/model qiniu,gpt-oss-120b

5. 总结

至此，我们已经成功将七牛云 AI 推理服务接入到了 Claude Code，开始享受愉快的编码体验吧。