Короткий ответ
Пользоваться Codex в России можно. Codex CLI ставится через npm или Homebrew, а работать ему нужен доступ к моделям OpenAI. Официальный путь — вход через аккаунт ChatGPT или оплата API OpenAI — из России закрыт: страна не входит в список поддерживаемых OpenAI. Но Codex умеет работать через сторонний API-шлюз: в файле ~/.codex/config.toml указывается адрес шлюза, а ключ — в переменной OPENAI_API_KEY. Ниже — установка, готовая конфигурация для TeamoRouter, выбор модели, первый запуск и разбор ошибок, которые встречаются чаще всего. Оплата — в рублях или в USDT.
Что такое Codex
Codex — AI-агент для программирования от OpenAI. Главная форма — Codex CLI, программа для терминала: она читает ваш проект, запускает команды, правит код и проверяет результат. Есть также настольное приложение и расширения для редакторов; всё, что ниже сказано про ключ и конфигурацию, относится и к ним — для приложения есть отдельная инструкция.
Работает Codex на моделях OpenAI. Сейчас это линейка GPT-6: Sol по умолчанию, Luna для дешёвых задач, Astra для самых сложных.
Что не работает из России и почему
| Шаг | Официальный путь | Что происходит из России |
|---|---|---|
| Установить Codex CLI | npm install -g @openai/codex |
Работает: пакет лежит в публичном реестре npm |
| Войти через ChatGPT | Аккаунт ChatGPT с подпиской Plus / Pro | Россия не входит в список поддерживаемых стран OpenAI, регистрация и оплата подписки недоступны |
| Работать по ключу OpenAI API | Ключ из платформы OpenAI, оплата картой | Карты российских банков не принимаются |
| Обращаться к моделям | Серверы OpenAI | Без аккаунта и оплаты — нечем авторизоваться |
Узкое место — аккаунт и оплата, а не программа. Codex официально поддерживает собственных провайдеров моделей: в config.toml описывается адрес API и имя переменной с ключом. TeamoRouter — такой провайдер: вы пополняете баланс в рублях, получаете ключ, и Codex ходит к моделям GPT-6 через api.teamorouter.com. VPN для этого не нужен.
Шаг 1. Установка
Нужен Node.js — рекомендуем актуальную LTS-версию 22 с nodejs.org. Проверка: node --version.
Установите Codex CLI:
npm install -g @openai/codex
На macOS можно и через Homebrew: brew install codex.
Проверьте версию:
codex --version
Ответ вида codex-cli 0.158.0 означает, что всё установлено. Полная инструкция по шагам — в руководстве по Codex CLI.
Шаг 2. Конфигурация и ключ
Получите ключ
Зарегистрируйтесь на TeamoRouter, пополните баланс (см. раздел об оплате ниже) и создайте API-ключ в консоли.
Создайте config.toml
macOS и Linux — выполните в терминале весь блок целиком:
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Windows (PowerShell):
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8
Что означает каждая строка:
model_provider = "teamorouter"— использовать провайдера, описанного ниже, а не серверы OpenAI. Без этой строки остальная конфигурация не действует.model— модель по умолчанию.base_url— адрес API, с/v1на конце (у Claude Code, наоборот, без него — не перепутайте).env_key— из какой переменной окружения брать ключ.wire_api = "responses"— протокол, на котором работает текущий Codex.
Задайте ключ
macOS:
echo 'export OPENAI_API_KEY="ваш ключ TeamoRouter"' >> ~/.zshrc
source ~/.zshrc
Linux — то же самое, но в ~/.bashrc.
Windows (PowerShell):
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "ваш ключ TeamoRouter", "User")
После этого закройте окно PowerShell и откройте новое.
Шаг 3. Какую модель выбрать
| Модель | ID | Для чего |
|---|---|---|
| GPT-6 Sol | gpt-6-sol |
По умолчанию: повседневный код, рефакторинг, ревью |
| GPT-6 Luna | gpt-6-luna |
Массовые и простые задачи: тесты, docstring, мелкие правки — в разы дешевле |
| GPT-6 Astra | gpt-6-astra |
Самые сложные задачи; самая дорогая |
Модель по умолчанию задаётся строкой model в config.toml, а переключиться внутри сессии можно командой /model. Подробнее о моделях — в статьях про GPT-6 Sol и GPT-6 Luna.
Шаг 4. Первый запуск
Перейдите в папку проекта и запустите Codex:
cd ~/projects/my-app
codex
Что сделать в первые десять минут:
- Попросите описать проект — «кратко опиши структуру этого репозитория». Если ответ пришёл, подключение работает.
- Выполните
/init. Codex создаст файлAGENTS.mdс описанием проекта, который будет читать в каждой сессии. Допишите туда команды сборки и тестов. - Дайте небольшую задачу и посмотрите, как Codex предлагает изменения и спрашивает разрешение на запуск команд.
- Если ответы кажутся медленными, попробуйте Fast Mode командой
/fast: быстрее, но дороже; как включить по умолчанию — в руководстве по Codex CLI.
Сколько это стоит
Оплата за токены, без подписки. Типичная задача в Codex на среднем проекте на GPT-6 Sol стоит несколько центов; на Luna — ещё в разы дешевле, на Astra — заметно дороже. Повторяющийся контекст (тот же код в соседних запросах) тарифицируется по сниженной цене чтения кэша. Точные цены — на странице цен.
Про «лимиты Codex». Частый вопрос — как сбросить лимит Codex. Лимиты, которые обнуляются раз в несколько часов или раз в неделю, относятся к подписке ChatGPT. При работе по API-ключу их нет: вы платите за токены, пока есть баланс. Есть только ограничения на частоту запросов для каждой модели — они указаны на странице лимитов.
Как оплатить из России
Баланс пополняется в консоли, списание — только за фактически использованные токены; минимального пакета и «сгорающих» тарифов нет.
- Рубли — в окне пополнения нажмите «Оплатить» и выберите способ: СБП, Т-Банк, карта Visa / Mastercard / Мир, ЮMoney или SberPay. Платёж проводит платёжный сервис Payssion. Минимальное пополнение — $5.
- USDT — кнопка «Оплатить криптовалютой» в том же окне: переведите USDT на показанный адрес, зачисление занимает от одной до пяти минут.
Частые ошибки
Все сообщения ниже мы воспроизвели сами, намеренно ошибаясь в настройке. Перед окончательной ошибкой Codex несколько раз пишет Reconnecting... 1/5 — это повторные попытки, а не причина.
ERROR: Missing environment variable: OPENAI_API_KEY.
Codex нашёл конфигурацию, но не нашёл ключ. Переменная не задана в этом терминале: выполните source ~/.zshrc или, на Windows, откройте новое окно PowerShell.
unexpected status 401 Unauthorized: The provided bearer token could not be validated as either a Teamo API key or an OAuth/session token., url: https://api.teamorouter.com/v1/responses
Запрос дошёл до TeamoRouter, но ключ не подошёл: скопирован не полностью, с пробелом или удалён в консоли. Создайте новый ключ.
unexpected status 404 Not Found: <!DOCTYPE html>… url: https://api.teamorouter.com/responses
В base_url пропущен /v1. Обратите внимание на адрес в конце сообщения: должно быть …/v1/responses. Исправьте строку на base_url = "https://api.teamorouter.com/v1".
unexpected status 401 Unauthorized: Missing bearer or basic authentication in header, url: https://api.openai.com/v1/responses
Codex обращается напрямую к OpenAI — значит, ваша конфигурация не применилась. Проверьте, что файл лежит именно в ~/.codex/config.toml (на Windows — C:\Users\<имя>\.codex\config.toml) и что в нём есть первая строка model_provider = "teamorouter".
Error loading config.toml: wire_api = "chat" is no longer supported.
Конфигурация из старой инструкции. Замените в ней wire_api = "chat" на wire_api = "responses".
Частые вопросы
Нужен ли VPN? Нет. Codex обращается к api.teamorouter.com, вход в аккаунт ChatGPT не нужен.
Нужна ли подписка ChatGPT Plus? Нет. При работе по API-ключу подписка не используется: вы платите только за токены.
Как пользоваться Codex на Windows? Так же, как на macOS: установка через npm, конфигурация в %USERPROFILE%\.codex\config.toml (команда для PowerShell выше), ключ — в пользовательской переменной окружения. После установки ключа откройте новое окно терминала.
Можно ли одним ключом пользоваться и Codex, и Claude Code? Да, ключ TeamoRouter один на все модели. Как настроить Claude Code — в статье «Claude Code в России».
Что дальше
- Руководство по Codex CLI — установка по шагам и Fast Mode.
- GPT-6 Sol через API — цены и выбор между Sol, Astra и Luna.
- Claude Code в России — агент от Anthropic с тем же ключом.
- Создать API-ключ.