Codex в России: как установить и настроить без VPN

Codex из России запускается, но не по штатному сценарию: вход через аккаунт ChatGPT и оплата подписки российской картой недоступны. Рабочий путь — оставить сам Codex официальным и подменить ему модельного провайдера: в конфиге агента прописывается совместимый с OpenAI эндпоинт, и CLI работает как обычно. Быстрее всего это делается через AI для кода от PurpleSchool: ключ выдаётся сразу, оплата в рублях, VPN не нужен. Ниже — установка Codex CLI, конфиг для macOS, Linux и Windows, подключение расширения в VS Code и Cursor.

Почему Codex в России не работает из коробки

Codex — агент OpenAI для работы с кодом: он читает проект, правит файлы и запускает команды в терминале. Существует в двух видах — консольный Codex CLI и расширение для IDE, причём расширение использует тот же CLI под капотом.

Препятствие не в самом инструменте. Пакет ставится из npm без каких-либо проблем — упирается всё в доступ к моделям. Штатная авторизация Codex идёт через аккаунт ChatGPT, а Россию OpenAI не поддерживает: оплатить подписку российской картой не получится, этот сюжет мы подробно разбирали в статье про оплату OpenAI из России.

Существенно здесь другое: Codex CLI не привязан намертво к серверам OpenAI. В его конфигурационном файле есть секция model_providers, куда прописывается произвольный эндпоинт, совместимый с OpenAI API. На этом и построены все рабочие способы ниже — сам агент остаётся официальным, меняется только адрес, по которому он ходит за моделью.

Способ 1: Codex через AI для кода от PurpleSchool

Самый короткий путь — взять готовый OpenAI-совместимый доступ. AI для кода от PurpleSchool даёт один ключ сразу к двум экосистемам: модели GPT работают в Codex CLI, VS Code, Cursor и Windsurf, модели Claude (Haiku, Sonnet, Opus) — в Claude Code и совместимых клиентах. Баланс токенов общий, оплата — российской картой, зарубежный банк и виртуальные карты не нужны.

Со стороны Codex это выглядит как обычный внешний провайдер: вы добавляете в конфиг один блок, и дальше всё работает штатно — агентный режим, правки файлов, запуск команд. Ни VPN, ни собственного сервера.

Если не хочется править конфиги руками, на сайте есть команда, которая прописывает настройки автоматически:

npx @purpleschool/ai-for-code

Дальше в статье разбираем ручную настройку — она полезна, даже если вы воспользовались автонастройкой: понимая, какие файлы правятся, вы почините конфиг, когда что-то пойдёт не так.

Как установить Codex CLI

Codex CLI ставится глобально через npm, поэтому npm должен быть установлен. Команда одинаковая для macOS, Linux и Windows:

npm install -g @openai/codex

Проверьте, что бинарник встал и доступен в PATH:

codex --version

Если команда отвечает номером версии, установка прошла. Если терминал сообщает, что команда не найдена, значит глобальная папка npm не попала в PATH — это решается на уровне системы и к региональным ограничениям отношения не имеет.

Как задать ключ: macOS, Linux и Windows

Codex читает ключ провайдера из переменной окружения. Для доступа через PurpleSchool переменная называется PURPLESCHOOL_API_KEY.

macOS и Linux

Добавьте строку в конфиг вашей оболочки — ~/.zshrc для zsh или ~/.bashrc для bash:

export PURPLESCHOOL_API_KEY="ваш ключ"

Команда export помечает переменную как экспортируемую, то есть видимую дочерним процессам — именно поэтому запущенный из этой оболочки Codex её увидит. Подробнее о том, как оболочка работает с такими значениями, — в разборе переменных окружения.

После правки файла откройте новый терминал или перечитайте конфиг:

source ~/.zshrc

Windows

В PowerShell ключ сохраняется в пользовательскую переменную окружения, а вторая строка задаёт его для текущей сессии, чтобы не перезапускать терминал прямо сейчас:

[Environment]::SetEnvironmentVariable("PURPLESCHOOL_API_KEY", "ваш ключ", "User")
$env:PURPLESCHOOL_API_KEY="ваш ключ"

Первая команда пишет значение в профиль пользователя — оно переживёт перезагрузку. Вторая действует только до закрытия окна PowerShell.

Как настроить модельного провайдера в config.toml

Основная часть настройки — файл ~/.codex/config.toml (на Windows это $env:USERPROFILE.codex\config.toml). Добавьте в него блок ниже, не удаляя остальные ваши настройки:

model = "<MODEL_NAME>"
model_provider = "purpleschool"

[model_providers.purpleschool]
name = "PurpleSchool OpenAI Proxy"
base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
env_key = "PURPLESCHOOL_API_KEY"
wire_api = "responses"
supports_websockets = false

Разберём поля, потому что именно здесь чаще всего ошибаются:

• model_provider — какой из описанных провайдеров использовать по умолчанию. Значение должно совпадать с именем секции: purpleschool в обоих местах.
• base_url — адрес OpenAI-совместимого эндпоинта, куда пойдут запросы вместо серверов OpenAI.
• env_key — имя переменной окружения с ключом, а не сам ключ. Codex прочитает её при запуске, поэтому секрет не лежит в конфиге открытым текстом.
• wire_api — формат протокола, по которому Codex общается с провайдером.
• <MODEL_NAME> замените на имя доступной модели: в инструкции PurpleSchool в качестве примера указана gpt-5.6-sol.

Затем откройте новый терминал, чтобы Codex подхватил и переменную, и обновлённый конфиг, перейдите в папку проекта и запустите агента:

codex

Как подключить Codex к VS Code и Cursor

Расширение Codex для IDE работает поверх CLI, поэтому шаги выше обязательны и для него: сначала установленный @openai/codex и настроенный config.toml, только потом расширение.

1. Установите официальное расширение Codex из Visual Studio Marketplace — идентификатор openai.chatgpt. В Cursor то же расширение ставится по ссылке cursor:extension/openai.chatgpt.
2. Убедитесь, что PURPLESCHOOL_API_KEY задана, и запустите IDE из терминала, в котором эта переменная доступна. Это неочевидный момент: приложение, запущенное иконкой из меню, может не получить переменные окружения вашей оболочки, и расширение не найдёт ключ.
3. Откройте боковую панель Codex. Если её значка нет, вызовите команду Codex: Open Codex Sidebar через Command Palette.

Windsurf тоже есть в списке поддерживаемых редакторов — пошаговая инструкция под него лежит на странице сервиса.

Что делать, если Codex не запускается

Большинство проблем при такой настройке сводится к трём причинам, и все три проверяются за минуту.

Codex не видит ключ. Переменная задана в файле оболочки, но текущая сессия терминала запущена раньше, чем вы её туда добавили. Откройте новый терминал или выполните source ~/.zshrc. Проверить, что значение на месте, можно так:

echo $PURPLESCHOOL_API_KEY

Пустая строка в ответ означает, что переменная в этой сессии не определена. На Windows аналог — echo $env:PURPLESCHOOL_API_KEY в PowerShell.

Расширение в IDE не видит ключ, а CLI видит. Классический случай запуска IDE не из терминала — см. пункт 2 предыдущего раздела. Закройте редактор полностью и откройте заново из оболочки, где переменная определена.

Запросы всё ещё уходят на серверы OpenAI. Значит, конфиг не применился: либо файл лежит не там (проверьте путь ~/.codex/config.toml), либо model_provider не совпадает с именем секции [model_providers.purpleschool], либо у вас несколько конфигов и правится не тот.

Другие способы запустить Codex из России

Готовый доступ — не единственный вариант, но остальные требуют больше работы.

Собственный обратный прокси. Вы поднимаете сервер в регионе, где OpenAI доступен, направляете на него base_url в config.toml и работаете со своим ключом OpenAI. Механизм полностью аналогичен тому, что мы разбирали для Claude Code, — там есть готовый конфиг nginx и объяснение, чем это надёжнее системного VPN: Claude Code в России без VPN. Минусы — нужен сервер, домен и администрирование, плюс остаётся вопрос оплаты самого аккаунта OpenAI.

Другие OpenAI-совместимые провайдеры. Секция model_providers не привязана к конкретному сервису: туда подставляется любой агрегатор с совместимым API. Перед тем как выбрать такой сервис, проверьте два момента: поддерживает ли он тот формат протокола, который ожидает Codex (значение wire_api в конфиге), и какова его политика хранения логов — через агента проходит ваш исходный код.

Сколько стоит подписка на Codex через PurpleSchool

Тарифы фиксированы в рублях, токены общие для моделей GPT и Claude:

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

Для знакомства с агентом хватит младшего тарифа: он позволит понять, как Codex ведёт себя на вашем проекте, до того как вы решите, нужен ли вам ежедневный объём. Актуальные условия и инструкции для остальных редакторов — на странице AI для кода.