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

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

- Responses API напрямую
- Без прокси и VPN
- Карта РФ и СБП
- Аккаунт OpenAI не нужен

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. Установите Codex

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

Терминал · установка:

```
$ npm i -g @openai/codex

# требуется Node.js 22+
$ node --version
```

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

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

macOS / Linux:

```
$ mkdir -p ~/.codex
$ nano ~/.codex/config.toml
```

### 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. Задайте ключ и запустите

Ключ 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, управляет глубиной рассуждения отдельным параметром. Аккуратен на точечных правках.
- **Claude Code.** Сильнее в длинных автономных задачах по всей кодовой базе. Под него есть отдельная страница.
- **Gemini CLI.** Проще всех в переключении бэкенда — две переменные окружения. Мультимодальный: принимает изображения и PDF.

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

| Из России | OpenAI напрямую | Codex через Polza |
| --- | --- | --- |
| Оплата | Зарубежная карта, в долларах | Карта РФ, СБП, счёт для юрлиц |
| Доступ к API | Закрыт, нужны обходные пути | Работает из РФ напрямую |
| Аккаунт | Обязателен, есть риск блокировки | Не нужен |
| Прокси | Нужен и ломает стриминг | Не нужен, Responses API напрямую |
| Выбор моделей | Только OpenAI | Claude, 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 — самые дешёвые варианты для автоматизации и простых задач.

- [openai/gpt-5.5](https://polza.ai/models/openai/gpt-5.5.md) — сильнейший reasoning и генерация кода
- [anthropic/claude-sonnet-4.6](https://polza.ai/models/anthropic/claude-sonnet-4.6.md) — баланс цены и качества
- [google/gemini-3.5-flash](https://polza.ai/models/google/gemini-3.5-flash.md) — рефакторинг и code review
- [qwen/qwen3.7-max](https://polza.ai/models/qwen/qwen3.7-max.md) — сложная логика и большие кодовые базы
- [moonshotai/kimi-k2.6](https://polza.ai/models/moonshotai/kimi-k2.6.md) — фронтенд и UI
- [google/gemini-3.1-flash-lite](https://polza.ai/models/google/gemini-3.1-flash-lite.md) — самая дешёвая, простые правки

## Если 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 передаётся как есть. Сверьте написание с каталогом — опечатка ломает запрос.

## Частые вопросы

### Работает ли 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.

## Читать дальше

- [API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей](https://polza.ai/blog/api-neyrosetei.md)
- [Российский API нейросетей без VPN](https://polza.ai/blog/rossiyskiy-api-dlya-neyrosetey-bez-vpn-polnyy-gayd-2026.md)
- [Claude Sonnet 5: обзор модели — цены и бенчмарки](https://polza.ai/blog/claude-sonnet-5.md)

## Ссылки

- Документация: https://polza.ai/docs/integracii/codex
- Страница: https://polza.ai/integrations/codex
- Обновлено: 2026-09-26