Codex от OpenAI: что это, как установить и доступ из России в 2026

Слово «Codex» в поиске означает сразу три разные вещи, и тот, кто вбивает его впервые, обычно не понимает, на что попал. Была модель Codex - её отключили в 2023 году, сегодня под этим именем живёт программа-агент, а рядом крутится ещё десяток чужих продуктов с таким же названием.

Я разбираю только один Codex: агент для работы с кодом от OpenAI. Что он делает, где живёт, сколько стоит, как поставить за пять минут и что OpenAI отвечает на вопрос про страны. Всё по официальной документации, ссылки на каждую цифру внизу.

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись.

Что такое Codex от OpenAI?

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

В репозитории OpenAI это описано одной строкой:

Локально - значит программа скачивается на твою машину, видит твои файлы и запускает команды в твоей папке. В облако уходит только запрос к модели.

Открытый код лежит на GitHub под лицензией Apache-2.0. На 1 августа 2026 у репозитория 103 тысячи звёзд, свежая версия 0.146.0 вышла 29 июля. Обновления выкатывают почти каждый день, так что версия у тебя, скорее всего, будет уже другая.

Чем Codex 2026 отличается от старого Codex, который закрыли?

Путают их постоянно, потому что оба продукта официальные и оба от OpenAI. Различаются они датами.

Первый был набором моделей: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Они умели одно - дописывать код за тебя, и на них работал первый GitHub Copilot. В списке отключённых моделей OpenAI все четыре стоят одной строкой: объявление 20 марта 2023 года, отключение 23 марта, рекомендованная замена gpt-4o.

Второй - программа, которая ставится на компьютер. Пакет @openai/codex появился в реестре npm 16 апреля 2025 года. Модель внутри со временем подменяют на свежую, программа при этом та же.

Любая инструкция про Codex старше апреля 2025 года описывает мёртвый продукт. Если находишь материал, где Codex называют моделью и предлагают дёргать через code-davinci-002, закрывай.

Где работает Codex: терминал, редактор, браузер или приложение?

Выбирать между ними не нужно, вход один и тот же, аккаунт один и тот же. Разница только в том, откуда тебе удобнее работать.

Для Xcode и JetBrains расширение работает иначе, чем для остальных:

Облако устроено не так, как остальные четыре. Задача уходит в контейнер OpenAI, там разворачивается копия репозитория с GitHub, агент работает без твоего компьютера, а ты потом смотришь итог и решаешь, забирать ли изменения к себе. Настройка в три шага: подключить GitHub, создать окружение с нужными зависимостями, поставить задачу.

Если заходишь по ключу API, работают терминал, редактор и приложение. Облако через ключ недоступно, как и всё, что к нему привязано: автоматический разбор кода, запуск задач из Slack. Для этого нужен вход через аккаунт ChatGPT.

Какая модель работает внутри Codex?

У OpenAI на этот счёт одна строчка:

Рядом с моделью есть второй регулятор - глубина рассуждения. Значений четыре: Low (низкая, в приложении и редакторе она называется Light), Medium (средняя), High (высокая) и Extra High (максимальная). OpenAI советует брать минимальную глубину, на которой получается нужный результат, и повышать её, когда задача требует планирования.

Сверху есть ещё два режима. Max даёт модели больше времени на одну задачу. Ultra разбивает работу на части и раздаёт их субагентам параллельно. В документации прямо сказано, что большинству задач ни то, ни другое не нужно.

Отдельной строкой идёт gpt-5.3-codex-spark - исследовательская версия для быстрых итераций, доступная только на тарифе Pro.

Выбор модели и глубины рассуждения - это уже контекст-инжиниринг: ты решаешь, сколько агент думает и с чем именно он приходит к задаче. На практикуме за три вечера разбираем все три кита: ИИ-клон (твоя методология внутри агента), Второй мозг (структура знаний о проекте) и контекст-инжиниринг. Без этой связки ИИ-агент начинает выдумывать.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 25–27 августа  ·  2 000 ₽

Записаться →

Сколько стоит Codex и что входит в тарифы?

Цены я сверял по официальной странице тарифов 1 августа 2026 года. Рубли посчитал по ЦБ на ту же дату, доллар в тот день стоил 79,4637 ₽.

Business при помесячной оплате стоит $25 за место вместо $20.

Теперь про лимиты. Одного числа OpenAI не даёт:

Вместо одного числа OpenAI публикует диапазон: сколько сообщений уходит за пять часов, если работаешь на своей машине. Для Plus и Business цифры одинаковые:

На Pro за 100 долларов все числа умножаются на пять, на Pro за 200 - на двадцать. Кроме пятичасового окна OpenAI упоминает недельные лимиты, но конкретных чисел по ним не публикует.

Десятикратный разброс внутри одной модели объясняется просто. Одно сообщение может обойтись и в один процент дневного запаса, и в десять, потому что считается объём проделанной работы, а количество запросов на это влияет слабо. Как токены утекают на практике, я подробно разбирал на примере Claude в материале про лимиты Claude Pro и Max - механика ровно та же.

Когда запас кончился, есть три выхода: докупить кредиты без смены тарифа, переключиться на модель полегче или запустить сессию с ключом API и платить по факту токенов.

Работает ли Codex из России?

Отвечаю прямо, без обещаний. Официальный список поддерживаемых стран и территорий OpenAI публикует открыто. Я прошёл его целиком: между Румынией и Руандой строки с Россией нет. Беларуси тоже нет. Казахстан, Армения, Грузия, Турция, Сербия и Украина в списке есть.

Формулировка на той же странице:

Установка и запуск программы - это одно, доступ к модели - другое. Проверка страны включается на шаге входа: и вход через ChatGPT, и вход по ключу API ведут к аккаунту OpenAI.

Как выглядит отказ по стране, видно в жалобах на гитхабе. Разработчик из Венесуэлы написал в январе 2026 года: Codex версии 0.88.0, PowerShell, и на каждую попытку одно и то же:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

Код unsupported_country_region_territory и статус 403 - это отказ по стране. Увидел такое, значит ты ничего не сломал при установке, и Node тут ни при чём.

Второй барьер в документации не описан вообще, зато в жизни встречается чаще первого. Это проверка номера телефона. Жалоба «Проверка номера телефона не работает» собрала 206 комментариев, вторая, про недоступный старый номер, который нечем заменить, открыта с июня 2026 года и собрала 71 комментарий. История там повторяется одна: ChatGPT в браузере на том же аккаунте работает, а Codex требует подтвердить номер, и обойти это никак. Списка стран, чьи номера принимаются, OpenAI нигде не публикует, так что заранее проверить свой не получится.

Официального документа OpenAI про российские карты я не нашёл. Утверждения на эту тему в русскоязычных материалах ссылаются друг на друга по кругу, и ни одна ссылка до первоисточника не доводит. Обходные схемы я не разбираю - я тут про то, как эта штука устроена.

Свой список поддерживаемых стран Anthropic тоже публикует открыто, и устроен он так же. Материалы, где один инструмент подан как «разрешённый», а другой как «заблокированный», просто вводят читателя в заблуждение - формально они в одном положении. Оба списка меняются, сверяйся с действующей редакцией.

Ещё раз про рамку, потому что этот раздел часто открывают по прямой ссылке из поиска. Оплата зарубежной подписки резидентом России - валютная операция по ФЗ-173, требования к расчётам меняются, сверяйся с действующей редакцией и со своим банком.

Как установить Codex: пошагово

Дальше техническая часть для тех, у кого действующий аккаунт OpenAI уже есть.

1. Поставить программу

   Выбери способ под свою систему. Тем же способом потом обновляешь программу до свежей версии.

2. Открыть папку проекта

   Агент работает в той папке, из которой ты его запустил. Зайди в неё заранее, до первой команды.

3. Войти в аккаунт

   Команда codex при первом запуске сама предложит вход. Откроется браузер, после входа управление вернётся в терминал.

4. Дать первую задачу

   Опиши словами, что нужно. Начни с чего-нибудь безобидного вроде просьбы рассказать про проект.

Команда установки на macOS и Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

На Windows то же самое через PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Если у тебя уже стоит Node, можно поставить через npm:

npm install -g @openai/codex

На macOS работает Homebrew. Именно --cask, без него встанет не то:

brew install --cask codex

На Linux и в WSL2 песочница построена на bubblewrap, и его надо поставить заранее:

sudo apt install bubblewrap

На Fedora и родственных системах то же самое через sudo dnf install bubblewrap. И ещё: WSL первой версии поддерживался до версии 0.114, начиная с 0.115 песочница переехала на bubblewrap и WSL1 отвалился. На Windows, впрочем, всё работает и без WSL, там своя встроенная песочница.

Что нажать при первом запуске?

Запуск выглядит так: заходишь в папку проекта, набираешь codex, откроется сессия. Дальше пишешь задачу обычными словами, без специального синтаксиса.

Пять команд на первые минуты:

1. /status - модель, политика подтверждений и какие папки агент считает рабочими.
2. /permissions - текущий режим доступа и переключение между режимами.
3. /model - смена модели и глубины рассуждения.
4. /init - создаёт файл AGENTS.md с описанием проекта, про него следующий раздел.
5. /review - отдельный разбор твоих изменений, без правок файлов.

Из терминальных команд, помимо голого codex, полезны ещё три:

codex resume                    # вернуться к прошлому разговору в этой папке
codex exec "почини тесты"       # разовый запуск без диалога, для скриптов
codex --image screenshot.png    # приложить картинку к задаче

И на странице терминала, и на странице расширения OpenAI повторяет одно: коммить до задачи и после. Агент правит файлы сам, и откатиться одной командой ты захочешь уже в первый день.

Как объяснить Codex свой проект через AGENTS.md?

Порядок жёсткий, и в документации он записан первой же строкой раздела:

Сначала читается глобальный файл ~/.codex/AGENTS.md - туда идут привычки, общие для всех твоих проектов. Потом файлы в самом проекте: от корня репозитория вниз до той папки, где ты сейчас находишься, по одному файлу на папку. Всё склеивается сверху вниз, и ближний файл перебивает дальний. То есть правило в папке services/payments сильнее общего правила из корня.

Простейший файл выглядит так:

# AGENTS.md

## Как работать с этим проектом

- Тесты запускать командой `npm test`, по одному файлу не гонять.
- Пакеты ставить через pnpm.
- Перед новой зависимостью в проде - спрашивать меня.
- Папку `legacy/` не трогать вообще.

Лимит - 32 килобайта на всю склейку. Дальше файлы просто перестают добавляться, молча. Раздутый AGENTS.md ещё и жжёт лимит на каждом запуске, потому что уезжает в контекст целиком.

Если тебе знаком CLAUDE.md, механика узнаётся с первого взгляда - это один и тот же приём под разными именами. Файл с правилами проекта работает как фундамент Второго мозга: агент узнаёт про твою работу до того, как ты успел что-то объяснить. Как устроить оба файла в одном проекте, я разбирал в материале про AGENTS.md и CLAUDE.md вместе.

Что Codex делает сам, а что только с разрешения?

Эти две настройки часто путают, поэтому OpenAI выносит разницу отдельной строкой:

Переключил проверку на автоматическую - границы рабочей папки те же. Автоматика просто снимает с тебя нажатия, права у агента от неё не меняются.

В приложении и редакторе режимов доступа три. Ask for approval (спрашивать разрешение) доступен всегда, с него и советуют начинать. Approve for me (проверять автоматически) и Full access (полный доступ) надо сначала включить в настройках.

В терминале своя логика: программа смотрит на папку и сама предлагает подходящий набор прав.

Сеть в локальном режиме по умолчанию выключена. Агент выполняет команды, которые придумал сам, и выпускать такое в интернет по умолчанию никто не будет.

Внутри рабочей папки есть места, куда агенту писать не дают ни в одном режиме: .git, .agents и .codex открыты только на чтение. Посмотреть, какие папки агент считает рабочими прямо сейчас, можно командой /status.

Есть ещё режим полного доступа - флаг --dangerously-bypass-approvals-and-sandbox. В документации он помечен значком повышенного риска и подписью «не рекомендуется». Название флага говорит само за себя, добавить мне нечего.

Codex или Claude Code: что выбрать?

Разница между инструментами меньше, чем можно решить по спорам в интернете. Оба читают проект и правят файлы сами, и оба спрашивают, прежде чем выйти за пределы папки.

На старте проще смотреть, что у тебя уже оплачено. Есть подписка ChatGPT, значит Codex у тебя уже есть, отдельно платить не нужно. Развёрнутое сравнение с замерами я делал в отдельном материале про Codex против Claude Code, а если хочешь перенести рабочие настройки из одного в другой - есть разбор миграции.

Что чаще всего ломается при первом запуске?

Список собран по жалобам в репозитории проекта. Догадок тут нет, за каждым пунктом стоит живой человек, который на это наткнулся.

1. Установился чужой пакет. npm install -g codex без префикса ставит генератор статических сайтов 2011 года. Правильно - @openai/codex.
2. Не поставлен bubblewrap. На Linux и WSL2 без него не поднимается песочница, Codex переключается на встроенный запасной механизм и ругается при старте. Ставится он одной строкой.
3. Отказ по стране. Код unsupported_country_region_territory и статус 403 на шаге входа. Установка тут ни при чём.
4. Требование подтвердить телефон. Всплывает не у всех и в документации не описано. Поменять недоступный номер штатно нельзя, жалоба об этом висит с июня 2026 года.
5. Кончился лимит быстрее, чем ожидал. Жалоба «Токены сгорают очень быстро» - самая обсуждаемая во всём репозитории, 627 комментариев. Помогает переключиться на модель полегче и опустить глубину рассуждения.

Шестой пункт касается конкретно нас. У русского интерфейса сейчас сломано сразу несколько вещей, и все жалобы до сих пор открыты:

• интерфейс на русском выезжает за границы окна;
• в окне со статистикой обрезается число: сколько лимита осталось;
• на Windows русский интерфейс перестаёт загружаться после обновления;
• сочетания Ctrl+C и Ctrl+D не срабатывают в кириллической раскладке в некоторых терминалах.

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

Что делать дальше

Первый час с агентом всегда уходит на одно и то же - понять, докуда он дотягивается сам. Выясняется это только на своём проекте, по примеру из документации такого не понять.

Порядок, который я советую на старте:

1. Поставить программу и войти в действующий аккаунт OpenAI.
2. Открыть папку с реальным проектом, запустить codex, спросить что-нибудь про устройство проекта.
3. Посмотреть /status и /permissions, чтобы понимать границы.
4. Сделать коммит и дать первую правку.
5. Написать AGENTS.md из трёх строк и сравнить, как отвечает агент до и после.

Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 25–27 августа  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email