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

По состоянию на 24 апреля 2026 года некоторые версии Codex могут не позволять выбрать gpt-5.5 напрямую при использовании custom API provider. Это ограничение локального model catalog в Codex. Оно не означает, что endpoint LLMEasy https://www.llmeasy.ru/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_providers.llmeasy]
name = "LLMEasy"
base_url = "https://www.llmeasy.ru/v1"
env_key = "LLMEASY_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[profiles.bt-gpt-5-5]
model = "gpt-5.5"
model_provider = "llmeasy"
model_reasoning_effort = "high"

Пример для Windows:

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

model_catalog_json должен быть локальным абсолютным путем. В TOML double-quoted strings на Windows пишите \ как \\.

Задайте API Key LLMEasy

Задайте переменную окружения в терминале:

export LLMEASY_API_KEY="YOUR_API_KEY"

Чтобы переменная была доступна в каждой новой terminal session, добавьте команду в ~/.zshrc или ~/.bashrc.

Перезапустите и выберите profile

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

codex --profile bt-gpt-5-5

Диагностика

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

model_catalog_json использует локальный абсолютный путь
custom-models.json сохраняет полный model catalog
base_url равен https://www.llmeasy.ru/v1
wire_api равен responses
LLMEASY_API_KEY доступен в той же terminal session, где запускается Codex

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

Documentation Index

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

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

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

Диагностика