Skip to main content
Codex CLI и Codex App используют общие config.toml и auth.json для локальных задач. BetterToken API Key передаётся через OpenAI Responses.

​
Codex Desktop third-party API и API-ключ

Для подключения задайте model_provider = "bettertoken", Base URL https://bettertoken.ai/v1 и wire_api = "responses". Полную схему файла смотрите в руководстве по config.toml. Для VS Code используется отдельная конфигурация Codex Extension, а значения provider объясняет справка по model_provider и wire_api.

​
Ключевые параметры

​
Подготовка

​
Установка

​
Найдите файлы и создайте резервные копии

Если задан свой CODEX_HOME, редактируйте config.toml и auth.json в этом каталоге. Иначе используйте ~/.codex в macOS / Linux или %USERPROFILE%\.codex в Windows. CLI и App должны использовать один каталог. В WSL каталог пользователя отдельный. Перед изменениями полностью закройте Codex. Сохраните резервные копии обоих файлов в защищённом месте. Создайте отсутствующие файлы. Заменяйте существующие настройки, не добавляйте повторные ключи или таблицы; сохраните остальные параметры.
Эта настройка переключает вход через ChatGPT на авторизацию по API Key и не сохраняет доступ к официальному аккаунту. Защитите auth.json и резервные копии: не публикуйте их и не добавляйте в репозиторий.

​
Настройка командой

Скрипт Automatic setup от BetterToken записывает конфигурацию provider для Codex. Для него нужен Node.js; если API Key или Model ID не переданы параметрами, скрипт запросит их интерактивно.
После установки сверьте оба файла с ручной конфигурацией ниже и исправьте отличия до запуска Codex.

​
Ручная настройка

​
Измените config.toml

Разместите model_provider, model и cli_auth_credentials_store на верхнем уровне, перед всеми таблицами TOML, а не внутри профиля. ID выбранного провайдера должен совпадать с именем таблицы. Для файловой авторизации удалите env_key и experimental_bearer_token из настроек выбранного провайдера.
В примере используется GPT-6 Astra (gpt-6-astra). Для другой модели скопируйте полный ID из model plaza и замените model. GPT, Kimi и GLM используют одинаковую файловую авторизацию; автоматическая настройка доступна для GPT.

​
Измените auth.json

Файл auth.json находится в том же каталоге, что и config.toml. Если файла auth.json нет, создайте его в этом каталоге. Запишите в него следующий JSON, замените YOUR_API_KEY на свой BetterToken API Key и сохраните файл.

​
Проверка подключения

Сохраните оба файла. Запустите новый сеанс Codex CLI прямо из терминала:
Полностью закройте Codex App, включая фоновые процессы, затем откройте его и создайте новую локальную задачу. Отправьте короткий запрос в каждом используемом клиенте. Нормальный ответ подтверждает подключение этого клиента.

​
Смена модели

Измените model и при необходимости review_model, сохраните файл и полностью перезапустите Codex. Используйте ID из окна Setup или model plaza.

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

При 401, 403 или запросе входа проверьте активный каталог, Key в auth.json, auth_mode = apikey, cli_auth_credentials_store = file и requires_openai_auth = true. При ошибке провайдера или модели проверьте совпадение ID провайдера, https://bettertoken.ai/v1, wire_api = responses и доступность модели. Если изменения не применились, проверьте переопределения конфигурации и убедитесь, что CLI и App используют один CODEX_HOME.

​
Расширенная настройка

​
Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Настройка командой + вручную: доступна готовая команда и полная ручная настройка.
  • Ручная настройка: укажите API Key, Base URL и Model.
  • Не поддерживается: проверенный способ прямого подключения пока отсутствует.

​
Codex Extension

Расширение Codex для VS Code использует тот же config.toml, но для сохранения официального входа нужна другая схема авторизации. См. настройку Codex Extension.

​
Связанные FAQ

​
Официальная документация

​
Технические детали

Codex использует OpenAI Responses. Укажите base_url = "https://bettertoken.ai/v1" и сохраните wire_api = "responses". Codex сам добавляет /responses.