Использование ключа в Codex CLI

Настройте собственный провайдер модели в ~/.codex/config.toml с wire_api = responses и выберите модель.

Codex — это агент для программирования от OpenAI (CLI и десктопное приложение). Он поддерживает пользовательских поставщиков моделей: направьте поставщика на OLETOKEN, и он будет использовать ваш ключ и квоту моделей OLETOKEN.

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

Вы создали API-ключ и сохранили полный ключ.
Вы выбрали ID модели в каталоге моделей.
Установлены Node.js и npm.

Настройка

Пользовательского поставщика нужно указывать в ~/.codex/config.toml на уровне пользователя. model_provider и model_providers в проектном .codex/config.toml игнорируются.

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

Поле	Назначение
`model`	ID модели по умолчанию
`model_provider`	Указывает на поставщика, определённого ниже
`base_url`	Адрес, совместимый с OpenAI, включая `/v1` (Codex обращается к `{base_url}/responses`)
`env_key`	Имя переменной окружения, в которой хранится ключ — сам ключ в файле не остаётся
`wire_api`	На сегодня поддерживается только `responses`

Экспортируйте ключ и запустите:

export OLETOKEN_API_KEY="YOUR_API_KEY"   # добавьте в ~/.zshrc или ~/.bashrc, чтобы сохранить его
npm i -g @openai/codex
codex

Диалог Быстрый старт на странице API-ключей позволяет скачать тот же скрипт с уже подставленными вашим ключом, моделью и Base URL: он дописывает недостающее, а если в config.toml уже есть model / model_provider, просто выводит блок для самостоятельного объединения, а не перезаписывает ваш файл.

Решение проблем

Симптом	Причина и решение
401	`OLETOKEN_API_KEY` не экспортирована или содержит неверное значение — `env_key` лишь задаёт имя переменной, ключ должен присутствовать в окружении
404	В `base_url` отсутствует `/v1`
Поставщик игнорируется	Конфигурация находится в проектном `.codex/config.toml`; перенесите её в `~/.codex/config.toml`
Model not found	ID отсутствует на этом сайте; скопируйте его из каталога моделей
Insufficient balance	Сначала пополните счёт

wire_api поддерживает только responses, поэтому Codex отправляет запросы на {base_url}/responses — убедитесь, что ваш Base URL предоставляет эту конечную точку (401 без ключа означает, что маршрут существует).