Claude Code Router子代理路由：精准控制多Agent模型分配

你是否在使用Claude Code时遇到过这样的问题？- 复杂的多步骤任务中，不同子任务需要不同能力的模型- 高成本的大模型被浪费在简单的后台任务上- 长上下文处理需要专门的模型，但手动切换太麻烦- 推理密集型任务需要专门的思考模型传统的单一模型方案无法满足这些复杂场景的需求。**Claude Code Router的子代理路由功能**正是为了解决这些痛点而生，让你能够精准控制每个子...

喻珺闽

1184人浏览 · 2025-09-01 15:42:36

喻珺闽 · 2025-09-01 15:42:36 发布

Claude Code Router子代理路由：精准控制多Agent模型分配

【免费下载链接】claude-code-router Use Claude Code without an Anthropics account and route it to another LLM provider 项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router

🎯 痛点：多Agent场景下的模型选择困境

你是否在使用Claude Code时遇到过这样的问题？

复杂的多步骤任务中，不同子任务需要不同能力的模型
高成本的大模型被浪费在简单的后台任务上
长上下文处理需要专门的模型，但手动切换太麻烦
推理密集型任务需要专门的思考模型

传统的单一模型方案无法满足这些复杂场景的需求。Claude Code Router的子代理路由功能正是为了解决这些痛点而生，让你能够精准控制每个子代理使用的模型，实现成本与性能的最优平衡。

🔧 子代理路由核心机制

工作原理概述

Claude Code Router通过解析子代理提示词中的特殊标记来实现精准路由。当Claude Code创建子代理时，Router会检测提示词开头的<CCR-SUBAGENT-MODEL>标签，并自动将对应的请求路由到指定的模型。

mermaid

技术实现细节

在路由处理层，Claude Code Router通过以下逻辑实现子代理路由：

// src/utils/router.ts 中的关键代码
if (req.body?.system?.length > 1 &&
    req.body?.system[1]?.text?.startsWith("<CCR-SUBAGENT-MODEL>")) {
  const model = req.body?.system[1].text.match(
    /<CCR-SUBAGENT-MODEL>(.*?)<\/CCR-SUBAGENT-MODEL>/s
  );
  if (model) {
    req.body.system[1].text = req.body.system[1].text.replace(
      `<CCR-SUBAGENT-MODEL>${model[1]}</CCR-SUBAGENT-MODEL>`,
      ""
    );
    return model[1]; // 返回指定的模型路由
  }
}

🎪 实战场景：多模型协同工作流

场景一：代码审查与优化流水线

<CCR-SUBAGENT-MODEL>openrouter,anthropic/claude-3.5-sonnet</CCR-SUBAGENT-MODEL>
请分析以下TypeScript代码的性能瓶颈和安全问题，并提供优化建议：

```typescript
// 需要审查的代码...

审查要求：

识别内存泄漏风险
检查类型安全性
建议性能优化方案
评估并发处理能力


### 场景二：多语言文档生成

```markdown
<CCR-SUBAGENT-MODEL>deepseek,deepseek-reasoner</CCR-SUBAGENT-MODEL>
请将以下技术文档翻译为英文、日文和德文，保持技术术语的准确性：

【原始中文文档内容...】

翻译要求：
1. 技术术语使用行业标准译法
2. 保持代码示例的完整性
3. 适应不同语言的技术文档格式规范

场景三：复杂数据分析任务

<CCR-SUBAGENT-MODEL>gemini,gemini-2.5-pro</CCR-SUBAGENT-MODEL>
请分析以下数据集，识别异常模式并生成可视化报告：

数据集特征：
- 时间序列数据，包含100万条记录
- 15个数值型特征，5个分类特征
- 存在缺失值和异常值

分析要求：
1. 使用统计方法检测异常
2. 生成交互式可视化图表
3. 提供数据清洗建议
4. 预测未来趋势

⚙️ 配置指南：精细化路由策略

基础配置模板

{
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "$OPENROUTER_API_KEY",
      "models": [
        "anthropic/claude-3.5-sonnet",
        "google/gemini-2.5-pro-preview"
      ],
      "transformer": {
        "use": ["openrouter"]
      }
    },
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "$DEEPSEEK_API_KEY",
      "models": ["deepseek-chat", "deepseek-reasoner"],
      "transformer": {
        "use": ["deepseek"]
      }
    },
    {
      "name": "ollama",
      "api_base_url": "http://localhost:11434/v1/chat/completions",
      "api_key": "ollama",
      "models": ["qwen2.5-coder:latest", "llama3.2:latest"]
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat",
    "background": "ollama,qwen2.5-coder:latest",
    "think": "deepseek,deepseek-reasoner",
    "longContext": "openrouter,google/gemini-2.5-pro-preview",
    "longContextThreshold": 60000
  }
}

高级路由策略表

场景类型	推荐模型	成本系数	适用任务	配置示例
代码生成	DeepSeek Chat	1.0x	日常编码、bug修复	`deepseek,deepseek-chat`
复杂推理	Claude 3.5 Sonnet	3.5x	架构设计、算法优化	`openrouter,anthropic/claude-3.5-sonnet`
长上下文	Gemini 2.5 Pro	2.0x	文档分析、代码审查	`gemini,gemini-2.5-pro`
后台任务	本地Ollama	0.1x	简单查询、文本处理	`ollama,qwen2.5-coder:latest`
思考模式	DeepSeek Reasoner	1.8x	计划制定、多步推理	`deepseek,deepseek-reasoner`

🚀 性能优化最佳实践

成本控制策略

mermaid

Token使用监控

Claude Code Router内置Token计算功能，实时监控每个子代理的资源消耗：

// Token计算核心逻辑
const calculateTokenCount = (messages: MessageParam[], system: any, tools: Tool[]) => {
  let tokenCount = 0;
  // 计算消息Tokens
  messages.forEach((message) => {
    if (typeof message.content === "string") {
      tokenCount += enc.encode(message.content).length;
    } else if (Array.isArray(message.content)) {
      message.content.forEach((contentPart: any) => {
        if (contentPart.type === "text") {
          tokenCount += enc.encode(contentPart.text).length;
        }
        // 处理工具调用相关的Token计算
      });
    }
  });
  return tokenCount;
};

🛠️ 故障排除与调试

常见问题解决方案

问题现象	可能原因	解决方案
子代理路由失败	模型标签格式错误	确保`<CCR-SUBAGENT-MODEL>`标签位于提示词开头
模型不可用	提供商配置错误	检查API密钥和端点配置
响应格式错误	Transformer配置不当	验证模型对应的Transformer设置
Token计算偏差	编码方式不匹配	使用`cl100k_base`编码器进行校准

调试技巧

启用详细日志：在配置中设置"LOG_LEVEL": "debug"查看路由决策过程
使用UI界面：运行ccr ui命令通过图形界面监控路由状态
检查会话缓存：Router会缓存会话使用情况，优化后续路由决策

📊 效果评估与性能对比

成本效益分析

通过子代理路由策略，典型工作流的成本对比：

任务类型	单一模型方案	子代理路由方案	成本节省
代码审查+生成	100% Claude 3.5	30% Claude 3.5 + 70% DeepSeek	65%
多语言文档	100% GPT-4	20% GPT-4 + 80% DeepSeek	72%
数据分析	100% Gemini 2.5	50% Gemini 2.5 + 50% Ollama	45%

响应时间优化

mermaid

🔮 未来展望与扩展能力

自定义路由逻辑

对于更复杂的路由需求，可以使用自定义路由器：

// custom-router.js
module.exports = async function router(req, config) {
  const userMessage = req.body.messages.find((m) => m.role === "user")?.content;
  
  // 根据任务复杂度选择模型
  if (userMessage && userMessage.includes("复杂算法")) {
    return "openrouter,anthropic/claude-3.5-sonnet";
  }
  
  // 根据代码语言选择 specialized 模型
  if (userMessage && userMessage.includes("Rust")) {
    return "deepseek,deepseek-coder";
  }
  
  return null; // 回退到默认路由
};