Codex
Один файл настроек обслуживает и Codex CLI, и приложение Codex, и расширение в VS Code.
Настройка
- Установите CLI:
npm install -g @openai/codex. Приложению и расширению CLI ни к чему, им хватает файла из шага 2. - Откройте
~/.codex/config.toml(в Windows%USERPROFILE%\.codex\config.toml) и добавьте:
model = "gpt-6-sol"
model_reasoning_effort = "high"
model_provider = "codexkey"
[model_providers.codexkey]
name = "codexkey"
base_url = "https://api.codexkey.ru/v1"
wire_api = "responses"
requires_openai_auth = true- Положите ключ в
~/.codex/auth.json:
{ "OPENAI_API_KEY": "sk_cdx_YOUR_KEY" }- Запустите
codex. Модель можно выбрать на лету:codex --profile astraилиcodex --model gpt-6.1-sol.
В Codex 0.134.0 и новее профиль хранится в отдельном файле вида ~/.codex/astra.config.toml с теми же ключами верхнего уровня. Codex читает config.toml и накладывает профиль поверх него, поэтому --profile astra берёт настройки из ~/.codex/astra.config.toml. Таблицы [profiles.*] в config.toml новые версии не читают, старый селектор profile = "..." больше не поддерживается, так что оставшиеся записи уберите. До 0.134.0 профили задавались таблицами в config.toml. Провайдер codexkey остаётся в config.toml.
model = "gpt-6-astra"model = "gpt-6-luna"Важно: Адрес в base_url пишется с /v1, а wire_api = "responses" включает формат Responses API.
model_reasoning_effort определяет глубину рассуждений. Чтобы сэкономить, поставьте "medium" или удалите строку. Приложение и расширение читают файл на старте, поэтому после правки перезапускайте их целиком.
Справочник по настройкам
| Настройка | Описание | Пример |
|---|---|---|
model_provider | Провайдер для запросов. Его имя должно совпадать с именем таблицы в model_providers. | "codexkey" |
model | ID модели по умолчанию. | "gpt-6-sol" |
model_reasoning_effort | Глубина рассуждений. | "medium", "high" |
base_url | Адрес API codexkey с /v1. | https://api.codexkey.ru/v1 |
wire_api | Формат запросов: Responses API. | "responses" |
requires_openai_auth | Брать ключ из ~/.codex/auth.json. | true |
Ключ в переменной окружения
Чтобы не хранить ключ в файле, замените requires_openai_auth на env_key и задайте переменную CODEX_KEY:
[model_providers.codexkey]
name = "codexkey"
base_url = "https://api.codexkey.ru/v1"
wire_api = "responses"
env_key = "CODEX_KEY"export CODEX_KEY="sk_cdx_YOUR_KEY"Если что-то не так
Ошибки аутентификации
Загляните в поле OPENAI_API_KEY файла auth.json: ключ начинается с sk_cdx_ и должен быть активен в разделе «API-ключи». После правки перезапустите Codex.
Модель не найдена
Codex передаёт значение model в codexkey без изменений, поэтому оно обязано совпасть с ID из каталога, например gpt-6-sol.
404 или неожиданный ответ
Убедитесь, что base_url заканчивается на /v1, а wire_api равен "responses".