最終更新

Codex Router 対応アプリ — Codex、Cursor、Claude Code など

1 つの Codex Router サービスから、選択・認証済みの同じモデルカタログを複数のコーディングエージェントへ公開できます。プロバイダーキー、フェイルオーバー、Vision Bridge、使用量集計は共有ローカルルーターに残り、各クライアントは接続に必要な最小設定だけを所有します。

対応クライアントターゲット

クライアントTarget統合内容
Codex App / CLIcodexGPT モデルと ChatGPT ログインを保持し、ルートモデルをネイティブピッカーへ統合
DeepSeek Harnessdsh監視対象の Harness 設定へ codex-router プロバイダーを追加し、モデルをホットリロード
Gemini CLIgemini~/.gemini/.env に管理ブロックを追加し、Gemini 形式のローカルエンドポイントを提供
Cursor Agent / Cursor AppcursorAgent はローカルアダプター、App BYOK は専用 HTTPS エッジを使用
Claude Codeclaude非公開 claude-router ランチャーと Anthropic Messages 互換サーフェスを追加
OpenClawopenclaw管理対象 codex-router Responses プロバイダーを公開。Control Center から 1 クリック設定

新規ターゲットを直接インストールするか、既存ルーターへ追加します:

./install.sh --target dsh --auto --providers configured
./bin/model-router gemini enable
./bin/model-router claude enable
./bin/model-router openclaw enable

各ターゲット名は doctorstatusenabledisable で使えます。1 つを削除しても他クライアントは保持され、最後のクライアントが不要になった時だけ共有サービスが終了します。

opencode、pi、omp、Command Code、Hermes Agent

さらに 5 つのコーディングクライアントは、ユーザー自身が所有する設定ドキュメントにプロバイダーを保持します。Control Center の Harness ページにはクライアントごとの Route トグルがあります。Route をオンにすると可能な範囲で CLI をインストールし、ルーターが所有する 1 つの provider key をそのドキュメントへ書き込みます。オフにすると Codex Router 管理のエントリだけを削除し、共有サービスや他クライアントは変更しません。

クライアントルーターが編集するドキュメントプロトコルインストール
opencode~/.config/opencode/opencode.jsonResponsesopencode-ai
pi~/.pi/agent/models.jsonResponses@earendil-works/pi-coding-agent
omp (oh-my-pi)~/.omp/agent/models.ymlResponses先に omp を自分で導入(omp.sh、Bun 製)
Command Code~/.commandcode/providers.jsonAnthropic Messagescommand-code 1.30.0 以降(古い場合はセットアップ時に更新)
Hermes Agent~/.hermes/config.yamlAnthropic Messages先に Hermes を自分で導入

ターミナルでは同じ操作をクライアントごとに 1 コマンドで実行できます:

./bin/control client-setup opencode
./bin/control client-setup pi
./bin/control client-setup omp
./bin/control client-setup commandcode
./bin/control client-setup hermes

./bin/control client-disconnect opencode

これらはターゲットとしてインストールされるのではなく、設定へ公開されるクライアントです。MODEL_ROUTER_TARGET も 2 つ目のサービスも存在しません。他のクライアントと同じルータープレーンを共有するため、プロバイダーの有効化、キーの保存、モデルのキュレーションでまとめて再公開されます。最新化は独立した明示的操作で、./bin/control client-update <id>(または --all)が各クライアント自身の更新コマンド(opencode upgradepi update --selfcommand-code updatehermes update --yes)を実行し、npm install -g は使いません。Homebrew や curl | sh で入れた CLI はその場で更新されます。YAML は行範囲で挿入してコメントや他プロバイダーを保持し、往復できない JSON は整形し直さず拒否され、ベース URL がこのルーター発行でない codex-router プロバイダーは置換も削除もされません。

クライアントごとの重要な違い

DeepSeek Harness は設定を監視するため通常再起動不要です。Gemini CLI は次回起動時に管理環境を読みます。認証を聞かれたら “Use Gemini API key” を選びますが、値は Google キーではなくローカル caller capability です。

Claude Codeclaude-router で起動し、/model から codex_router/anthropic/<provider>/<model> を選択します。ランチャーは生成されたサブエージェントと Claude の既定 Opus/Sonnet/Haiku 階層エイリアスを、そのセッションで選んだルートモデルに固定し、組み込みエイリアスがルーター未提供の Anthropic モデル ID へ戻るのを防ぎます。非 Claude モデルも互換層で公開できますが、Anthropic が gateway として文書化しているのは Claude モデルです。

OpenClaw は選択済みモデルを codex-router/<router-slug> として公開し、既存のエージェント、チャンネル、プラグイン、他プロバイダー、既定モデルを保持します。

Cursor Agent はローカルのままです。製品版 Cursor App の OpenAI BYOK は Cursor バックエンドから送られるため 127.0.0.1 に到達できません。管理するドメイン上の安定した HTTPS ホスト、通常は名前付き Cloudflare Tunnel が必要です。メインルーターポートは公開せず、専用 App エッジだけを使います。

T3 Code と Codex ラッパー

T3 Code はアダプター経由で公式 CLI を駆動します。Codex adapter を使う場合、codex ターゲットを導入し、T3 Code を完全終了・再起動してルートモデルを選ぶだけです。専用 T3 target は不要です。公式 Codex CLI を起動してモデルカタログを読む他の GUI も同じ継承パターンです。

実験的サブスクリプション Agent Bridge

Control Center の Harness ページは、既存の Claude Code、Cursor Agent、Gemini CLI セッションも検出します。Bridge はモデルピッカーとは別で、インストール済み公式クライアントを呼び出し、OAuth トークンをコピーしたり API キーとして再利用したりしません。

./bin/model-router codex agents status
./bin/model-router codex agents probe anthropic
./bin/model-router codex agents probe cursor
./bin/model-router codex agents probe gemini

Bridge prompt は元クライアントのサブスクリプションクォータを消費する場合があります。ファイルシステム/ターミナル能力はまだ公開されず、前面の承認 UI ができるまでは権限要求を既定で拒否します。

Codex 以外でネイティブ GPT を使う

外部クライアントが持つのはローカル caller key で、ChatGPT セッションではありません。DeepSeek Harness、Gemini CLI、OpenClaw などへネイティブ GPT を公開するには Codex でログインし、共有ローカル面を一度だけ明示認可します:

codex login
./bin/model-router codex chatgpt-session enable

./bin/model-router codex chatgpt-session disable で横断認可を取り消しても、Codex 自身のログインとネイティブモデルは維持されます。

関連:インストール仕組みモデル概要トラブルシューティング