Codex CLI на предоплаченном балансе через один блок provider

Codex CLI является консольным агентом для кодинга от OpenAI. В его конфигурации есть настройка model_provider со значением по умолчанию openai, поэтому запросы уходят на собственный интерфейс OpenAI. Эту настройку можно заменить: опишите своего провайдера в config.toml, указав адрес эндпоинта и имя переменной окружения, в которой хранится ключ, и направьте model_provider на него. Команды и способ работы с Codex остаются прежними; меняется только то, кто выставляет счет.

Codex говорит только на одном протоколе, Responses API от OpenAI: в справочнике по его конфигурации сказано, что wire_api поддерживает только значение responses. Поэтому у шлюза в первую очередь нужно проверить наличие /v1/responses, а не только /v1/chat/completions. Здесь есть оба маршрута, и Codex использует первый.

В блоке ниже четыре строки, и API-ключ в файл не записывается. Что значит каждая настройка:

• model_provider выбирает блок по имени его таблицы. Имя вы задаете сами, но openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime и gcp являются встроенными ID Codex, и переопределить их нельзя.
• В base_url указывается https://api.relayswitch.io/v1, с /v1; Codex добавляет к нему /responses.
• env_key содержит имя переменной окружения, в которой хранится ключ, а не сам ключ. Поскольку ключ остается в переменной окружения, файл конфигурации можно безопасно коммитить и синхронизировать.
• У wire_api только одно допустимое значение, responses, и оно же стоит по умолчанию, так что эту строку можно удалить.
• requires_openai_auth по умолчанию равен false, и писать его не нужно: пользовательский провайдер использует ключ из env_key, а не вход в аккаунт OpenAI.

Запишите этот блок в ~/.codex/config.toml. Этот каталог задается переменной окружения CODEX_HOME и по умолчанию равен ~/.codex; провайдер нужно описывать именно в этом файле уровня пользователя. Затем выполните export ключа в терминале, где запускается Codex, и начинайте. Добавьте строку export в конфигурационный файл своего shell, чтобы новые терминалы тоже ее получали.

Перед запуском Codex отправьте один небольшой запрос Responses, чтобы убедиться, что ключ и адрес верны. Опция -i выводит строку статуса и заголовки ответа, включая ID запроса.

Если пришел ответ 200, запустите codex и отправьте первую команду. Этот запрос появится на странице Usage в консоли через несколько секунд, вместе с токенами и стоимостью. Чтобы временно сменить модель, используйте codex --model с нужным ID.

В этой таблице модели GPT из каталога, в USD за миллион токенов, с отдельными ценами на вход, кешированный вход и выход. Codex рассчитан на модели GPT и маршрут Responses, поэтому убедитесь, что ID, который вы пишете в config.toml, отвечает на проверку через curl выше.

Codex на каждом шаге заново отправляет диалог и вывод инструментов. Эти токены оплачиваются по цене кешированного входа, когда попадают в кеш, и ответ сообщает число кешированных токенов; попадут они в кеш или нет, зависит от модели и самого запроса. Отсюда конкретные способы экономить: используйте более дешевую модель для повседневных правок и переходите на более дорогую только для сложных ревью и рефакторинга, начинайте новую сессию после завершения задачи, чтобы контекст не рос бесконечно, и создайте отдельный ключ для Codex с бюджетом в долларах и дневным лимитом расходов. Когда лимит достигнут, шлюз отвечает 402 и останавливается только этот ключ; остальной баланс аккаунта не затрагивается.

Профиль представляет собой файл с именем ~/.codex/<name>.config.toml, в котором записаны только строки, отличающиеся от config.toml; он накладывается поверх него, когда Codex запускается командой codex --profile <name>. Начиная с Codex 0.134.0 таблицы [profiles.<name>] внутри config.toml больше не читаются, а селектор profile = верхнего уровня удален; руководства, написанные до этого, используют старый способ и при копировании не работают. Значение model_reasoning_effort должно соответствовать уровням, которые поддерживает выбранная модель; Codex отправляет его в каждом запросе, а шлюз передает модели как есть.

При работе с пользовательским провайдером меню /model в Codex по-прежнему показывает встроенные модели OpenAI, а не модели вашего провайдера. Выбор любой из них перезапишет активный файл профиля: модель сменится, провайдер нет. Если записанный ID есть в каталоге, Codex работает по цене этой модели; если нет, придет ответ 404. Чтобы сменить модель, используйте --profile или --model.

Статусы с 401 по 404 возвращаются до того, как запрос дошел до модели, а 429, 502 и 503 не несут ответа; ни один из них не оплачивается. Полная таблица по статусам есть на странице OpenAI API. Для кодинга с Claude в терминале используйте Claude Code; оба инструмента работают с одним ключом и балансом, а как создать ключ, описано на странице Claude API ключ.