ДокументацияCodex CLI

Codex CLI

Codex CLI — терминальный coding-агент от OpenAI. Он подключается к Zenvy как к кастомному провайдеру через config.toml и использует Responses API (POST /v1/responses).

Что понадобится

API-ключ Zenvy вида sk-zenvy-... из раздела API-ключи.
Положительный баланс аккаунта.
Установленный Codex CLI.

Быстрый старт

Шаг 1. Установите Codex CLI

~/zenvy · npm

npm install -g @openai/codex

Проверьте установку:

~/zenvy · zsh

codex --version

Шаг 2. Настройте провайдера Zenvy

Откройте (или создайте) файл ~/.codex/config.toml и добавьте:

~/zenvy · toml

model = "gpt-5.2"
model_provider = "zenvy"
model_reasoning_effort = "medium"

[model_providers.zenvy]
name = "Zenvy"
base_url = "https://api.zenvy.su/v1"
env_key = "ZENVY_API_KEY"

env_key — имя переменной окружения с ключом, не сам ключ.
model — любой Zenvy ID из каталога моделей.

Шаг 3. Задайте API-ключ

Codex читает ключ из переменной ZENVY_API_KEY:

~/zenvy · macOS / Linux

export ZENVY_API_KEY="sk-zenvy-..."

Шаг 4. Запустите Codex

~/zenvy · zsh

cd /path/to/your/project
codex

Постоянная настройка

Чтобы не задавать ключ заново в каждом терминале:

~/zenvy · macOS / Linux

echo 'export ZENVY_API_KEY="sk-zenvy-..."' >> ~/.bashrc
source ~/.bashrc

После сохранения откройте новый терминал.

Справочник конфигурации

Параметр	Описание	Пример
`model_provider`	Провайдер для запросов	`"zenvy"`
`model`	Zenvy ID модели	`"gpt-5.2"`
`model_reasoning_effort`	Уровень рассуждений	`"low"`, `"medium"`, `"high"`
`base_url`	Endpoint Zenvy	`"https://api.zenvy.su/v1"`
`env_key`	Имя env-переменной с ключом	`"ZENVY_API_KEY"`

Уровни доверия проектам

Codex поддерживает trust_level на проект — контролирует, может ли агент выполнять команды и редактировать файлы:

~/zenvy · toml

[projects."/path/to/trusted/project"]
trust_level = "trusted"

[projects."/path/to/untrusted/project"]
trust_level = "untrusted"

Выбор модели

Список доступных моделей:

~/zenvy · zsh

curl https://api.zenvy.su/v1/models -H "Authorization: Bearer sk-zenvy-..."

Переопределить модель на один запуск:

~/zenvy · zsh

codex --model "claude-sonnet-4.6"

Для coding-задач выбирайте модели с поддержкой tool calling.

Проверка подключения

~/zenvy · zsh

curl https://api.zenvy.su/v1/responses \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "stream": false,
    "input": "Ответь одним словом: ok"
  }'

Устранение неполадок

Симптом	В чём проблема
`401 authentication_error`	Переменная `ZENVY_API_KEY` не задана или содержит неверный ключ. Нужен ключ Zenvy `sk-zenvy-...`.
`402 billing_error`	На балансе Zenvy нет средств. Пополните баланс в личном кабинете.
`404 model_not_found`	В `model` указан ID, которого нет в Zenvy. Проверьте список через `GET /v1/models`.
`Missing environment variable`	В `env_key` указано имя переменной, но сама переменная не задана в текущем терминале.
`404` на `/v1/responses`	На сервере старая версия Zenvy без Responses API. Обновите и пересоберите приложение.
Ошибка про `wire_api`	В `config.toml` должно быть `wire_api = "responses"`, не `"chat"`.
Агент зависает на tool call	На Windows попробуйте WSL2 или проверьте `trust_level` проекта в конфиге Codex.

Безопасность

Не коммитьте config.toml с ключом в репозиторий — используйте env_key.
Если ключ утёк, удалите его в кабинете Zenvy и создайте новый.