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 編程工具普及化的重要貢獻。