VS Code Codex

VS Code Codex использует тот же каталог настроек, что и Codex CLI: ~/.codex/.

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

Что важно понять заранее

• расширение читает ~/.codex/config.toml
• ключ для этого сценария хранится в ~/.codex/auth.json
• provider id должен быть apikey_center
• для Codex зафиксирован base URL https://apikey.center/v1
• для этого сценария нужен requires_openai_auth = true

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

1. Установи расширение Codex и открой его один раз

После установки открой боковую панель Codex хотя бы один раз, чтобы убедиться, что расширение инициализировалось.

2. Найди пользовательскую папку .codex

• macOS / Linux: ~/.codex/
• Windows: %USERPROFILE%\.codex\

Если на macOS папка .codex не видна в Finder:

• нажми Command + Shift + ., чтобы показать скрытые файлы
• или нажми Command + Shift + G и сразу открой ~/.codex

На Windows проще всего вставить %USERPROFILE%\.codex\ прямо в адресную строку Проводника.

3. Сделай backup перед правкой

Для этого сценария обычно достаточно сохранить копии двух файлов:

• ~/.codex/config.toml
• ~/.codex/auth.json

Самый простой вариант:

macOS / Linux:

cp ~/.codex/config.toml ~/.codex/config.toml.backup 2>/dev/null || true
cp ~/.codex/auth.json ~/.codex/auth.json.backup 2>/dev/null || true

Windows PowerShell:

Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.backup" -ErrorAction SilentlyContinue
Copy-Item "$HOME\.codex\auth.json" "$HOME\.codex\auth.json.backup" -ErrorAction SilentlyContinue

Если одного из файлов еще нет, это нормально.

4. Открой общий config.toml

Удобный путь из панели:

Codex Settings -> Open config.toml

Это откроет тот же user-level файл, который использует и CLI.

Ручные пути:

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

5. Убедись, что config.toml выглядит так

model_provider = "apikey_center"
model = "gpt-5.5"

[model_providers.apikey_center]
name = "apikey_center"
base_url = "https://apikey.center/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

Если этот блок уже настроен для CLI, дублировать его не нужно.

Для выбора моделей важен не только model = "...", но и полный provider block. Если в конфиге есть только модель без настроек провайдера, расширение может не показать список моделей.

6. Проверь auth.json

В том же каталоге должен лежать файл:

• macOS / Linux: ~/.codex/auth.json
• Windows: %USERPROFILE%\.codex\auth.json

Содержимое:

{
  "OPENAI_API_KEY": "sk-REPLACE_WITH_YOUR_KEY"
}

Если файл уже существует, для этого сценария лучше полностью заменить его содержимое этим JSON. Старую версию сначала сохрани в backup.

Если вручную переключаешь профили Codex, меняй парой:

• ~/.codex/config.toml
• ~/.codex/auth.json

7. Перезагрузи окно VS Code

После правки конфига выполни:

Command Palette -> Developer: Reload Window

Затем снова открой панель Codex.

8. Проверь рабочую модель

Если вместо gpt-5.5 ты используешь другой model ID, сначала убедись, что он реально доступен через:

GET https://apikey.center/v1/models

Потом обнови значение model = "..." в config.toml и еще раз сделай Reload Window.

Автонастройка

Для VS Code отдельного скрипта автонастройки пока нет.

Позже installer может подготовить общие файлы ~/.codex/config.toml и ~/.codex/auth.json, но саму IDE лучше пока не трогать автоматически. После такого installer-шагa пользователю все равно нужно будет сделать Reload Window.

Verification

• панель Codex открывается без возврата к дефолтному OpenAI URL
• расширение подхватывает модель из ~/.codex/config.toml
• тестовый запрос идет через apikey.center
• при неверном ключе виден auth-error, а не route-error

Rollback

• верни backup ~/.codex/config.toml
• верни backup ~/.codex/auth.json
• или убери model_provider = "apikey_center" и блок [model_providers.apikey_center]
• если менял только модель, верни прежнее значение model = "..."
• перезагрузи окно VS Code

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

Панель Codex открыта, но старые настройки остались

Обычно помогает полный Developer: Reload Window.

Ключ положили в settings.json

Для этого сценария ключ должен лежать в ~/.codex/auth.json, а не в VS Code settings.json.

Имя провайдера не совпадает

Для VS Code Codex должны совпадать model_provider и имя секции [model_providers.apikey_center].

Вернули backup-конфиг, а модели исчезли

Если ты просто переименовал старый .bak в config.toml, этого может быть недостаточно.

Проверь:

• есть ли model_provider = "apikey_center"
• есть ли [model_providers.apikey_center]
• указан ли wire_api = "responses"
• указан ли requires_openai_auth = true
• подходит ли текущий auth.json под этот профиль

Правили .codex/config.toml внутри проекта

Для provider/auth настроек используй user-level каталог ~/.codex/.