Codex CLI

Codex CLI -- терминальный AI-агент от OpenAI для работы с кодом. Подключите его через ZvenoAI и используйте из России без VPN с оплатой в рублях.

Что такое Codex CLI

Codex CLI -- официальный агент OpenAI с открытым исходным кодом, написанный на Rust. Он работает прямо в терминале: читает и редактирует файлы, выполняет команды, работает с git и понимает контекст всего проекта.

• Работа в терминале -- запускается командой codex, не привязан к конкретному редактору.
• Полный доступ к проекту -- читает файлы, редактирует код, запускает тесты и сборку с вашего разрешения.
• Песочница -- по умолчанию действия ограничены рабочей директорией, а каждая команда за её пределами требует подтверждения.

Зачем подключать через ZvenoAI

ZvenoAI работает как прослойка между Codex CLI и OpenAI API, решая ключевые проблемы доступа.

• Доступ без VPN -- ZvenoAI API доступен из России напрямую. Никаких прокси и обходных решений.
• Оплата в рублях -- пополняйте баланс картой, СБП или по счёту для юрлиц. Подписка ChatGPT и иностранные карты не нужны.
• Один ключ на все модели -- тот же ключ работает в Codex CLI, OpenCode, Cursor и любом OpenAI-совместимом инструменте.
• Контроль расходов -- отслеживайте использование и расходы в реальном времени в дашборде ZvenoAI.

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

Настройка занимает 5 минут. Инструкция проверена на Codex CLI 0.144.

1. Получите API ключ

Зарегистрируйтесь на zveno.ai и создайте API ключ в личном кабинете.

2. Установите Codex CLI

3. Задайте API ключ в переменной окружения

# Откройте профиль оболочки
nano ~/.zshrc  # или ~/.bashrc для Bash

# Добавьте строку:
export ZVENOAI_API_KEY="<ваш-api-ключ-zvenoai>"

# Перезапустите терминал для применения изменений

4. Проверьте ключ

Убедитесь, что ключ работает, до запуска Codex:

curl -s https://api.zveno.ai/v1/models \
  -H "Authorization: Bearer $ZVENOAI_API_KEY" | head -c 200

В ответе должен прийти JSON со списком моделей. Если пришла ошибка 401 -- проверьте, что переменная задана: echo $ZVENOAI_API_KEY.

5. Настройте провайдера ZvenoAI

Создайте или дополните файл ~/.codex/config.toml:

model = "openai/gpt-5.3-codex"
model_provider = "zvenoai"
web_search = "disabled"

[model_providers.zvenoai]
name = "ZvenoAI"
base_url = "https://api.zveno.ai/v1"
env_key = "ZVENOAI_API_KEY"
wire_api = "responses"

6. Запустите сессию

Перейдите в директорию проекта и запустите Codex:

cd /path/to/your/project
codex

Codex прочитает config.toml, возьмёт ключ из ZVENOAI_API_KEY и будет отправлять запросы через ZvenoAI.

Как это работает

1. Responses API -- Codex CLI общается с моделями по протоколу OpenAI Responses API. ZvenoAI поддерживает эндпоинт /v1/responses, поэтому конвертеры и локальные прокси не нужны.
2. Маршрутизация -- ZvenoAI направляет запрос к провайдеру OpenAI и возвращает потоковый ответ.
3. Биллинг в рублях -- использование, включая reasoning-токены, списывается с рублёвого баланса ZvenoAI. Расходы видны в дашборде.

Рекомендуемые модели

Идентификатор модели указывается в поле model файла config.toml в формате vendor/model-name:

Полный список моделей: Каталог моделей

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

• Ошибка 400 web search is not supported -- добавьте web_search = "disabled" на верхний уровень config.toml, как в примере выше.
• wire_api = "chat" is no longer supported -- начиная с осенних версий 2026 года Codex CLI работает только по Responses API. Укажите wire_api = "responses" -- ZvenoAI этот протокол поддерживает.
• Ошибка авторизации (401) -- переменная ZVENOAI_API_KEY не видна в текущей сессии терминала. Выполните echo $ZVENOAI_API_KEY и перезапустите терминал после правки профиля.
• Модель не найдена -- идентификатор указывается в формате vendor/model-name, например openai/gpt-5.3-codex. Список доступных идентификаторов: zveno.ai/models.