Codex config.toml: custom provider, Base URL и API Key

Короткий ответ

Чтобы использовать custom provider в Codex CLI, измените пользовательский файл ~/.codex/config.toml. Задайте model_provider = "custom", добавьте [model_providers.custom], укажите Base URL https://bettertoken.ai/v1 и wire_api = "responses". API Key BetterToken передавайте через env_key, а Model ID копируйте у провайдера GPT.

Найдите правильный файл конфигурации

Среда	Пользовательская конфигурация
macOS / Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`
Windows + WSL	`~/.codex/config.toml` внутри WSL

В расширении Codex для VS Code нажмите шестерёнку и выберите Codex Settings → Open config.toml. CLI и IDE extension используют одни и те же уровни конфигурации.

Provider и authentication settings должны находиться в пользовательском ~/.codex/config.toml. Файл проекта .codex/config.toml подходит для project overrides, но Codex игнорирует в нём model_provider и model_providers. Инструкции проекта храните в AGENTS.md.

Минимальная рабочая конфигурация

Задайте переменную окружения с API Key

macOS, Linux или WSL:

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

Windows PowerShell:

[Environment]::SetEnvironmentVariable("MODEL_PROVIDER_API_KEY", "YOUR_API_KEY", "User")
$env:MODEL_PROVIDER_API_KEY = "YOUR_API_KEY"

Замените YOUR_API_KEY на API Key BetterToken. Для постоянного использования храните переменную в защищённой конфигурации системы, а не в репозитории проекта.

Измените config.toml

model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

model приведён как пример. Скопируйте актуальный Model ID у провайдера GPT в model plaza.

Перезапустите и проверьте

Полностью завершите Codex, откройте новый терминал и выполните:

codex

Отправьте простой запрос. Нормальный ответ подтверждает, что provider, authentication и Model ID применены.

Как связаны основные поля

Поле	Назначение	Значение для BetterToken
`model_provider`	Выбирает provider ID	`"custom"`
`[model_providers.custom]`	Описывает этот provider	Должен совпадать с `model_provider`
`base_url`	Endpoint запросов модели	`https://bettertoken.ai/v1`
`env_key`	Имя переменной с API Key	`MODEL_PROVIDER_API_KEY`
`wire_api`	Протокол provider	`"responses"`
`requires_openai_auth`	Использовать официальную authentication OpenAI	`false` для обычного стороннего API
`model`	Model ID по умолчанию	Актуальный ID у провайдера GPT

Чтобы сохранить официальный login state Codex App, плагины и Remote Control при использовании стороннего API, применяйте отдельную инструкцию по сохранению входа и общей истории, а не этот обычный пример authentication.

Частые ошибки

Симптом	Причина	Решение
Provider не найден	`model_provider` не совпадает с именем таблицы	Используйте `custom` в обоих местах
При запуске отсутствует API Key	Переменная не задана или терминал её ещё не прочитал	Задайте `MODEL_PROVIDER_API_KEY` и откройте новый терминал
`401` или `403`	Неверный Key или смешаны способы authentication	Скопируйте Key заново; проверьте имя `env_key` и `requires_openai_auth = false`
`404`	В Base URL нет `/v1` или выбран неверный протокол	Используйте `https://bettertoken.ai/v1`
Model not found	Model ID недоступен или не входит в провайдер GPT	Скопируйте актуальный ID из model plaza
Изменения не применяются	Неверный уровень, путь или WSL-среда	Измените пользовательский файл в среде, где запущен Codex, затем перезапустите Codex
Ошибка разбора TOML	Дублирующаяся таблица, кавычки или вложенность	Удалите дубликаты `[model_providers.custom]` и проверьте кавычки

Claude Code

Claude Desktop

Codex

Cursor

Cline

OpenCode

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

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

Стоимость и tokens

Концепции

Codex config.toml: custom provider, Base URL и API Key

Короткий ответ

Найдите правильный файл конфигурации

Минимальная рабочая конфигурация

Рекомендуемая полная конфигурация

Как связаны основные поля

Частые ошибки

Связанные документы

References

​Короткий ответ

​Найдите правильный файл конфигурации

​Минимальная рабочая конфигурация

​Рекомендуемая полная конфигурация

​Как связаны основные поля

​Частые ошибки

​Связанные документы

​References

Короткий ответ

Найдите правильный файл конфигурации

Минимальная рабочая конфигурация

Рекомендуемая полная конфигурация

Как связаны основные поля

Частые ошибки

Связанные документы

References