Подключение Coding Agent

Codex VS Code custom API: API Key и официальный вход

Настройте Codex VS Code custom API через config.toml, Base URL и API Key BetterToken и сохраните официальный вход, плагины и Remote Control в проекте.

Codex VS Code custom API использует общий с Codex CLI/App файл ~/.codex/config.toml. API Key BetterToken можно передать через experimental_bearer_token, сохранив официальный вход, плагины и Remote Control.

Codex VS Code custom API и API Key

Не вставляйте одновременно конфигурации CLI/App и Extension с одинаковым TOML table. Базовая настройка находится в руководстве по Codex CLI/App, поля файла — в FAQ по config.toml, а сохранение официальной авторизации — в отдельной инструкции.

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

Поле	Значение
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

Подготовка

Установите последнюю версию Codex VS Code Extension
Выполните официальный вход в Extension или Codex App
Создайте API Key BetterToken
Скопируйте Model ID из model plaza или окна Setup для ключа

Установка

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

Полностью закройте Codex, затем создайте резервные копии существующих config.toml и auth.json. Обновите существующие настройки provider, не добавляя повторную таблицу provider.

Установите расширение из Marketplace VS Code, затем перезапустите VS Code.

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

Настройка Extension

Отредактируйте ~/.codex/config.toml:

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

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

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

Параметр	Назначение и расположение	Значения по умолчанию и примеры
`model_provider`	Корень пользовательского файла; выбирает ID конфигурации ниже.	По умолчанию `openai`; здесь используется `bettertoken`.
`model`	Корень файла; полный Model ID из model plaza.	Пример: `gpt-6-astra`; замените при необходимости.
`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`. Это не переключатель сохранения файла входа.
`experimental_bearer_token`	Таблица provider; Bearer Key для сторонних запросов.	Укажите BetterToken API Key. Кэш официального входа не перезаписывается. Ключ хранится открытым текстом; OpenAI не рекомендует это поле.
`supports_websockets`	Таблица provider; поддержка Responses WebSocket.	По умолчанию `false`; здесь используется HTTP/SSE.

Сохраните данные официального входа; не заменяйте их JSON с API Key. requires_openai_auth = true использует официальный процесс авторизации; experimental_bearer_token текущего provider передаёт сторонний ключ в запросах к модели. При первом параметре Codex игнорирует env_key, поэтому не заменяйте им Bearer Key напрямую. Не публикуйте файл с ключом.

Другие способы хранения учётных данных описаны в рекомендациях OpenAI по авторизации через переменные окружения и команды. Это отдельные режимы авторизации: не сочетайте таблицу auth внутри provider с env_key, experimental_bearer_token или requires_openai_auth и не подставляйте env_key в этот пример с сохранением официального входа.

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

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

Сохраните файл, выполните Developer: Reload Window в VS Code и снова откройте панель Codex.

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

Создайте новую сессию Extension и отправьте короткую задачу. Ответ от gpt-6-astra при доступных плагинах и Remote Control подтверждает настройку.

Смена модели

Измените model и при необходимости review_model, затем выполните Developer: Reload Window. Используйте Model ID из окна Setup или model plaza.

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

Ошибка	Решение
Extension снова просит вход	Восстановите официальный вход и сохраните `requires_openai_auth = true`.
`401` или `403`	Скопируйте `experimental_bearer_token` заново; не перезаписывайте `auth.json`.
Duplicate table	Удалите второй `[model_providers.bettertoken]` и оставьте один режим авторизации.
Модель не найдена	Замените `gpt-6-astra` на актуальный полный ID.
Конфигурация не применилась	Сохраните файл и выполните Developer: Reload Window.

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

Связанные материалы

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

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

Протокол Responses

Extension отправляет запросы модели на https://bettertoken.ai/v1 через OpenAI Responses.