通过 Router 配置 Claude Code 编程助手

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

而 Claude Code Router 作为其外挂工具，主要解决了 Claude Code 原生仅支持 Claude 大模型的限制：它能将请求路由到七牛云等模型服务商的各种不同大模型上，用户可根据任务类型（如简单补全、复杂推理、长上下文处理）灵活选择适配模型，优化成本与性能平衡，还支持请求 / 响应转换、动态模型切换及 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",
        "x-ai/grok-code-fast-1"
      ]
    }
  ],
  "Router": {
    "longContextThreshold": 60000,
    "default": "qiniu,deepseek-v3.1",
    "background": "qiniu,deepseek-v3.1",
    "think": "qiniu,deepseek-v3.1",
    "longContext": "qiniu,deepseek-v3.1",
    "webSearch": "qiniu,deepseek-v3.1"
  }
}

2. 配置说明

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

使用方法

1. 启动Code

ccr code

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

ccr restart

3. 使用UI管理配置

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

ccr ui

4. 动态切换大模型

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

# 切换到七牛云的 x-ai/grok-code-fast-1 模型
/model qiniu,x-ai/grok-code-fast-1

5. 总结

至此，我们已经成功将Claude Code对接到七牛云 AI 推理服务上的其他高性价比模型，开始享受愉快的编码体验吧。