Как настроить custom Base URL и API Key в расширении Codex для VS Code

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

В расширении Codex для VS Code нет отдельных полей Base URL и API Key. Оно использует те же уровни конфигурации, что и Codex CLI. Нажмите шестерёнку, выберите Codex Settings → Open config.toml и добавьте provider BetterToken в пользовательский файл. Затем выполните Developer: Reload Window, чтобы расширение прочитало новый endpoint, Key и модель.

Если в настройках VS Code нет полей Base URL или API Key, это нормально. Не добавляйте custom endpoint в общие proxy settings VS Code.

Требования

Установлен VS Code
Установлено расширение Codex - OpenAI’s coding agent
У вас есть BetterToken API Key (зарегистрируйтесь и получите ключ)
Вы скопировали доступный model ID из группы ключа GPT в model plaza

Не добавляйте API Key в файлы проекта, AGENTS.md, примеры .env или публичные репозитории. Конфигурация ниже должна храниться только в локальной директории конфигурации Codex.

Способы настройки

Рекомендуется: окно Setup
Ручная настройка

После создания API Key в консоли откроется окно Setup. В нем можно скопировать API Key и Base URL, а затем выбрать способ настройки Codex.

Выберите Codex

В разделе Available tools выберите Codex.

Выберите способ настройки

Доступные варианты:

One-click Bash Configuration: скопируйте команду и выполните ее в локальном терминале. Подходит для быстрой настройки.
CC Switch Integration: импортируйте provider в CC Switch. Подходит, если вы управляете несколькими инструментами.
Manual Configuration: скопируйте API Key и Base URL, затем вручную добавьте их в config.toml.

Перезапустите VS Code

После записи конфигурации перезапустите VS Code или выполните Developer: Reload Window, чтобы расширение Codex заново прочитало локальную конфигурацию.

Найдите config.toml

Нажмите шестерёнку в расширении Codex и выберите Codex Settings → Open config.toml. Также файл можно открыть напрямую:

Система	Файл конфигурации
macOS / Linux	`~/.codex/config.toml`
Windows	`C:\Users\YOUR_USER\.codex\config.toml`
Windows + WSL	`~/.codex/config.toml` внутри WSL

Codex CLI и IDE extension читают одни и те же уровни конфигурации. Если проект открыт через WSL, изменяйте файл внутри WSL, а не отдельный файл в пользовательской директории Windows.

Добавьте provider BetterToken

Добавьте конфигурацию ниже в config.toml. Если в файле уже есть такие же верхнеуровневые поля, объедините конфигурацию и не создавайте несколько model_provider.

model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers]
[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"
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Замените YOUR_API_KEY на ваш BetterToken API Key.

Проверьте ключевые поля

В первую очередь проверьте:

Поле	Значение
`base_url`	`https://www.bettertoken.ai/v1`
`wire_api`	`responses`
`model`	Model ID, скопированный из группы ключа GPT
`experimental_bearer_token`	Ваш BetterToken API Key

Для расширения Codex в VS Code не меняйте auth.json на структуру только с API Key. auth.json хранит официальный login state Codex; сторонний API Key должен находиться в experimental_bearer_token.

Перезапустите VS Code

После редактирования закройте текущую сессию Codex и перезапустите VS Code.Также можно выполнить команду из Command Palette:

Developer: Reload Window

Расширение Codex в VS Code зависит от возможностей приложения Codex: интерфейса расширения, управления сессиями и интеграции с VS Code. Поэтому рекомендуется сохранить официальный login state и при этом отправлять model requests через BetterToken. В этой конфигурации:

Настройка	Что делает
`requires_openai_auth = true`	Сохраняет официальный login state Codex
`experimental_bearer_token = "YOUR_API_KEY"`	Использует BetterToken API Key для model requests
`base_url = "https://www.bettertoken.ai/v1"`	Отправляет model requests на OpenAI-compatible / Responses API endpoint BetterToken

Официальный справочник Codex рекомендует env_key для API Key обычного custom provider. На этой странице используется experimental_bearer_token, потому что сценарий также сохраняет официальный login state Codex. Если вам нужен только Codex CLI без плагинов, Remote Control и официального входа, используйте обычную настройку custom provider в config.toml.

Проверьте, какой config читает расширение

После настройки откройте расширение Codex в VS Code и отправьте короткое тестовое сообщение. Если ответ пришёл нормально, конфигурация работает. Ещё раз откройте config.toml через шестерёнку расширения и убедитесь, что это изменённый вами файл.

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

Симптом	Причина	Решение
Codex CLI работает, а расширение VS Code нет	Расширение запущено в другой среде или использует старое состояние	Откройте фактический config через шестерёнку; для WSL измените файл внутри WSL; выполните Developer: Reload Window
Расширение по-прежнему просит официальный вход	IDE extension Codex требует login на уровне приложения	Завершите официальный вход, затем сохраните `requires_openai_auth = true` и сторонний bearer token
`401` или `403`	Неверный API Key или не заменён `experimental_bearer_token`	Скопируйте Key заново и не заменяйте официальный login в `auth.json`
`404`	В Base URL отсутствует `/v1`	Используйте `https://www.bettertoken.ai/v1`
Model not found	Model ID не входит в группу ключа GPT	Скопируйте актуальный ID из model plaza
Ошибка разбора TOML	Поле или таблица объявлены дважды	Объедините конфигурацию и оставьте одну таблицу `[model_providers.custom]`

Начало работы

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

Подключение AI-платформ

Дополнительно

Как настроить custom Base URL и API Key в расширении Codex для VS Code

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

Требования

Способы настройки

Проверьте, какой config читает расширение

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

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

References

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

​Требования

​Способы настройки

​Почему нужно сохранять официальный login state?

​Проверьте, какой config читает расширение

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

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

​References

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

Требования

Способы настройки

Почему нужно сохранять официальный login state?

Проверьте, какой config читает расширение

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

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

References