Codex Router のモデルが出ない？モデルピッカーを修正

最もよくある「動かない」報告は、外部モデルが Codex モデルピッカーに表示されないことです。ほぼ毎回、原因は次の 3 つのいずれかです：プロバイダーが有効化されていない、認証情報が欠落している、Codex が完全に再起動されていない。このページで正確な修正手順を示します。

なぜカタログは認証情報認識型か

Codex Router は、有効化され、API キーまたは有効な OAuth セッションを持つ外部プロバイダーのモデルだけを含めます。ネイティブ GPT モデルは codex login status が OpenAI ログインを確認した場合のみ含まれます。つまりモデルが「登録済み」でも、プロバイダーを有効化して認証するまでピッカーに出ません。

ステップ 1：プロバイダー状態を確認

./bin/model-router codex providers

対象プロバイダーは SHOW と ready の両方を報告する必要があります：

• SHOW はプロバイダーがカタログに表示されていること。
• ready は認証情報または OAuth セッションが存在すること。

SHOW でなければ有効化：

./bin/model-router codex providers enable deepseek

SHOW だが ready でなければキーを設定するかログインします。プロバイダーごとの正確なコマンドはモデルチュートリアルへ。

ステップ 2：カタログを更新

./bin/model-router codex refresh-catalog
./bin/model-router codex doctor

refresh-catalog は現在のレジストリ、有効化済みプロバイダー、保存済み認証情報からマージカタログを再生成します。

ステップ 3：Codex を完全に再起動

Codex は model_catalog_json を起動時のみ読み込みます。ウィンドウを閉じても再読み込みされません。

1. Codex を完全に終了——macOS は Command-Q、Windows はアプリの Quit コマンドまたはトレイから。
2. Codex を再起動。
3. 新しいタスクを作成。
4. モデルピッカーを開く。

それでも出ない場合は refresh-catalog を再実行し、完全終了・再起動します。

ステップ 4：起動カタログを確認

codex debug models

Codex が起動時に実際に読み込んだカタログが表示されます。ルーティングモデルがここにあるのにピッカーに出ない場合、アプリが終了ではなく一時停止された可能性があります——完全に終了して再起動。ここにもない場合はカタログキャプチャまたはプロバイダー選択の問題なので、ステップ 1–2 を再確認。

ルーティングモデルのサブエージェントが出ない

main を pull してもソースチェックアウトが更新されるだけです。ユーザー単位インストールに適用し、生成されたカスタムエージェントを検証：

./bin/model-router codex update
./bin/model-router codex doctor

doctor は Routed model agents に OK を報告するはずです。そうでなければ：

./bin/model-router codex doctor --fix

次に Codex を完全終了・再起動・新規タスク作成。生成された個人エージェント定義は $CODEX_HOME/agents/（通常 ~/.codex/agents/）に保存されます。

それでも出ない？管理設定を確認

設定ルートには codex-router-managed ブロックが 1 つだけ存在し、4102 ポートのループバックベース URL、生成された /_codex-router/.../v1 パス、$CODEX_HOME/codex-router/merged-models.json カタログを含む必要があります。診断を共有するときは生成パスを脱敏する ./bin/status を使い、完全な管理 URL をイシューに貼り付けないでください。

すべて失敗した場合

doctor --fix を実行し、サポートバンドルを作成し、リポジトリ で脱敏済み出力を添付してイシューを開きます。完全な診断フローはトラブルシューティング概要と doctor ガイドへ。