Codex в России: установка и настройка
Здесь сразу нужно снять путаницу. OpenAI уже дважды использовала слово «Codex» для разных вещей.
Старый Codex — это языковая модель code-davinci-002, которую OpenAI выпустила в 2021 году. На её основе работал первый GitHub Copilot. В марте 2023 года этот Codex закрыли, потому что gpt-3.5-turbo и gpt-4 справлялись с кодом лучше.
Новый Codex — принципиально другой продукт. Это ИИ-агент для программирования, запущенный в апреле 2025 года. Агент не просто генерирует код в ответ на промпт — он может клонировать ваш репозиторий, пройтись по файлам, запустить тесты, создать пулл-реквест и сделать code review прямо в GitHub. Каждая задача выполняется в изолированной облачной песочнице.
Если проводить аналогию: обычный ChatGPT — это коллега, которому вы объясняете задачу на словах. Codex — это коллега, которому вы даёте доступ к репозиторию и говорите: «Разберись сам».
К марту 2026 года аудитория Codex превысила 2 миллиона активных пользователей в неделю.
Ссылка: Codex
Что Codex умеет
Разработчик Питер Штайнбергер, создатель OpenClaw, рассказал в подкасте The Pragmatic Engineer, что пишет весь код проекта с помощью Codex.
- Читает ваш репозиторий целиком и понимает, как устроен проект
- Пишет новые функции и целые модули по описанию на русском или английском
- Ищет и исправляет баги — сам запускает тесты, смотрит на вывод ошибок, правит код
- Делает code review: находит проблемные места и объясняет, почему это плохо
- Создаёт пулл-реквесты в GitHub с описанием изменений
- Параллельно ведёт несколько задач в разных ветках, не конфликтуя с вашей работой
Как установить Codex в России
Шаг 1: Разобраться с доступом
Из России Codex не открывается напрямую — нужен зарубежный IP, аккаунт на иностранный номер и оплата зарубежной картой.
Что нужно сделать:
- Подключить VPN с американским или европейским IP
- Зарегистрировать аккаунт OpenAI (если его нет) — через иностранный номер или e-mail
- Оформить оплату — подробнее об этом в разделе про подписку
Шаг 2: Выбрать способ доступа
Codex существует в четырех форматах.
Веб-версия — самый простой вариант. Открываете chatgpt.com/codex в браузере через VPN, подключаете GitHub и начинаете работать. Никакой установки не нужно.
Приложение для Windows и macOS — изначально приложение вышло на Mac, а 4 марта 2026 года OpenAI добавила поддержку Windows. Скачивается с сайта OpenAI.
Расширение для VS Code — удобно, если не хочется выходить из привычной среды разработки. Устанавливается из маркетплейса VS Code, также работает в редакторах на его основе — Cursor и Windsurf.
Codex CLI — терминальный клиент для тех, кто привык работать в командной строке. Самый гибкий вариант, но требует установки. На Windows рекомендуется запускать через WSL — нативная поддержка пока помечена как экспериментальная.
Шаг 3: Установить Codex CLI
Codex CLI — это опенсорсный терминальный агент OpenAI, написанный на Rust. Он работает прямо в вашей среде разработки: читает структуру репозитория, предлагает правки файлов, выполняет shell-команды и запускает тесты.
Для установки через npm нужен Node.js версии 22 или выше.
Важный момент: самая частая ошибка при установке Codex CLI — запустить npm i -g codex вместо npm i -g @openai/codex. Пакет без @openai/ — это проект 2012 года, не имеющий отношения к OpenAI. Он установится молча и не будет делать ничего полезного.
Правильная команда:
npm install -g @openai/codex
Проверить установку:
codex —version
После этого нужно указать API-ключ. Его берёте в личном кабинете OpenAI (platform.openai.com), создаёте новый ключ и прописываете:
export OPENAI_API_KEY=sk-ваш-ключ
Или добавляете в ~/.bashrc / ~/.zshrc, чтобы не прописывать каждый раз.
Как работает Codex
В основе Codex CLI лежит классический agent loop. Пользователь отправляет запрос, система собирает большой промпт с инструкциями проекта. На инференсе модель либо отвечает текстом, либо инициирует вызов инструмента. Агент выполняет команду, добавляет результат обратно в контекст и снова обращается к модели. Цикл повторяется до тех пор, пока задача не будет завершена.
Промпт включает системные инструкции, список доступных инструментов и входные данные: текст, изображения, файлы, содержимое AGENTS.md и информацию о локальном окружении.
То есть, вы пишете задачу, Codex читает ваш проект, выполняет действия и возвращает готовый результат.
Что такое AGENTS.md и зачем он нужен
Каждый раз проговаривать правила в промпте можно, но это быстро превращается в ручную работу. Ещё хуже — правила начинают различаться от чата к чату. AGENTS.md нужен, чтобы важные правила жили рядом с проектом, а не в памяти отдельного участника.
Это обычный markdown-файл в корне репозитория. В нём вы описываете:
- Стандарты кодирования проекта
- Какие тесты запускать
- Каких инструментов не трогать
- Любые особенности вашего стека
Пример содержимого AGENTS.md:
# Правила проекта
— Код пишем на TypeScript strict mode
— Перед коммитом всегда запускаем `npm test`
— Не изменяем файлы в папке /legacy — там легаси, трогать опасно
— Комментарии на русском языке
Codex прочитает этот файл автоматически при каждом запуске и будет следовать этим правилам без напоминаний.
Насколько самостоятельным будет агент
Когда запускаете Codex CLI, можно выбрать один из трёх режимов:
suggest (по умолчанию) — агент предлагает изменения, но ничего не делает без вашего одобрения. Каждую правку вы подтверждаете вручную. Хорошо подходит для начала.
auto-edit — Codex сам редактирует файлы, но не запускает команды. Можно оставить работать и проверить потом.
full-auto — полная автономия: пишет код, запускает тесты, исправляет ошибки. Используйте на отдельной ветке, не на main.
Пример запуска в безопасном режиме:
codex «найди все места, где функция не обрабатывает ошибки, и добавь try-catch»
Какие модели работают в Codex
Актуальный стек на начало 2026 года:
- GPT-5.3-Codex — основная модель, вышла в феврале 2026-го. Быстрее предыдущей версии на 25%, умеет вести долгие задачи с поиском информации.
- GPT-5.4 — объединяет coding-возможности с более широкой функциональностью: умеет управлять компьютером нативно, работает с документами и таблицами.
- GPT-5.4 mini — быстрее большого GPT-5.4 в два с лишним раза, при этом почти не уступает ему по бенчмаркам кода.
Цены и подписка
Codex доступен во всех ChatGPT-планах: Free, Go, Plus, Pro, Business, Edu и Enterprise — лимиты зависят от тарифа.
Для большинства задач хватит Plus за $20 в месяц. Pro нужен тем, кто использует Codex как постоянного участника команды с многочасовыми сессиями.
Доступны два Pro-тарифа:
Pro за $100/мес — введён 9 апреля 2026 года как прямой ответ на $100-тариф Claude Code от Anthropic. Стандартный лимит — 5× относительно Plus. При запуске действовало временное промо с повышенными лимитами (до 31 мая 2026 года), после чего условия вернулись к стандартным.
Pro за $200/мес — лимит 20× относительно Plus на постоянной основе. Рассчитан на самые требовательные сценарии: непрерывная работа, параллельные проекты, многочасовые сессии.
Оба Pro-тарифа предлагают одинаковый набор функций — разница только в лимитах использования.
Как оплатить из России
OpenAI не принимает карты с российским биллингом и требует зарубежный IP при регистрации и оплате.
Рабочие варианты:
- Виртуальная зарубежная карта — получаете реквизиты (номер, срок, CVV) и вводите в форму оплаты как обычную банковскую карту. Подписка оформляется на ваш аккаунт, доступ к нему передавать никому не нужно.
- Сервисы оплаты — посредники, которые оформляют подписку за вас. Ищите по запросу «оплата ChatGPT из России» — актуальные варианты легко найти.
- Зарубежная карта знакомых — если есть кто-то с картой европейского или американского банка.
В рублях по курсу 85 ₽/$: Plus — около 1 700 ₽, Pro за $100 — примерно 8 500 ₽.
Альтернатива без иностранной карты — российские API-провайдеры
Для Codex CLI есть обходной путь. Российские API-провайдеры, работают на российском домене и не требуют зарубежных инструментов. Никакие сторонние инструменты не нужны — только config.toml с кастомным провайдером.
Это решение для тех, кто хочет работать через терминал и не хочет возиться с VPN и иностранными картами. Минус — лимиты и доступные модели зависят от конкретного провайдера.
Ограничения
Codex не всесилен. Он хорошо справляется с локальными задачами в пределах репозитория, но не работает с внешними сервисами без явной настройки.
Контекст ограничен. Все инструкции из AGENTS.md и корневых директорий проекта агрегируются в один JSON размером не более 32 Кб. Огромные монорепо нужно структурировать аккуратно.
Результат нужно проверять. Codex иногда уверенно делает странные вещи. Используйте separate branch, не работайте сразу в main, держите git под рукой.
Лимиты на использование. Чем сложнее задача и больше кодовая база, тем больше «агентного» использования она тратит. Большие сессии быстро съедают лимит на Plus.
