姚利锋

最近在玩 Claude Code 的 Sub Agent 功能，搞了个 content-to-article 子代理来提炼文章重点。

试了几个模型，发现 kimi 比 sonnet、opus 强一些，总结出来的内容更自然。

但每次都要手动改配置（nano ~/.bashrc），有点麻烦。

就想着能不能有个工具，让不同的子代理自动选择最适合的模型？

这样就不用手动折腾了。

然后就发现了 Claude Code Router 这个工具。

什么是 Claude Code Router？

Claude Code Routerhttps://github.com/musistudio/claude-code-router 是一个中间件工具，它可以让你：

智能路由：根据不同需求将请求路由到不同模型
多提供商支持：支持 OpenRouter、DeepSeek、Ollama、Gemini 等多家厂商
请求转换：自定义请求和响应格式
动态切换：在 Claude Code 中实时切换模型
CI/CD 集成：在 GitHub Actions 中触发 Claude Code 任务

简单来说，它就是 Claude Code 和各种 AI 模型之间的智能调度器。

Github:https://github.com/musistudio/claude-code-router https://github.com/musistudio/claude-code-routerhttps://github.com/musistudio/claude-code-router

核心功能亮点

1. 智能模型路由

这是我最喜欢的功能。你可以为不同的场景配置不同的模型：

{    "Router": {        "default": "deepseek,deepseek-chat",        "background": "ollama,qwen2.5-coder:latest",        "think": "deepseek,deepseek-reasoner",        "longContext": "openrouter,google/gemini-2.5-pro-preview",        "webSearch": "gemini,gemini-2.5-flash"    }}
  复制代码

比如：

默认任务 → 用 DeepSeek 处理
后台任务 → 用本地 Ollama 节省成本
推理任务 → 用 DeepSeek Reasoner
长上下文 → 用 Gemini 2.5 Pro
网络搜索 → 用支持联网的模型

这样一来，每个任务都能用最合适的模型。

2. 多提供商无缝集成

支持的提供商：

OpenRouter - 各种模型的聚合平台
DeepSeek - 国产之光
Ollama - 本地模型运行
Gemini - Google 的强大模型
火山引擎、硅基流动 - 国内云服务商
魔搭社区、阿里云 - 更多选择

每个提供商都有专门的 transformer 来处理 API 格式差异，用起来完基本无感。

3. 请求转换系统

这个功能内置了很多 transformer：

deepseek - 适配 DeepSeek API
gemini - 适配 Gemini API
openrouter - 适配 OpenRouter API
maxtoken - 设置最大 token 数
tooluse - 优化工具调用
reasoning - 处理推理内容
enhancetool - 增强工具调用容错性

你还可以写自定义 transformer，完全控制请求和响应的处理逻辑。

实际安装

安装配置

# 安装 Claude Code (如果还没有)npm install -g @anthropic-ai/claude-code# 安装 Claude Code Routernpm install -g @musistudio/claude-code-router
  复制代码

配置文件 ~/.claude-code-router/config.json 支持环境变量插值，安全性很好：

{    "OPENAI_API_KEY": "$OPENAI_API_KEY",    "GEMINI_API_KEY": "${GEMINI_API_KEY}"}
  复制代码

UI 管理界面

提供了 Web UI 来管理配置，不用手动编辑 JSON 文件了：

ccr ui
  复制代码

动态模型切换

在 Claude Code 中可以随时切换模型：

/model openrouter,anthropic/claude-3.5-sonnet
  复制代码

这个功能对于需要在不同模型间对比效果的场景特别有用。

高级功能

自定义路由逻辑

可以写自定义路由脚本：

module.exports = async function router(req, config) {    const userMessage = req.body.messages.find(m => m.role === 'user')?.content;    if (userMessage && userMessage.includes('explain this code')) {        return 'openrouter,anthropic/claude-3.5-sonnet';    }    return null; // 使用默认路由};
  复制代码

Subagent 路由

对于 Sub Agent 子代理，可以在 prompt 开头指定特定模型：

<CCR-SUBAGENT-MODEL>openrouter,anthropic/claude-3.5-sonnet</CCR-SUBAGENT-MODEL> 请帮我分析这段代码的优化点...
  复制代码

GitHub Actions 集成

可以在 CI/CD 中使用：

- name: Start Claude Code Router  run: |
      nohup ~/.bun/bin/bunx @musistudio/claude-code-router@1.0.8 start &
  shell: bash- name: Run Claude Code  uses: anthropics/claude-code-action@beta  env:      ANTHROPIC_BASE_URL: http://localhost:3456
  复制代码