Почему Codex не может использовать GPT-5.5 в API mode?

По состоянию на 24 апреля 2026 года некоторые версии Codex могут не позволять выбрать gpt-5.5 напрямую при использовании custom API provider. Это ограничение локального model catalog в Codex. Оно не означает, что endpoint BetterToken https://www.bettertoken.ai/v1 недоступен. Можно добавить локальный файл custom-models.json, чтобы Codex распознавал gpt-5.5, а затем сослаться на него из ~/.codex/config.toml. Если более новая версия Codex поддерживает gpt-5.5 нативно, предпочитайте встроенную настройку Codex.

Используйте полный custom-models.json, предоставленный на этой странице. Если вы редактируете файл вручную, сохраните существующие model entries и fields, меняя только нужную model configuration.

Шаги настройки

Подготовьте custom model config file

Путь custom model config: ~/.codex/custom-models.json.

Скачать JSON file
Редактировать JSON вручную

Скачайте полный model catalog:Download custom-models.jsonПоместите скачанный файл в директорию конфигурации Codex и назовите его custom-models.json.

Система	Целевой путь
macOS / Linux	`~/.codex/custom-models.json`
Windows	`C:\Users\YOUR_USER\.codex\custom-models.json`

Скачанный файл — полный model catalog. На следующем шаге он подключается из Codex config.

Если у вас уже есть ~/.codex/custom-models.json, редактируйте существующий файл. Не оставляйте только одну запись gpt-5.5.При ручном редактировании убедитесь, что массив models содержит запись gpt-5.5, и сохраните остальные model configs. Если вы не уверены в 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
}

Code block выше показывает только ключевую структуру одной model entry. Используйте скачанный файл или существующий полный model catalog как source of truth.

Сошлитесь на JSON file в Codex config

Откройте Codex config file ~/.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 должен быть локальным абсолютным путем. В TOML double-quoted strings на Windows пишите \ как \\.

Перезапустите Codex

После изменения config file остановите текущий процесс Codex и запустите его в новой terminal session:

codex

Диагностика

Если gpt-5.5 все еще не работает, проверьте по порядку:

model_catalog_json использует локальный абсолютный путь
custom-models.json сохраняет полный model catalog
base_url равен https://www.bettertoken.ai/v1
wire_api равен responses
model_provider совпадает с provider id в [model_providers.custom]

Если ваша версия Codex уже поддерживает gpt-5.5 нативно, удалите model_catalog_json и вернитесь к обычной инструкции Codex.

Claude Code

Claude Desktop

Codex

Cursor

Cline

Вызовы моделей

Надежность сервиса

Стоимость и tokens

Концепции

Почему Codex не может использовать GPT-5.5 в API mode?

Шаги настройки

Диагностика

​Шаги настройки

​Диагностика

Шаги настройки

Диагностика