Claude Code Router 项目介绍

项目概述

Claude Code Router 是一个开源项目，旨在将Claude Code请求路由到不同的AI模型，作为编码基础设施的基础，让用户可以决定如何与模型交互，同时享受来自Anthropic的更新。该项目的核心目标是通过智能路由和多模型协作来显著降低使用Claude Code的成本。

项目动机

传统的AI编程工具存在以下问题：

• 成本高昂：直接使用Claude等高端模型进行所有任务成本很高
• 模型局限：单一模型无法在所有场景下都表现最佳
• 资源浪费：简单任务也使用复杂模型，造成资源浪费

Claude Code Router通过智能路由解决了这些问题。作者提到在VSCode Copilot中使用Claude-4处理Flutter问题时，三轮对话就搞乱了文件需要回滚，而使用claude code配合DeepSeek，经过三四轮对话成功完成任务，成本不到1元人民币。

核心特性

1. 双模式运行

• Normal Mode（普通模式）：使用单一模型完成所有任务
• Router Mode（路由模式）：使用多个专门化模型协作完成不同类型的任务

2. 智能模型分工

在路由模式下，系统使用四个不同的专门化模型：

• Router Agent（路由分发器）：qwen2.5-coder-3b

  • 负责请求路由分发
  • 不需要高智能，小模型即可胜任
  • 目前使用阿里云官方免费的qwen2.5-coder-3b模型

• Tool Agent（工具调用器）：qwen-max-0125

  • 负责工具调用
  • 必须支持函数调用
  • 需要支持足够大的工具描述长度（理想情况下大于1754）

• Coder Agent（代码生成器）：deepseek-v3

  • 专门负责代码生成任务
  • 使用DeepSeek系列模型

• Think Agent（推理模型）：deepseek-r1

  • 负责复杂推理任务
  • 使用DeepSeek R1推理模型

3. 成本优化

• 得益于阿里云免费的qwen2.5-coder-3b模型和DeepSeek的KV-Cache技术
• 可以显著降低使用Claude Code的成本
• 通过任务分工避免在简单任务上使用昂贵的模型

安装和配置

1. 安装Claude Code

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

2. 克隆项目

git clone https://github.com/musistudio/claude-code-reverse.git

3. 安装依赖

npm i

4. 配置环境变量

普通模式配置

# 禁用路由器
ENABLE_ROUTER=false
OPENAI_API_KEY=""
OPENAI_BASE_URL=""
OPENAI_MODEL=""

路由模式配置

# 启用路由器
ENABLE_ROUTER=true
export TOOL_AGENT_API_KEY=""
export TOOL_AGENT_BASE_URL=""
export TOOL_AGENT_MODEL="qwen-max-2025-01-25"
export CODER_AGENT_API_KEY=""
export CODER_AGENT_BASE_URL="https://api.deepseek.com"
export CODER_AGENT_MODEL="deepseek-chat"
export THINK_AGENT_API_KEY=""
export THINK_AGENT_BASE_URL="https://api.deepseek.com"
export THINK_AGENT_MODEL="deepseek-reasoner"
export ROUTER_AGENT_API_KEY=""
export ROUTER_AGENT_BASE_URL=""
export ROUTER_AGENT_MODEL="qwen2.5-coder-3b-instruct"

5. 启动服务

node index.mjs

6. 配置Claude Code环境变量

export DISABLE_PROMPT_CACHING=1
export ANTHROPIC_AUTH_TOKEN="test"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
export API_TIMEOUT_MS=600000
claude

技术架构

路由模式工作原理

1. 请求接收：Claude Code发送请求到本地代理服务器
2. 智能路由：Router Agent分析请求类型，决定转发给哪个专门化模型
3. 任务执行：
   • 工具调用任务 → Tool Agent
   • 代码生成任务 → Coder Agent
   • 复杂推理任务 → Think Agent
4. 结果返回：各模型完成任务后返回结果

关键优势

• 任务分离：将工具调用和编码任务分离
• 模型专业化：每个模型专注于自己最擅长的任务
• 成本控制：根据任务复杂度选择合适的模型
• 推理模型支持：支持像R1这样不支持函数调用的推理模型

注意事项

⚠️ 重要提醒：

• 该项目处于测试阶段，可能会消耗大量tokens
• 可能存在任务执行失败的情况
• 建议为项目设置适当的ignorePatterns配置

项目意义

Claude Code Router代表了AI编程工具发展的一个重要方向：

• 成本民主化：让更多开发者能够负担得起AI编程助手
• 模型多样化：不再依赖单一模型，可以灵活选择最适合的模型
• 架构创新：通过路由和专业化分工提升整体效率

该项目为开发者提供了一个强大的工具，能够在保持Claude Code强大功能的同时，大幅降低使用成本，是AI编程工具普及化的重要贡献。