Codex

Как настроить GPT-6 Astra в API-режиме Codex?

Настройте GPT-6 Astra в API-режиме Codex CLI и Codex App: укажите BetterToken API Key, Base URL, provider и файловую авторизацию, затем проверьте модель.

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

Обновите Codex перед использованием gpt-6-astra.

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

Если задан свой CODEX_HOME, редактируйте config.toml и auth.json в этом каталоге. Иначе используйте ~/.codex в macOS / Linux или %USERPROFILE%\.codex в Windows. CLI и App должны использовать один каталог. В WSL каталог пользователя отдельный.

Перед изменениями полностью закройте Codex. Сохраните резервные копии обоих файлов в защищённом месте. Создайте отсутствующие файлы. Заменяйте существующие настройки, не добавляйте повторные ключи или таблицы; сохраните остальные параметры.

Измените config.toml

Здесь используется пользовательский config.toml. Разместите корневые ключи перед всеми таблицами TOML, не внутри [projects."<path>"]: эта таблица хранит trust_level проекта. ID выбранного provider должен совпадать с именем его таблицы. Для файловой авторизации удалите из выбранного provider поля env_key и experimental_bearer_token.

model_provider = "bettertoken"
model = "gpt-6-astra"
cli_auth_credentials_store = "file"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

В примере используется 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 и сохраните файл.

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Параметры конфигурации

Параметр	Назначение и расположение	Значения по умолчанию и примеры
`model_provider`	Корень пользовательского файла; выбирает ID конфигурации ниже.	По умолчанию `openai`; здесь используется `bettertoken`.
`model`	Корень файла; полный Model ID из model plaza.	Пример: `gpt-6-astra`; замените при необходимости.
`cli_auth_credentials_store`	Корень файла; хранилище данных входа.	Здесь задано `file`: читается `auth.json` в том же каталоге.
`name`	Таблица provider; только отображаемое имя.	`BetterToken` не является Model ID.
`base_url`	Таблица provider; Base URL API модели.	Используйте `https://bettertoken.ai/v1`; Codex добавит `/responses`.
`wire_api`	Таблица provider; протокол запросов.	Сейчас поддерживается только `responses`; это и значение по умолчанию.
`requires_openai_auth`	Таблица provider; авторизация OpenAI и её хранилище.	По умолчанию `false`; здесь `true`. Это не переключатель сохранения файла входа.
`supports_websockets`	Таблица provider; поддержка Responses WebSocket.	По умолчанию `false`; здесь используется HTTP/SSE.
`auth_mode`	В `auth.json`; режим авторизации.	Здесь `apikey`: он заменяет официальную авторизацию ChatGPT.
`OPENAI_API_KEY`	В `auth.json`; ключ для API-авторизации.	Замените `YOUR_API_KEY` на BetterToken API Key.

Файловая авторизация здесь переключает Codex в режим API Key. Для сохранения официального аккаунта используйте отдельную настройку; не смешивайте режимы. Они различаются целью авторизации, а не клиентом CLI, App или Extension.

Дополнительные настройки

Эти три настройки необязательны для подключения. При необходимости добавьте их в существующую таблицу [model_providers.bettertoken], не создавая дубликат.

request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000

Параметр	Назначение и расположение	Значения по умолчанию и примеры
`request_max_retries`	Таблица provider; число повторов HTTP-запроса.	По умолчанию `4`; настройте под своё подключение.
`stream_max_retries`	Таблица provider; повторы подключения после обрыва потока.	По умолчанию `5`; `8` — дополнительное пользовательское значение.
`stream_idle_timeout_ms`	Таблица provider; тайм-аут бездействия потока в миллисекундах.	По умолчанию `300000`; это не общий срок выполнения задачи.

Уровни конфигурации и устаревшие ключи

Не размещайте модель и интенсивность рассуждений внутри [projects."<path>"]. Модель проекта можно задать корневыми ключами в .codex/config.toml доверенного проекта; provider и авторизация остаются в пользовательском файле. Современный именованный profile — файл NAME.config.toml внутри CODEX_HOME, выбираемый командой codex --profile NAME, а не старая таблица [profiles.NAME] или корневой ключ profile.

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

Сохраните оба файла. Запустите новый сеанс Codex CLI прямо из терминала:

codex

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

Устранение ошибок

При 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.