一个配置文件搞定！Claude Code 多模型智能切换

Immerse

发布于 2025-09-17 13:46:17

35500

代码可运行

文章被收录于专栏：沉浸式趣谈沉浸式趣谈

运行总次数：0

代码可运行

大家好，我是 Immerse，一名独立开发者、内容创作者、AGI实践者。

• 关注公众号：#沉浸式趣谈，获取最新文章（更多内容只在公众号更新)
• 个人网站：https://yaolifeng.com 也同步更新。
• 转载请在文章开头注明出处和版权信息。

我会在这里分享关于编程、独立开发、AI、出海、个人思考等内容。

如果本文对你有帮助，欢迎动动小手指一键三连(点赞、评论、转发)，给我一些支持和鼓励，谢谢！

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

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

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

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

这样就不用手动折腾了。

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

什么是 Claude Code Router？

Claude Code Router[1] 是一个中间件工具，它可以让你：

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

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

Github:[2] https://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 Router
npm 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:StartClaudeCodeRouter
run:|
      nohup ~/.bun/bin/bunx @musistudio/claude-code-router@1.0.8 start &
shell:bash

-name:RunClaudeCode
uses:anthropics/claude-code-action@beta
env:
      ANTHROPIC_BASE_URL: http://localhost:3456

代码提交后自动触发 AI Code Review！