Codex Router 対応アプリ — Codex、Cursor、Claude Code など
1 つの Codex Router サービスから、選択・認証済みの同じモデルカタログを複数のコーディングエージェントへ公開できます。プロバイダーキー、フェイルオーバー、Vision Bridge、使用量集計は共有ローカルルーターに残り、各クライアントは接続に必要な最小設定だけを所有します。
対応クライアントターゲット
| クライアント | Target | 統合内容 |
|---|---|---|
| Codex App / CLI | codex | GPT モデルと ChatGPT ログインを保持し、ルートモデルをネイティブピッカーへ統合 |
| DeepSeek Harness | dsh | 監視対象の Harness 設定へ codex-router プロバイダーを追加し、モデルをホットリロード |
| Gemini CLI | gemini | ~/.gemini/.env に管理ブロックを追加し、Gemini 形式のローカルエンドポイントを提供 |
| Cursor Agent / Cursor App | cursor | Agent はローカルアダプター、App BYOK は専用 HTTPS エッジを使用 |
| Claude Code | claude | 非公開 claude-router ランチャーと Anthropic Messages 互換サーフェスを追加 |
| OpenClaw | openclaw | 管理対象 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
各ターゲット名は doctor、status、enable、disable で使えます。1 つを削除しても他クライアントは保持され、最後のクライアントが不要になった時だけ共有サービスが終了します。
opencode、pi、omp、Command Code、Hermes Agent
さらに 5 つのコーディングクライアントは、ユーザー自身が所有する設定ドキュメントにプロバイダーを保持します。Control Center の Harness ページにはクライアントごとの Route トグルがあります。Route をオンにすると可能な範囲で CLI をインストールし、ルーターが所有する 1 つの provider key をそのドキュメントへ書き込みます。オフにすると Codex Router 管理のエントリだけを削除し、共有サービスや他クライアントは変更しません。
| クライアント | ルーターが編集するドキュメント | プロトコル | インストール |
|---|---|---|---|
| opencode | ~/.config/opencode/opencode.json | Responses | opencode-ai |
| pi | ~/.pi/agent/models.json | Responses | @earendil-works/pi-coding-agent |
| omp (oh-my-pi) | ~/.omp/agent/models.yml | Responses | 先に omp を自分で導入(omp.sh、Bun 製) |
| Command Code | ~/.commandcode/providers.json | Anthropic Messages | command-code 1.30.0 以降(古い場合はセットアップ時に更新) |
| Hermes Agent | ~/.hermes/config.yaml | Anthropic 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 upgrade、pi update --self、command-code update、hermes 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 Code は claude-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 自身のログインとネイティブモデルは維持されます。
関連:インストール、仕組み、モデル概要、トラブルシューティング。