Codex が API モードで GPT-5.5 を使用できないのはなぜですか？

2026 年 4 月 24 日時点で、一部の Codex バージョンでは、カスタム API プロバイダーの使用時に gpt-5.5 を直接選択できない場合があります。これは Codex のローカルモデルカタログに関する制限です。BetterToken の https://www.bettertoken.ai/v1 エンドポイントが利用できないことを意味するものではありません。ローカルの custom-models.json ファイルを追加すると、Codex が gpt-5.5 を認識できるようになり、~/.codex/config.toml から参照できます。後の Codex バージョンで gpt-5.5 がネイティブにサポートされる場合は、組み込みの Codex 設定を優先してください。

このページで提供する完全な custom-models.json を使用してください。手動でファイルを編集する場合は、既存のモデルエントリと項目を維持し、必要なモデル設定だけを変更してください。

設定手順

カスタムモデル設定ファイルを準備する

カスタムモデル設定のパスは ~/.codex/custom-models.json です。

JSON ファイルをダウンロードする
JSON を手動で編集する

完全なモデルカタログをダウンロードします。custom-models.json をダウンロードするダウンロードしたファイルを Codex の設定ディレクトリに置き、custom-models.json という名前にします。

システム	配置先パス
macOS / Linux	`~/.codex/custom-models.json`
Windows	`C:\Users\YOUR_USER\.codex\custom-models.json`

ダウンロードしたファイルは完全なモデルカタログです。次の手順で Codex 設定から参照します。

すでに ~/.codex/custom-models.json がある場合は、既存のファイルを編集します。gpt-5.5 のエントリだけを残さないでください。手動で編集する場合は、models 配列に gpt-5.5 のエントリが含まれることを確認し、他のモデル設定を維持します。JSON に慣れていない場合は、ダウンロードを使用してください。gpt-5.5 のエントリには、次のような主要項目を含めます。

{
  "slug": "gpt-5.5",
  "display_name": "gpt-5.5",
  "description": "Custom local catalog entry for GPT-5.5 based on gpt-5.4 metadata.",
  "base_instructions": "...",
  "model_messages": {
    "instructions_template": "...",
    "instructions_variables": {
      "personality_default": "",
      "personality_friendly": "...",
      "personality_pragmatic": "..."
    }
  },
  "supports_reasoning_summaries": true,
  "support_verbosity": true,
  "context_window": 272000
}

上のコードブロックは 1 つのモデルエントリの主要な構造だけを示しています。ダウンロードしたファイルまたは既存の完全なモデルカタログを正としてください。

Codex 設定から JSON ファイルを参照する

Codex 設定ファイル ~/.codex/config.toml を開き、次の設定を追加または統合します。macOS / Linux の例：

model_catalog_json = "/Users/YOUR_USER/.codex/custom-models.json"
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers]
[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Windows の例：

model_catalog_json = "C:\\Users\\YOUR_USER\\.codex\\custom-models.json"

model_catalog_json にはローカルの絶対パスを指定する必要があります。Windows の TOML 二重引用符文字列では、\ を \\ と記述します。

Codex を再起動する

設定ファイルを変更した後、現在の Codex プロセスを停止し、新しいターミナルセッションで起動します。

codex

トラブルシューティング

gpt-5.5 が引き続き動作しない場合は、次の項目を順番に確認します。

model_catalog_json にローカルの絶対パスを指定している
custom-models.json に完全なモデルカタログを維持している
base_url が https://www.bettertoken.ai/v1 である
wire_api が responses である
model_provider が [model_providers.custom] 内のプロバイダー ID と一致する

お使いの Codex バージョンがすでに gpt-5.5 をネイティブにサポートしている場合は、model_catalog_json を削除し、通常の Codex 設定ガイドに戻ってください。

Claude Code

Claude Desktop

Codex

Cursor

Cline

モデルの呼び出し

サービスとセキュリティ

コストと Token

基本概念

Codex が API モードで GPT-5.5 を使用できないのはなぜですか？

設定手順

トラブルシューティング

​設定手順

​トラブルシューティング

設定手順

トラブルシューティング