Codex model_catalog_json 設定ガイド

Codex に JSON モデルカタログを指定するキーです。公式設定リファレンスでは起動時に読み込むカタログファイルのパスとされ、Codex のオープンソースコードのソースコメントでは設定するとそのプロセスの内蔵カタログを置き換えるため、/model の候補もこのファイルから来ます。値がパス文字列の任意キーです。

多いのは、カタログにその項目がないか、表示される形で書かれていないケースです。Codex のオープンソースコードのソースコメントによると /model の候補は priority 順で、認証方式と visibility で絞り込まれます。オープンソースコードにある内蔵カタログにも visibility が "hide" の項目があります。次に多いのはファイルを変えたあと再起動していないケースで、このキーは起動時にしか反映されません。model_catalog_url を持つプロバイダーを使っている場合、0.160.0 以降はカタログ外の内蔵モデルも混ざらなくなりました。

最上位は "models" 配列です。Codex のオープンソースコードはファイルを読むときにこの models の一覧を確認しており、同梱の models.json も同じ構造です。配列には少なくとも 1 項目が必要で、空だと起動時に model_catalog_json path ... must contain at least one model、JSON が不正だと failed to parse model_catalog_json path ... as JSON というエラーになります。公式ドキュメントにフィールド表はないので、内蔵ファイルから項目をコピーし、slug、display_name、priority を書き換えるのが確実です。

プロファイルです。公式の高度な設定には、プロファイルファイルでも model_catalog_json を上書きでき、両方で設定するとプロファイルの値が使われると書かれています。~/.codex/profile-name.config.toml の最上位に書いてください。0.134.0 以降、--profile は config.toml の [profiles.profile-name] テーブルを読みません。

明示的なプロバイダーのモデルカタログが正とされるようになりました。2026-10-01 のリリースノートによると、未対応の内蔵モデルが混ざらず、更新失敗後に古い項目を使い回すこともありません。PR #49135 の補足では、カタログの slug は一意かつ空でないことが必須で、メタデータは正確なモデル ID で照合されます。起動時に使えるモデルが 1 つもなければ設定エラーになりますが、model を明示していれば起動できます。

必須ではありません。QCode ドキュメントの Codex 設定にはこの項目がなく、ドキュメントどおり base_url を https://api.qcode.cc/openai、wire_api を "responses" にすれば gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol を呼び出せます。この 3 つの ID は Codex のオープンソースコードにある内蔵カタログにも入っています。/model に選んだモデルだけを並べたい、表示名や並び順を変えたいときにだけ、独自カタログを作ってください。