Codex にカスタムモデルを追加 — user-models.json と汎用プロバイダー

Codex のカスタムモデルとは、独自のエンドポイントを Codex Router の custom プロバイダーと汎用プロバイダー経由で Codex ピッカーに追加することを意味します。他のすべてのプロバイダーは 1 つのアドレスを持ちますが、custom は持ちません——各モデルが独自のエンドポイント、独自の認証、独自のメタデータを指定します。

custom プロバイダーとは

1 つの custom プロバイダーが、無料のコミュニティエンドポイント、友人のセルフホストサーバー、有料 API キーを同時に保持できます。キーが必要なモデルはその行でその旨を明示します。プロバイダーが自動で選択されたり、デフォルトセットに含まれたりすることはありません。保持する内容は誰かが入れたものだからです。

有効化します——費用も要求もありません：

./bin/model-router codex providers enable custom

Windows では同じコマンドで ./model-router.ps1 codex を使います。

認証情報なしの許可リスト境界

認証情報なしで到達するエンドポイントは、レジストリ断片が単独で導入できない唯一のものです。そのアドレスは、匿名プロバイダーとまったく同様に src/model-registry.mjs の許可リストに登録する必要があります。そうしないと、config/custom/ 配下に JSON ファイルを追加するだけで、認証するものがないままインターネット上の任意のホストにプロンプトを送信できてしまいます。

キーを持つエンドポイント、またはループバックに留まるエンドポイントには許可リスト登録は不要です——キーまたはアドレスがすでに境界だからです。これが「便利」と「安全でない」の意図的な線引きです。

汎用プロバイダー

汎用プロバイダーを使うと、レジストリエントリを待たずに OpenAI 互換サービスをプロバイダーとして登録できます。たとえば Perplexity 検索サイドカー：

./bin/model-router codex providers generic add perplexity-search \
  --name "Perplexity Search" \
  --base-url https://api.perplexity.ai \
  --adapter openai-chat
./bin/model-router codex providers generic credential perplexity-search set

credential コマンドはキーを引数として受け付けません。プロンプトで入力を求めます。ディスクリプター、認証情報参照、モデル単位のバインディングはすべてプライベートでアトミックな状態です。

検索サイドカー

検証済みの検索を持たないルーティング済みモデルのために、Codex は明示的な検索サイドカーを使用できます。バインディングは 1 つの正確なルーティング済みモデルと 1 つのプロバイダーを指定し、すでに検索機能を持つモデルには拒否されます：

./bin/model-router codex search-sidecar set PROVIDER/MODEL perplexity-search
./bin/model-router codex search-sidecar status PROVIDER/MODEL

バインディングを変更した後は Codex を完全終了して再起動し、モデルカタログを更新してください。汎用プロバイダーを削除すると、その認証情報と依存するすべてのサイドカーバインディングも削除されます。

キュレーションと検証のコマンド

ディスカバリー、キュレーション、検証は同じ保護されたユーザーモデル状態を基盤とします：

キュレーション済みエントリは user-models.json に保存され、更新を経ても残り、その場で編集でき、キュレーションを再実行して選択を外すと削除できます。

無料カスタムモデルの例

レジストリには無料カスタムの例が 1 つ同梱されています：共有 Hugging Face Inference Endpoint 上の Qwen3.8-27-free-victor です。262,144 トークンのコンテキスト、画像入力、ツール呼び出し、IP あたり毎分約 30 リクエストを提供します。所有者はローンチへの関心が薄れれば廃止すると述べているため、依存先ではなく試すモデルとして扱ってください。

このエンドポイントは認証情報を持ちません。これらの無料ルートは自己責任で使用してください：誰もあなたへのサービス提供に同意しておらず、アクセスは権利ではなく公開された例外であり、予告なく狭められたり、レート制限されたり、撤回されたりする可能性があります。

FAQ

Codex Router の custom プロバイダーとは何ですか？ custom プロバイダーは固定アドレスを持ちません。各モデルが独自のエンドポイント、認証、メタデータを指定するため、1 つのプロバイダーが無料のコミュニティエンドポイント、セルフホストサーバー、有料 API キーを同時に保持できます。

一部のカスタムエンドポイントに許可リストが必要なのはなぜですか？ 認証情報なしで到達するエンドポイントは src/model-registry.mjs の許可リストに登録する必要があります。そうしないと、JSON ファイルを追加するだけで、認証するものがないまま任意のホストにプロンプトを送信できてしまいます。キーを持つエンドポイントやループバックのエンドポイントには許可リスト登録は不要です。

カスタムモデルを検証するにはどうしますか？ ./bin/test-model ‘PROVIDER/MODEL’ —live —yes でリアルタイム（クォータ消費）チェックを行い、その後 Codex を完全終了して再起動しカタログを更新します。

関連：モデル概要、インストール、仕組み、ピッカーのトラブルシューティング。