Claude Code Routerは、複数のエージェントを一つのローカル入口に集める

CCRはエージェントの前に置くローカルゲートウェイ

Claude Code Router（CCR）は、コーディングエージェント向けのローカルモデルゲートウェイとコントロールプレーンです。Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy、互換APIクライアントを、選択したプロバイダーへつなぐ一つのローカル入口として扱います。プロジェクトはTypeScriptで書かれ、メタデータ上はアーカイブされていません。

対応プロトコルはOpenAI ChatとResponses、Anthropic Messages、Gemini Generate ContentとInteractions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、Bailian、カスタム互換プロバイダーです。エージェント側を交換せずに接続先を変えられることが狙いですが、互換性は名前の一致だけでは決まりません。各プロバイダーのツール、ストリーミング、モデル名の扱いを個別に確認する必要があります。

ルートを決める条件と失敗時の行動

READMEはCCRの用途として、エージェントとプロバイダーの設定を一か所で管理すること、ワークフローを変えずにモデルを切り替えること、リトライ、資格情報プール、キーのローテーション、順序付きフォールバックで要求を継続することを挙げています。ルーティング層はヘッダーと本文の条件、プレフィックス、書き換えにも対応すると説明されています。

フォールバックは障害を隠す魔法ではありません。別モデルへ切り替わった時に、出力形式、ツール呼び出し、費用、入力の送信先が変わる可能性があります。CCRは解決されたルート、レイテンシ、トークン使用量、費用見積もり、アカウント状態をログで見せるため、まず通常時と失敗時の両方を記録し、期待したプロバイダーへ到達したかを確認する使い方が合います。

Fusion、Web検索、MCPを既存モデルへ足す

CCRは、既存モデルにFusion vision、Web検索、MCPツール、ToolHubの機能を追加できるとREADMEで説明しています。単にモデルを交換するだけでなく、モデルの前後にツールや機能を組み合わせる設計です。リクエストログには、選択されたモデル、プロバイダー、トークン、エラーの情報が含まれます。

拡張機能が増えるほど、どの処理がモデルの応答で、どの処理がCCRや外部ツールの応答なのかを分けて追う必要があります。READMEはFusionやToolHubの内部実装、権限の粒度、Web検索結果の保存を詳しく説明していません。MCPサーバーや検索機能を業務データと組み合わせる場合は、接続先、認証情報、送信される入力をツールごとに棚卸ししてください。

デスクトップ版で3456と3458を使い分ける

推奨される導入方法はmacOS、Windows、Linuxのデスクトップアプリです。READMEの手順は、アプリを取得し、Providersで組み込みプリセットまたはカスタムエンドポイントを追加し、APIキー、プロトコル、モデルを保存します。その後Serverを開始すると、モデルゲートウェイは既定でhttp://127.0.0.1:3456を待ち受けます。Agent Configでエージェントとモデルを選び、Logsで解決された経路と状態を確認します。

具体的なリリースにはWindows、Linux、macOS Apple Silicon、macOS Intel向けの成果物があります。ローカル管理UIは別ポートの3458として説明され、ゲートウェイは3456のままです。二つのポートを外部へ公開する前に、バインド先、認証、ファイアウォール、ログの閲覧権限を確認してください。READMEのクイックスタートはローカル利用を中心にしており、インターネット越しの公開設定を保証するものではありません。

CLIとDockerは便利さと境界の交換

CLI版はNode.js 22以上が必要で、npm install -g @musistudio/claude-code-routerの後にccr uiを実行します。Electronを使わず、ブラウザの管理UIを3458で開き、モデルゲートウェイは3456で動きます。サービスモード、認証、プロファイルの操作はREADMEがCLIリファレンスへ案内しています。

Dockerではdocker compose up -d --buildを使い、管理UIとゲートウェイの経路を起動します。READMEはCCRをリモートへ公開する前にDocker展開ガイドを読むよう求めています。コンテナを動かせたことは、秘密情報の保護や外部公開の安全性を示しません。ボリューム、環境変数、ネットワーク、プロバイダーのキー、管理UIへのアクセスを自分の構成で点検してください。

プロファイルとAgentClawが増やす管理対象

CCRでは、エージェントごとにモデル上書き、スコープ、環境設定、CLIやアプリの起動入口、複数インスタンスのワークフローを含むプロファイルを持てます。プロバイダーは組み込みプリセットまたはカスタムエンドポイントで、プロトコルの確認、モデル発見、接続チェック、資格情報プールを扱います。設定を一つに集約する分、誰がどのプロファイルを変更できるかが管理上の論点になります。

READMEにはAgentClawとして、Weixin iLink、WeCom、Slack、Discord、Telegram、LINE、Feishu、DingTalkなどのメッセージング基盤を介してエージェントの通信を中継する機能も記載されています。これはローカルのコーディング環境から外へ出る別経路です。ボットの権限、メッセージ履歴、添付ファイル、外部サービスのアカウントを、通常のモデル経路とは分けて確認してください。

MITライセンスとREADMEが残す未確認点

ソースからデスクトップアプリを作る場合、Node.js 22以上、npm ci、macOS用のbuild:app:mac、Windows用のbuild:app:winがREADMEに示されています。better-sqlite3のネイティブElectronモジュールのため、WindowsパッケージングはWindows x64で行う必要があると説明されています。リリースワークフローはvタグを起点にmacOSとWindowsの成果物をビルドします。

ライセンスはMITで、利用、変更、配布などが許可される一方、保証は提供しないとLICENSEは定めています。メタデータは36,941スター、3,099フォーク、1,096件のオープンIssue、最新リリースv3.0.22を示します。READMEにはセキュリティ監査や運用保証が記載されていません。導入の合否は人気ではなく、ルーティング記録、キー管理、外部公開の有無、フォールバック時の検証で決めるべきです。

編集部の結論

CCRは、Claude CodeやCodexなど複数のエージェントを使い、プロバイダーやモデルの切り替えをクライアントごとに設定したくない開発者に向きます。導入前には、APIキーを保存する場所、ログに含まれる入力情報、フォールバック時の費用、3456と3458の公開範囲を確認してください。READMEはセキュリティ監査や保証を示していないため、リモート公開は別途審査が必要です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes