Codex 連携

本ページでは、cc-router のアプリ内蔵 Codex 設定エディタを使い、集約済みの仮想モデルへ Codex をワンクリックで接続する手順を説明します。Codex は cc-router の POST /v1/responses エンドポイント経由で、cc-router に設定済みのすべての大規模モデルを呼び出せます。上流が Anthropic と OpenAI のどちらのプロトコルでも、cc-router が自動的に変換し、設定した仮想スロットへルーティングします。

これは cc-router のネイティブな接続方式です。ボタンを 1 回押すだけで ~/.codex/config.toml と ~/.codex/auth.json の両方を書き込みます。サードパーティ製ツールは不要です。Codex CLI と Codex Desktop は同じ ~/.codex 設定を共有するため、一度設定すれば両方で使えます。

代替手段：すでに cc-switch で複数の Codex プロバイダを管理している場合は、Codex 連携（cc-switch）の経路も利用できます。本ページのネイティブ方式はより直接的で、推奨される方法です。

前提条件

クイックスタートに沿って cc-router をインストールし、最低 1 つの仮想モデルをバインド済み
Codex CLI または Codex Desktop のいずれかをインストール済み（両者は ~/.codex 設定を共有）
Claude Desktop 連携とは異なり、Codex 経路はポート 23456 の HTTP のみを使用します。HTTPS や CA 証明書は不要です。

ステップ 1：「接続ガイド → Codex」を開く

cc-router を開き、左メニューの 接続ガイド に切り替え、上部タブで Codex を選択します。

Codex 設定エディタ は ~/.codex/config.toml と ~/.codex/auth.json の 2 つのファイルを同時に表示・編集します。各エディタ右上の「同期済み」バッジは内容がディスクと一致していることを示します。

cc-router 接続ガイドの Codex 設定エディタ

ステップ 2：「cc-router 推奨設定を挿入」をクリック

右上の cc-router 推奨設定を挿入 ボタンをクリックすると、cc-router が下の 2 つのファイルを同時に埋めます：

config.toml：cc-router という名前のカスタム provider と対応する profile を注入
auth.json：cc-router のトークンを書き込み

自動バックアップ：書き込み前に cc-router は元ファイルを *.cc-router.bak（例：config.toml.cc-router.bak）として自動バックアップします。上書きしても元の設定を復元できます。

ステップ 3：それぞれのファイルを保存

各エディタには独立した「保存」ボタンがあります。それぞれをクリックして変更をディスクに書き戻します。生成される内容は次のとおりです：

~/.codex/config.toml：

# cc-router 推奨設定 — cc-router 接続ガイドが生成
# 使い方: codex -p cc-router "あなたの質問"
# 編集後に保存すれば反映され、codex は次回起動時にこのファイルを読み込みます。

[model_providers.cc-router]
name = "cc-router"
base_url = "http://127.0.0.1:23456/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

[profiles.cc-router]
model_provider = "cc-router"
model = "model-sonnet"

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "アプリが自動入力する実トークン"
}

OPENAI_API_KEY に入るのは cc-router のトークンで、Claude Code / Claude Desktop と同じものです。config.toml の env_key = "OPENAI_API_KEY" は、Codex に対し認証ヘッダとして auth.json のこのキーを読むよう指示します。

使い方

設定後、ターミナルで -p により cc-router profile を指定して Codex CLI を起動します：

codex -p cc-router "あなたの質問"

仮想スロットを切り替える

config.toml の profiles.cc-router にある model フィールドがどの仮想スロットを使うかを決めます。必要に応じて次のいずれかに変更してください（保存すると Codex の次回起動時に反映）：

`model` の値	cc-router 仮想スロット	適した用途
`model-opus`	opus スロット	計画、長コンテキスト推論
`model-sonnet`	sonnet スロット	主力のコーディング
`model-haiku`	haiku スロット	ツール呼び出し、軽量タスク

cc-switch 経路との重要な違い：ネイティブ方式は cc-router の仮想スロット名（model-sonnet など）を直接指定します。これは gpt-5.x のエイリアスを要求する cc-switch 経路とは異なり、ネイティブ注入では cc-router が /v1/responses に公開する仮想スロット名を使います。

Codex Desktop は同じ設定を共有

Codex CLI と Codex Desktop は同じ ~/.codex 設定を読むため、上記を設定すれば Desktop でもそのまま使えます。Desktop で以前に公式 OpenAI アカウントへログインしていた場合は、設定を反映させるために Codex Desktop を一度再起動し、モデルセレクタで cc-router profile を選択してください。

LAN 共有

Codex と cc-router が別のマシンにある場合は、config.toml の base_url を cc-router マシンの LAN IP に変更します。末尾の /v1 は必須です：

base_url = "http://192.168.1.50:23456/v1"

IP はご自身のものに置き換え、ポートは cc-router 設定ページ下部の「実際の待ち受けポート」に従ってください。

検証

cc-router メイン画面の左メニューでログ → リクエストログ に切り替え、Codex で対話を 1 回行うと、リクエストが記録され、クライアント 列に Codex CLI または Codex Desktop、仮想モデル 列に対応するスロット、実モデル 列に最終的にルーティングされた上流名が表示されるはずです。

トラブルシューティング

404 Not Found —— base_url の末尾に /v1 が欠けています。cc-router の Responses エンドポイントは /v1/responses にあるため、欠けると handler が見つかりません。http://127.0.0.1:23456/v1 に修正してください。
401 Unauthorized —— cc-router のトークンがローテーションされた可能性があります。本ページに戻り、cc-router 推奨設定を挿入 を再度クリックし、2 つのファイルを保存して最新トークンを書き込みます。
profile が反映されない —— CLI 側で -p cc-router を付け忘れた、または Desktop 側で切り替え後に再起動していません。
model_not_found / 400 model is required —— model フィールドのスペルミスです。ネイティブ経路では cc-router の仮想スロット名（model-opus / model-sonnet / model-haiku）が必須です。
元の設定に戻したい —— cc-router は書き込み前に *.cc-router.bak へ自動バックアップしています。元の名前に戻せば復元できます。

セキュリティに関する注意

OPENAI_API_KEY（cc-router トークン）はアクセス資格情報であり、すべての上流プロバイダを直接呼び出すのと同等です。漏洩させないこと、リポジトリにコミットしないこと。~/.codex/auth.json には平文で保存される点に注意してください。
cc-router のポートは信頼できる LAN 内でのみ公開してください。公開ネットワークへの露出はリスクを自己評価し、リバースプロキシ＋認証層で強化してください。