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

Codex VS Code Extension читает общий файл ~/.codex/config.toml и может использовать custom provider, сохраняя официальный вход Extension. Для такого подключения нужны OpenAI Responses, совместимый Base URL и отдельный bearer token. После изменения файла нужно перезагрузить окно VS Code и создать новую сессию.

Значения для custom provider сверяйте с актуальной инструкцией Codex VS Code. Эта схема не заменяет официальный вход OpenAI и не меняет региональные требования Marketplace, аккаунта или Extension.

Перед началом

Подготовьте:

• актуальный Codex VS Code Extension из официального Marketplace;
• выполненный официальный вход в Extension или Codex App;
• собственный BetterToken API Key;
• текущий Model ID из BetterToken model plaza;
• резервную копию текущего config.toml, если файл уже настроен.

Codex CLI, приложение и IDE Extension читают общий пользовательский файл. Старый custom provider может повлиять сразу на несколько интерфейсов. Перед правкой откройте файл и поймите, какие sections уже существуют.

Если вы ещё не решили, где запускать Codex, сначала откройте сравнение Codex CLI и Desktop App: там отдельно разобраны терминал, приложение, VS Code и различия в авторизации custom provider.

Путь на macOS и Linux:

~/.codex/config.toml

На Windows:

%USERPROFILE%\.codex\config.toml

1. Проверьте официальный вход и подготовьте BetterToken

Для custom provider используйте собственный ключ. Создайте аккаунт BetterToken, прежде чем переходить к настройке provider в VS Code. Создать аккаунт BetterToken

1. Установите Extension, откройте панель Codex и завершите официальный вход.
2. Получите API Key в личном кабинете BetterToken. Не добавляйте custom provider до этого шага: иначе трудно отличить ошибку аккаунта от ошибки API.

После входа отправьте обычный короткий запрос через поддерживаемый официальный режим. Если Extension не открывается или callback авторизации не завершается, сначала устраните эту проблему по официальной документации Codex IDE.

2. Добавьте BetterToken provider

Откройте пользовательский config.toml и добавьте одну конфигурацию provider:

model_provider = "custom"
model = "YOUR_MODEL_ID"
review_model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

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

Замените YOUR_MODEL_ID точным текущим идентификатором, а YOUR_API_KEY — собственным ключом. Файл находится в пользовательском каталоге .codex, но всё равно не добавляйте его в Git, архив проекта или публичный gist.

В этом варианте requires_openai_auth = true сохраняет официальный вход, а experimental_bearer_token используется для запросов к BetterToken. Не записывайте BetterToken API Key в auth.json.

3. Не смешивайте два режима авторизации

Для чистого custom provider в Codex CLI/App документация может использовать env_key и другой режим requires_openai_auth. Для VS Code Extension с официальным входом используется конфигурация выше. В одном TOML-файле должен быть только один table с именем [model_providers.custom].

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

Если ранее настраивали CLI, найдите дубликаты:

grep -n "model_providers.custom\|requires_openai_auth\|env_key\|experimental_bearer_token" ~/.codex/config.toml

Команда показывает только строки конфигурации. Не вставляйте её вывод в issue, если там виден реальный token.

4. Перезагрузите VS Code

Сохраните файл. Откройте Command Palette и выполните:

Developer: Reload Window

Затем снова откройте панель Codex и создайте новую сессию. Старая сессия может сохранить прежний provider или модель.

5. Проверьте запрос

Откройте тестовый каталог и отправьте запрос без изменения файлов:

Ответь одной строкой: CODEX_PROVIDER_OK. Не изменяй файлы и не запускай команды.

Настройка подтверждена, если:

• Extension остаётся в официально авторизованном состоянии;
• ответ приходит без 401, 403 и model not found;
• используется выбранный YOUR_MODEL_ID;
• в BetterToken Dashboard появляется соответствующий запрос со статусом и расходом Token.

Плагины и Remote Control зависят от официального входа и текущей версии Codex. BetterToken покрывает модельный API и не обещает доступность этих функций при любых условиях.

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

Extension снова просит войти

Восстановите официальный вход и проверьте, что для этой схемы осталось requires_openai_auth = true. Не заменяйте auth.json BetterToken-ключом.

401 или 403

Повторно скопируйте experimental_bearer_token из своего Workspace. Проверьте пробелы и кавычки. Не публикуйте файл целиком.

Duplicate table

В TOML нельзя дважды объявлять [model_providers.custom]. Оставьте один provider и один режим авторизации. Если нужны разные варианты, храните отдельные проверяемые конфигурации и переключайте их осознанно.

Модель не найдена

Замените оба значения YOUR_MODEL_ID на точный текущий ID. Старое название из статьи или скриншота не подходит как источник.

Изменения не применились

Уберите конфликтующие старые provider/profile-поля, сохраните файл, выполните Developer: Reload Window и начните новую сессию. Если проблема остаётся, полностью закройте VS Code и проверьте пользовательский файл, который действительно читает Extension.

Текущие поля этой advanced setup схемы могут меняться вместе с Codex. Перед повторной настройкой откройте BetterToken Docs для Codex VS Code и официальный справочник Codex IDE Extension.