ZvenoAI
Кейсы

Codex CLI

Инструкция по настройке Codex CLI для работы через ZvenoAI API. Используйте Codex CLI из России без VPN с оплатой в рублях.

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

Открыть коммерческую инструкцию Codex CLI + ZvenoAI с актуальными моделями и ценами

Что такое Codex CLI

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

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

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

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

Данные не используются для обучения. ZvenoAI гарантирует, что ваш код и промпты не будут использованы для обучения моделей. Ваши данные обрабатываются только для выполнения запроса и не сохраняются после ответа.

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

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

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

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

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

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

bash npm install -g @openai/codex
bash brew install codex

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:

~/.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"

Строка web_search = "disabled" обязательна. Свежие версии Codex CLI включают встроенный веб-поиск по умолчанию, а эндпоинт /v1/responses ZvenoAI его пока не поддерживает -- без этой строки каждый запрос завершается ошибкой 400.

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:

Model IDПримечание
openai/gpt-5.3-codexСвежая codex-модель, рекомендуем
openai/gpt-5.2-codexПроверенная альтернатива
openai/gpt-5.1-codex-miniДешевле, для простых задач

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

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

  • Ошибка 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.

On this page