Codex в России: установка и работа без подписки ChatGPT

Codex в России упирается не в сам инструмент, а в доступ и оплату: войти через аккаунт ChatGPT и оплатить подписку на месте получается не у всех. Выход простой: Codex CLI умеет работать с любым OpenAI-совместимым провайдером, и его можно направить на шлюз. Zukko доступен из России: баланс пополняется по СБП, картой MasterCard или криптовалютой. Ниже установка, конфиг и ошибки, которые встречаются чаще всего.

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

• Терминал (macOS, Linux или Windows) и установленный Codex CLI.
• Ключ fetch_... из кабинета↗ и положительный баланс.
• Файл ~/.codex/config.toml.

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

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

Установку лучше делать по инструкции в README официального репозитория github.com/openai/codex↗: способы установки там обновляются, и мы не хотим закреплять здесь устаревшую команду. После установки проверьте, что команда доступна:

codex --version

Если терминал отвечает «command not found», проблема в PATH, а не в шлюзе: перезапустите терминал или добавьте каталог установки в PATH.

Шаг 2. Ключ в переменную окружения

Положите ключ в переменную окружения. Имя произвольное, ниже ZUKKO_API_KEY:

export ZUKKO_API_KEY="fetch_ваш_ключ"

Чтобы переменная сохранялась, добавьте строку в ~/.zshrc или ~/.bashrc. В PowerShell на Windows:

$env:ZUKKO_API_KEY = "fetch_ваш_ключ"

Эта запись действует до закрытия окна; для постоянного значения используйте переменные среды пользователя в настройках Windows. Не коммитьте ключ в репозиторий и не вставляйте его в config.toml.

Шаг 3. config.toml

Создайте или откройте ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "zukko"

[model_providers.zukko]
name = "Zukko"
base_url = "https://api.zukko.pro/v1"
env_key = "ZUKKO_API_KEY"
wire_api = "responses"

Что здесь важно:

• model_provider указывает на раздел [model_providers.zukko], имя раздела произвольное, но совпадать оно должно.
• base_url с /v1: Codex работает как OpenAI-клиент и сам этот суффикс не добавляет.
• env_key называет переменную окружения, из которой Codex берёт ключ. Само значение в конфиг не пишется.
• wire_api = "responses" включает работу через Responses API; шлюз поддерживает POST /v1/responses.

Одна тонкость из документации Codex: настройки провайдера (model_provider, model_providers) игнорируются, если лежат в проектном .codex/config.toml. Держите их в пользовательском ~/.codex/config.toml.

В документации интеграции с Codex↗ показан и второй рабочий вариант: ключ лежит в ~/.codex/auth.json, а в разделе провайдера стоит requires_openai_auth = true; там же есть готовые установщики для macOS и Windows. Названия ключей конфигурации у самого Codex со временем могут меняться, поэтому при расхождении сверяйтесь с его справкой по конфигурации.

Шаг 4. Первый запуск

В каталоге проекта выполните:

cd ~/projects/my-app
codex

Если интерфейс просит войти через ChatGPT, проверьте, что model_provider = "zukko" стоит в корне файла (до первого раздела в квадратных скобках) и что вы редактируете именно ~/.codex/config.toml. Для разовой задачи без интерактива у Codex есть режим codex exec, список опций смотрите в codex --help.

Какую модель ставить: в примере gpt-6.1-sol (индекс силы 52, 1M контекста, картинки на вход). Для экономии на рутине можно взять gpt-6-sol, для самого сложного claude-opus-5-5. Но учтите: Codex говорит на OpenAI-формате, и для Claude в нём весь вход считается по цене входа без скидки за кэш. Модели GLM, по документации Zukko, в Codex не работают.

Типичные ошибки

Список моделей можно получить так:

curl https://api.zukko.pro/v1/models -H "Authorization: Bearer fetch_ваш_ключ"

Если ключ жив, а Codex всё равно не работает, проверьте запрос в обход него обычным curl на /v1/chat/completions. Это отделяет проблемы ключа и баланса от проблем конфигурации Codex.

Оплата из России

Баланс в долларах, пополнение от $1:

• СБП: в рублях по рыночному курсу, платёжная страница добавляет 8,5% сверху;
• криптовалюта (USDT и др.);
• карты MasterCard: комиссия около 13%, суммы $2-$594.

Пошагово про СБП написано в статье про оплату через СБП↗. Поведение Codex с файлом AGENTS.md разобрано в статье про AGENTS.md↗, а общее сравнение подходов в статье Codex без подписки ChatGPT↗.

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

Можно ли пользоваться Codex в России без подписки ChatGPT?

Да, если направить Codex CLI на OpenAI-совместимый шлюз через config.toml. Подписка в такой схеме не используется, расход идёт с баланса за токены.

Нужны ли дополнительные сетевые настройки?

Шлюз доступен по обычному адресу https://api.zukko.pro. Если запрос не проходит, смотрите код ошибки в таблице выше: чаще всего дело в ключе, адресе или балансе.

Куда писать ключ: в config.toml или в переменную?

В переменную окружения, а в конфиге указывать только её имя через env_key. Так ключ не попадёт в репозиторий и в резервные копии конфигов.

Какую модель выбрать?

Начните с gpt-6.1-sol, оцените расход в разделе «Использование» кабинета и при необходимости смените модель одной строкой в конфиге. Качество проверьте на своих задачах.