Руководство по Codex
Настройка config.toml, выбор между env_key и experimental_bearer_token и ID моделей по тарифам.
После настройки стороннего шлюза в config.toml консольный codex сразу запускает нужную модель, но в Codex Desktop видно только Custom, а в списке моделей пусто. Если пройти по цепочке от конфига к интерфейсу, дело оказывается не в шлюзе.
После настройки стороннего шлюза в ~/.codex/config.toml возникает странное расхождение: в терминале codex -m claude-sonnet-5-5 отвечает без проблем, а стоит открыть Codex Desktop — в верхней строке висит Custom (или Custom High), а в выпадающем меню нет ни одной своей модели.
Первая мысль — десктопная версия не читает config.toml или в файле закралась ошибка. Если пройти по шагам от конфига к интерфейсу, выясняется, что сначала нужно исключить пару локальных ловушек, а дальше в дело вступает фильтрация самого клиента.
Надпись Custom в Codex Desktop не означает, что конфиг не работает. Если model задан в самом верху config.toml, запросы всё равно уходят на этот точный ID модели.
Прежде чем грешить на приложение, проверьте две частые мелочи:
model и model_provider оказались ниже секции [...]В TOML глобальными считаются только те ключи, которые стоят до первого заголовка [model_providers.xxx]. Если дописать model = "claude-sonnet-5-5" в конец файла, параметр попадёт внутрь таблицы провайдера и перестанет быть моделью по умолчанию.
Codex Desktop читает config.toml один раз при старте. На macOS закрытие окна оставляет процесс в памяти, поэтому после правки файла нужен полный выход через Cmd + Q (на Windows — через значок в трее).
Custom: почему такЕсли вынести глобальные ключи наверх и перезапустить приложение через Cmd + Q, тестовый запрос пройдёт успешно и реально попадёт в claude-sonnet-5-5 — хотя на экране по-прежнему будет написано Custom.
При этом терминальный codex с тем же файлом видит и переключает модели свободно. Причина в том, что локальный app-server внутри Desktop честно отдаёт config.toml и model_catalog_json через model/list, а режет их уже внешняя оболочка Electron:
use_hidden_models, available_models, default_model) и убирает всё, что не входит в разрешённый список (см. openai/codex#19694).| Подход | Когда подходит | Компромисс |
|---|---|---|
Задать model вверху config.toml | В Desktop обычно используется одна основная модель | В UI висит Custom; для смены нужна правка файла и Cmd + Q |
| Оставить активный вход в ChatGPT | Нужно снять блокировку UI для режима только по ключу | Требуется вход в аккаунт OpenAI (достаточно Free/Go) |
Использовать codex CLI (-m / --profile) | Модели и провайдеры переключаются часто | Работа в терминале вместо десктопного окна |
Сторонние патчи app.asar | Нужен выбор моделей прямо из меню Desktop | Неофициально; слетает после каждого обновления |
model вверху файла и не смотрите на CustomЕсли вы работаете в основном с одной моделью — например, claude-sonnet-5-5 или gpt-6-2-sol через CodingPass — поставьте model_provider и model выше любых секций [...] в ~/.codex/config.toml:
model_provider = "codingpass"model = "claude-sonnet-5-5" [model_providers.codingpass]name = "CodingPass"base_url = "https://codingpass.ai/v1"env_key = "CODINGPASS_API_KEY"wire_api = "responses"Сделайте полный выход (Cmd + Q) и откройте заново. Метка Custom останется, но запросы пойдут на нужную модель.
Чтобы убрать скрытие для режима только с API-ключом, оставьте в приложении вход в обычный аккаунт ChatGPT, а в config.toml оставьте стороннего провайдера. Сессия снимет фильтр интерфейса, а трафик продолжит идти через ваш шлюз.
-m или --profileВ консольном codex этого фильтра нет. С версии 0.134.0 профили хранятся в отдельных файлах (например, ~/.codex/cp.config.toml):
codex --profile cp -m claude-sonnet-5-5app.asar (как крайний вариант)Утилиты вроде CodexUse меняют флаг use_hidden_models прямо в app.asar, но любое обновление клиента перезаписывает пакет, поэтому на каждый день это неудобно.
Полные примеры config.toml и список доступных моделей смотрите в руководстве по Codex и разделе о квотах и лимитах.
Используйте CodingPass в Codex CLI и Desktop через один config.toml. Укажите base_url codingpass.ai/v1 и работайте с Claude, GPT и открытыми моделями с оплатой по факту.