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

技術架構

路由模式工作原理

請求接收：Claude Code 發送請求到本地代理伺服器
智能路由：Router Agent 分析請求類型，決定轉發給哪個專門化模型
任務執行：
- 工具呼叫任務 → Tool Agent
- 程式碼生成任務 → Coder Agent
- 複雜推理任務 → Think Agent
結果返回：各模型完成任務後返回結果

關鍵優勢

任務分離：將工具呼叫和編碼任務分離
模型專業化：每個模型專注於自己最擅長的任務
成本控制：根據任務複雜度選擇合適的模型
推理模型支援：支援像 R1 這樣不支援函數呼叫的推理模型

注意事項

⚠️ 重要提醒：

該專案處於測試階段，可能會消耗大量 tokens
可能存在任務執行失敗的情況
建議為專案設置適當的 ignorePatterns 配置

專案意義

Claude Code Router 代表了 AI 編程工具發展的一個重要方向：

成本民主化：讓更多開發者能夠負擔得起 AI 編程助手
模型多樣化：不再依賴單一模型，可以靈活選擇最適合的模型
架構創新：透過路由和專業化分工提升整體效率

該專案為開發者提供了一個強大的工具，能夠在保持 Claude Code 強大功能的同時，大幅降低使用成本，是 AI 編程工具普及化的重要貢獻。

claude-code-router