Как войти в Codex из России: ChatGPT или API-ключ

В Codex есть два штатных способа входа: через аккаунт ChatGPT (codex login) и по API-ключу OpenAI (codex login --with-api-key). Из России оба закрыты: OpenAI не поддерживает Россию, регистрация из неподдерживаемой страны отклоняется, а ключ API нужно оплачивать зарубежной картой. Но входить в Codex не обязательно. Если указать в ~/.codex/config.toml свой модельный провайдер с ключом из переменной окружения, Codex работает без аккаунта OpenAI вообще. Такой ключ с оплатой в рублях даёт AI для кода от PurpleSchool.

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

Какие способы входа есть в Codex

Сохранённый вход Codex хранит в файле ~/.codex/auth.json или в хранилище паролей системы. Консольный Codex и расширение для VS Code используют один и тот же вход: вошли в одном — вошли и в другом.

Почему не получается войти в Codex из России

Регистрация. Чтобы войти через ChatGPT, нужен аккаунт OpenAI. При попытке зарегистрироваться из неподдерживаемой страны OpenAI показывает ошибку о неподдерживаемой стране — и решает это по вашему местонахождению, а не по номеру телефона или почте. России и Беларуси в списке поддерживаемых стран нет. Казахстан, Армения, Грузия, Узбекистан и Кыргызстан в нём есть.

Оплата. Codex входит в тарифы ChatGPT: бесплатный и Go дают его для лёгких задач, полноценная работа начинается с Plus за $20 в месяц. Ключ API пополняется отдельно. И то и другое оплачивается картой, а российские карты не проходят — варианты обхода разобраны в статье Как оплатить OpenAI из России.

Риск блокировки. OpenAI прямо пишет, что доступ к сервисам из стран вне списка может привести к блокировке или заморозке аккаунта. Аккаунт, зарегистрированный через VPN и чужой номер, работает до первой проверки — и вместе с ним пропадает оплаченная подписка.

Вход через аккаунт ChatGPT

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

codex login

Команда откроет браузер, вы подтвердите вход в аккаунт OpenAI, и Codex сохранит сессию. Этот же экран Codex показывает сам при первом запуске, если сохранённого входа нет.

На сервере без браузера есть вход по коду устройства. Сначала его нужно разрешить в настройках безопасности ChatGPT, затем:

codex login --device-auth

Codex покажет код, который вводится в браузере на любом другом устройстве. Запасной вариант по документации — войти на машине с браузером и перенести файл ~/.codex/auth.json на сервер. Обращайтесь с этим файлом как с паролем: по нему можно работать от вашего имени.

Из России этот путь требует VPN и при регистрации, и при каждой работе с Codex, потому что запросы к моделям идут на серверы OpenAI. Облачный Codex — задачи, которые выполняются на стороне OpenAI, — работает только с входом через ChatGPT.

Вход по API-ключу OpenAI

Второй штатный способ — ключ из кабинета разработчика OpenAI. Расход в этом случае списывается по тарифам API, а не из подписки. Ключ передаётся через стандартный ввод, чтобы он не остался в истории команд:

printenv OPENAI_API_KEY | codex login --with-api-key

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

Из России способ упирается в те же барьеры: создать ключ можно только из аккаунта в поддерживаемой стране, а пополнить баланс — зарубежной картой. Запросы с российских адресов к API OpenAI тоже отклоняются.

Как пользоваться Codex без входа в аккаунт OpenAI

В Codex можно описать свой модельный провайдер — любой сервис, совместимый с OpenAI API. Как такой провайдер авторизуется, определяет его настройка в конфиге:

• env_key — Codex берёт ключ провайдера из указанной переменной окружения. Вход в OpenAI не нужен.
• requires_openai_auth = true — провайдер требует вход через ChatGPT или ключ OpenAI. Нам это не подходит.

Поэтому с провайдером на env_key команда codex login не нужна совсем: аккаунт OpenAI, регистрация, номер телефона и зарубежная карта выпадают из схемы.

Настройка с ключом PurpleSchool

1. Оформите тариф на странице AI для кода — оплата российской картой или СБП — и скопируйте ключ в личном кабинете.
2. Сохраните ключ в переменную окружения. На macOS и Linux — строкой в ~/.zshrc или ~/.bashrc:

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

3. Добавьте провайдера в ~/.codex/config.toml, не удаляя остальные настройки:

model = "gpt-5.6-sol"
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

4. Откройте новый терминал, перейдите в папку проекта и запустите codex.

Строка model_provider должна совпадать с именем секции — purpleschool в обоих местах. Иначе Codex останется на провайдере по умолчанию и снова попросит войти. Вместо ручной настройки можно выполнить одну команду, она пропишет всё сама:

npx @purpleschool/ai-for-code

Подробная установка с нуля, настройка на Windows и подключение расширения в VS Code и Cursor — в статье Codex в России: как установить и настроить без VPN. Отдельно под Windows — Как установить Codex на Windows в России.

Как проверить вход и выйти из аккаунта

Посмотреть, каким способом Codex сейчас авторизован:

codex login status

Удалить сохранённый вход — например, если раньше вы входили через ChatGPT с VPN и хотите полностью перейти на своего провайдера:

codex logout

Выход из аккаунта действует и на CLI, и на расширение в редакторе, потому что сохранённый вход у них общий. На работу провайдера с env_key выход не влияет: ключ по-прежнему берётся из переменной окружения.

Частые ошибки при входе в Codex

Ошибка о неподдерживаемой стране при регистрации или входе. Это ограничение OpenAI по региону. Повторные попытки и смена почты не помогут: OpenAI проверяет местонахождение. Решение — не входить в OpenAI вовсе и работать через своего провайдера.

Codex всё равно открывает экран входа. Значит, настройки провайдера не подхватились. Проверьте, что файл называется именно config.toml и лежит в ~/.codex/, что model_provider совпадает с именем секции и что вы запускаете Codex из нового терминала.

Codex пишет, что не нашёл ключ. Переменная окружения не видна в текущей сессии. Выполните echo $PURPLESCHOOL_API_KEY: пустая строка значит, что переменная задана не в том файле оболочки или терминал открыт до её добавления.

Браузер для входа не открывается. Так бывает на сервере или в контейнере. Используйте codex login --device-auth или, если вход идёт через провайдера, не используйте codex login вовсе.

В терминале работает, а расширение в редакторе просит войти. Редактор запущен без переменной окружения с ключом. Полностью закройте его и откройте из терминала, в котором задан PURPLESCHOOL_API_KEY.

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

Нужен ли аккаунт ChatGPT, чтобы пользоваться Codex? Для консольного Codex и расширения в редакторе — нет, если подключён свой провайдер. Аккаунт ChatGPT обязателен только для облачного Codex.

Можно ли зарегистрироваться в Codex с российским номером? Регистрация в OpenAI из России отклоняется по местонахождению, а не по номеру. Отдельной регистрации у Codex нет: он использует аккаунт OpenAI.

Какие модели доступны через PurpleSchool? Модели GPT для Codex и модели Claude для Claude Code и других клиентов, с общим балансом. Название модели указывается в строке model конфига, пример есть в инструкции на странице продукта.

Сколько стоит? Тарифы PurpleSchool фиксированы в рублях: 499 ₽ за 2,5 млн токенов в месяц, 1 199 ₽ за 5,5 млн и 2 499 ₽ за 12,5 млн. Неизрасходованные токены переносятся на следующий месяц.

Итог

Войти в Codex из России штатно нельзя: и вход через ChatGPT, и API-ключ OpenAI упираются в регистрацию, оплату и ограничения по региону. Но вход и не нужен. Опишите в config.toml провайдера с ключом из переменной окружения — например, AI для кода от PurpleSchool с оплатой в рублях, — и Codex в терминале и редакторе заработает без аккаунта OpenAI и без VPN.