Интеграция · Codex CLI

Codex CLI в России: агент OpenAI без аккаунта OpenAI

Polza поддерживает Responses API, поэтому Codex подключается напрямую — без промежуточных прокси. Один конфиг, оплата картой РФ, любые модели каталога.

  • Responses API напрямую
  • Без прокси и VPN
  • Карта РФ и СБП
  • Аккаунт OpenAI не нужен
~/.codex/config.toml

model_provider = "polza"

model = "deepseek/deepseek-v4-flash-0731"

model_reasoning_effort = "high"

[model_providers.polza]

base_url = "https://polza.ai/api/v1/"

env_key = "POLZA_API_KEY"

wire_api = "responses"

Так выглядит подключение: ключ, адрес API и модель.

Что такое Codex CLI

Codex CLI — терминальный агент OpenAI для работы с кодом. Запускается в папке проекта, читает и редактирует файлы, выполняет команды и доводит задачу до результата, а не подсказывает по строчке.

От Claude Code отличается в основном характером: он аккуратнее на точечных правках и предсказуемее там, где важно не задеть лишнего. Формат работы тот же — задача словами, дальше агент сам.

Сам агент бесплатный и с открытым кодом. Провайдер моделей задаётся в конфиге, поэтому он не привязан к моделям OpenAI.

Почему Codex CLI не запускается из России

Сам агент ставится одной командой npm. Упирается всё в бэкенд, куда он отправляет запросы.

API OpenAI недоступен

Запросы к серверам OpenAI из России не проходят: агент ставится, но на первой же задаче возвращает ошибку соединения.

Адрес Polza отвечает из РФ напрямую.

Нужен аккаунт OpenAI

Штатная авторизация ведёт в аккаунт с привязкой к региону, и российский IP приводит к отказу.

Авторизация по ключу Polza, аккаунт не нужен.

Картой не оплатить

Тариф OpenAI требует зарубежную карту, российская отклоняется на привязке.

Карта РФ, СБП или счёт для юрлица.

Прокси ломает стриминг

Codex получает ответ потоком. Прослойка обрывает поток посреди генерации — появляется ошибка stream disconnected.

Прямое подключение по Responses API.

Юрлицу не провести оплату

Оплату зарубежному сервису не примет бухгалтерия.

Договор, счёт, УПД и НДС.

Только модели OpenAI

Штатно агент работает с моделями одного вендора, сравнить с Claude или Gemini не выйдет.

Весь каталог из 400 моделей по одному ключу.

Как подключить Codex CLI к Polza

Один конфиг и одна переменная окружения. Нужен Node.js 22 или новее.

Что нужно для запуска

Node.js 22 или новее

Более старые версии не подойдут. Проверяется командой node --version, ставится с сайта проекта.

Ключ Polza

Создаётся в кабинете за минуту. Пополняется картой РФ, через СБП или по счёту для юрлица.

Файл config.toml

Создаётся вручную в каталоге ~/.codex. Именно в нём описывается провайдер, модель и формат обмена.

  1. Шаг 1

    Установите Codex

    Ставится глобально одной командой. Версию Node.js проверьте заранее — требуется 22 или выше.

    Терминал · установка
    $ npm i -g @openai/codex
    
    # требуется Node.js 22+
    $ node --version
  2. Шаг 2

    Создайте файл конфигурации

    Конфиг лежит в ~/.codex/config.toml. На Windows это %USERPROFILE%\.codex\config.toml — каталог, возможно, придётся создать вручную.

    macOS / Linux
    $ mkdir -p ~/.codex
    $ nano ~/.codex/config.toml
  3. Шаг 3

    Опишите провайдера

    Ключевые строки — wire_api со значением responses и адрес со слешем на конце. Без них стриминг обрывается:

    ~/.codex/config.toml
    model_provider = "polza"
    model = "deepseek/deepseek-v4-flash-0731"
    model_reasoning_effort = "high"
    
    [model_providers.polza]
    name     = "Polza.ai"
    base_url = "https://polza.ai/api/v1/"
    env_key  = "POLZA_API_KEY"
    wire_api = "responses"
  4. Шаг 4

    Задайте ключ и запустите

    Ключ Codex читает из переменной окружения, имя которой указано в env_key. Чтобы не вводить каждый раз, пропишите её в профиль оболочки, а на Windows — на уровне пользователя.

    macOS / Linux
    $ export POLZA_API_KEY="ваш-ключ"
    $ codex "разбери проект и напиши тесты"
    Windows · PowerShell
    $ $env:POLZA_API_KEY = "ваш-ключ"
    $ codex "ваш запрос"

Почему здесь важен Responses API

Codex работает не через обычный chat completions, а через Responses API — это другой формат обмена, с потоковой выдачей и состоянием. Polza его поддерживает, поэтому агент подключается напрямую, без прослоек. Именно из-за этого в конфиге обязательны wire_api = responses и адрес со слешем на конце: без них соединение рвётся посреди ответа.

Открыть каталог моделей

Что умеет Codex CLI

Терминальный агент того же жанра, что Claude Code, — задачи ставятся словами, остальное он делает сам.

Автономные задачи

Читает и редактирует файлы, запускает команды, доводит задачу до результата без пошаговых указаний.

Работа с кодовой базой

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

Управление глубиной рассуждения

Параметр model_reasoning_effort задаёт, насколько тщательно модель думает над задачей — и во сколько это обойдётся.

Запуск одной строкой

Задачу можно передать прямо в команде, без интерактивной сессии — удобно для скриптов и хуков.

Любые модели каталога

В конфиге указывается любой ID: Claude, Gemini, Qwen, DeepSeek — не только модели OpenAI.

Кроссплатформенность

macOS, Linux и Windows, конфиг одинаковый, отличается только путь к файлу.

https://polza.ai/api/v1/

Для Codex CLI — обязательно со слешем на конце. Вместе с wire_api = responses это условие рабочего стриминга.

https://polza.ai/api/v1

Для остальных OpenAI-совместимых интеграций — без слеша.

Чем Codex отличается от Claude Code и Gemini CLI

Три терминальных агента, которые решают одну задачу по-разному.

Codex CLI

Работает через Responses API, управляет глубиной рассуждения отдельным параметром. Аккуратен на точечных правках.

Сильнее в длинных автономных задачах по всей кодовой базе. Под него есть отдельная страница.

Проще всех в переключении бэкенда — две переменные окружения. Мультимодальный: принимает изображения и PDF.

Напрямую или через Polza

Codex CLI: Напрямую или через Polza
Из РоссииOpenAI напрямуюCodex через Polza
ОплатаЗарубежная карта, в долларахКарта РФ, СБП, счёт для юрлиц
Доступ к APIЗакрыт, нужны обходные путиРаботает из РФ напрямую
АккаунтОбязателен, есть риск блокировкиНе нужен
ПроксиНужен и ломает стримингНе нужен, Responses API напрямую
Выбор моделейТолько OpenAIClaude, Gemini, Qwen и ещё 400
ДокументыНетДоговор, счёт, УПД, НДС
РасходыВ кабинете OpenAIСтатистика по ключам и моделям

Сколько стоит Codex CLI в России

Сам агент бесплатный и с открытым кодом. Платите только за токены моделей по ценам каталога, в рублях.

Сложные задачи

GPT-5.5 и Qwen 3.7 Max — сильный reasoning и большие кодовые базы, когда глубина важнее цены прогона.

Ежедневная разработка

Claude Sonnet 4.6 и Gemini 3.5 Flash — правки, рефакторинг и code review при разумной цене.

Скрипты и мелкие правки

Qwen 3.6 Flash, GLM 5.1 и Gemini 3.1 Flash Lite — самые дешёвые варианты для автоматизации и простых задач.

Модели, с которых стоит начать

Актуальные цены за 1M токенов — в каталоге моделей.

Если Codex не отвечает

Четыре причины, на которые приходится почти вся переписка с поддержкой.

Model provider not found

Идентификатор в model_provider не совпадает с именем секции. Нужно model_provider = "polza" и [model_providers.polza] — буква в букву.

stream disconnected before completion

Модель отвечает несколько раз, потом обрыв. Проверьте, что указано wire_api = "responses", а base_url заканчивается на /v1/ со слешем.

API-ключ не найден

Ключ читается из переменной, названной в env_key. Задайте её в текущем терминале и пропишите в профиль оболочки, чтобы не вводить заново.

Модель не найдена

ID передаётся как есть. Сверьте написание с каталогом — опечатка ломает запрос.

Для команд и юрлиц

Счёт, УПД и НДС

Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.

Ключ на сотрудника

Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.

Контроль бюджета

Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.

Помощь с переездом

Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.

Вопросы и ответы

Работает ли Codex CLI в России?

Да. Сам агент ставится через npm без ограничений, а запросы идут к API Polza, которое поддерживает Responses API и отвечает из России напрямую.

Нужен ли аккаунт OpenAI?

Нет. Ключ Polza заменяет авторизацию, регистрация у OpenAI не требуется.

Какой base_url указывать?

https://polza.ai/api/v1/ — обязательно со слешем на конце. Это требование Responses API: без слеша соединение обрывается посреди ответа.

Что такое wire_api = responses?

Указание формата обмена. Codex работает через Responses API, а не через обычный chat completions. Если строку не указать, появится ошибка stream disconnected.

Ошибка Model provider not found

Значение model_provider не совпадает с именем секции. Должно быть model_provider = "polza" и [model_providers.polza] — одинаково.

Codex не видит API-ключ

Ключ читается из переменной окружения, имя которой указано в env_key. Проверьте, что переменная задана в текущей сессии терминала, и пропишите её в профиль, чтобы не вводить заново.

Можно ли работать не с моделями OpenAI?

Да, в этом и смысл подключения. В поле model указывается любой ID из каталога — Claude, Gemini, Qwen, Kimi, DeepSeek.

Что нужно установить?

Node.js 22 или новее. Дальше одна команда: npm i -g @openai/codex.

Кто проверял эту инструкцию

Илья Дашкин

Основатель Polza.AI · редакция Polza.AI

Собрал и проверил подключение Codex CLI на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если инструмент обновится и инструкция разойдётся с реальностью — правим страницу.

Обновлено · Как работает редакция · Нашли неточность? Напишите нам

Подключите Codex CLI за пять минут

Один config.toml и переменная окружения — и агент OpenAI работает из России, без аккаунта OpenAI и за рубли.

Остались вопросы? Документация по Codex CLI, поддержка в Telegram или support@polza.ai

Инструкцию проверила редакция Polza.AI, обновлено . Цены и список моделей меняются — актуальные смотрите в каталоге.

Сайт использует cookie.