Claude Code Router プロジェクト紹介

プロジェクト概要

Claude Code Routerは、Claude Codeのリクエストを異なるAIモデルにルーティングすることを目的としたオープンソースプロジェクトです。これは、コーディングインフラストラクチャの基盤として機能し、ユーザーがモデルとのインタラクション方法を決定できると同時に、Anthropicからの更新も享受できるようにします。このプロジェクトの核となる目標は、インテリジェントなルーティングとマルチモデル連携を通じて、Claude Codeの使用コストを大幅に削減することです。

プロジェクトの動機

従来のAIプログラミングツールには以下の問題がありました。

• 高コスト：Claudeのようなハイエンドモデルをすべてのタスクに直接使用するとコストが高くなります。
• モデルの限界：単一のモデルでは、すべてのシナリオで最高のパフォーマンスを発揮することはできません。
• リソースの浪費：簡単なタスクにも複雑なモデルを使用すると、リソースの浪費につながります。

Claude Code Routerは、インテリジェントなルーティングによってこれらの問題を解決します。作者は、VSCode CopilotでClaude-4を使用してFlutterの問題を処理した際、3回の会話でファイルが混乱し、ロールバックが必要になったと述べています。一方、claude codeとDeepSeekを組み合わせた場合、3〜4回の会話でタスクを正常に完了でき、コストは1人民元未満でした。

主要な機能

1. デュアルモード動作

• Normal Mode（通常モード）：単一のモデルを使用してすべてのタスクを完了します。
• Router Mode（ルーティングモード）：複数の特化型モデルを連携させて、異なる種類のタスクを完了します。

2. インテリジェントなモデル分担

ルーティングモードでは、システムは4つの異なる特化型モデルを使用します。

• Router Agent（ルーティングディスパッチャ）：qwen2.5-coder-3b

  • リクエストのルーティングとディスパッチを担当します。
  • 高度な知能は不要で、小規模なモデルで十分対応できます。
  • 現在、Alibaba Cloud公式の無料qwen2.5-coder-3bモデルを使用しています。

• Tool Agent（ツール呼び出し器）：qwen-max-0125

  • ツール呼び出しを担当します。
  • 関数呼び出しをサポートしている必要があります。
  • 十分な長さのツール記述（理想的には1754以上）をサポートする必要があります。

• Coder Agent（コード生成器）：deepseek-v3

  • コード生成タスクを専門に担当します。
  • DeepSeekシリーズのモデルを使用します。

• Think Agent（推論モデル）：deepseek-r1

  • 複雑な推論タスクを担当します。
  • DeepSeek R1推論モデルを使用します。

3. コスト最適化

• Alibaba Cloudの無料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のように関数呼び出しをサポートしない推論モデルもサポートします。

注意事項

⚠️ 重要なお知らせ：

• このプロジェクトはテスト段階にあり、大量のトークンを消費する可能性があります。
• タスクの実行が失敗する場合があります。
• プロジェクトに適切なignorePatterns設定を行うことを推奨します。

プロジェクトの意義

Claude Code Routerは、AIプログラミングツールの発展における重要な方向性を示しています。

• コストの民主化：より多くの開発者がAIプログラミングアシスタントを利用できるようにします。
• モデルの多様化：単一のモデルに依存せず、最適なモデルを柔軟に選択できます。
• アーキテクチャの革新：ルーティングと専門化された分担により、全体的な効率を向上させます。

このプロジェクトは、開発者にとって強力なツールを提供し、Claude Codeの強力な機能を維持しつつ、使用コストを大幅に削減することを可能にします。これは、AIプログラミングツールの普及に大きく貢献するものです。