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

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

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

Дополнительные советы по настройке инструментов собраны в документации Ailoot.

Что представляет собой Codex от OpenAI?#

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

В репозитории OpenAI CLI описан так:

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

Исходный код опубликован на 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.

Инструкции о Codex, опубликованные до апреля 2025 года, могут относиться к прежним моделям. Если в материале его называют моделью и предлагают использовать 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.

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

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

Цены ниже сверены с официальной страницей тарифов на 1 августа 2026 года.

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

OpenAI не указывает единого количества доступных сообщений:

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

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

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

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

Какие региональные ограничения относятся к Codex?#

OpenAI публикует список поддерживаемых стран и территорий. Беларуси в нём нет; Казахстан, Армения, Грузия, Турция, Сербия и Украина указаны как поддерживаемые.

На той же странице OpenAI предупреждает:

Установка программы и доступ к модели — разные вещи. Страна проверяется при входе: как через ChatGPT, так и при использовании API-ключа задействован аккаунт OpenAI.

Пример ответа при отказе по региону:

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

Код unsupported_country_region_territory и статус 403 указывают на региональное ограничение. В таком случае причина связана с доступностью аккаунта, а не с ошибкой установки или Node.js.

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

Перед использованием сервиса следует сверяться с актуальным официальным списком OpenAI: состав поддерживаемых стран и территорий может меняться.

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

Ниже приведены шаги для пользователя, у которого уже есть активный аккаунт OpenAI.

1. Установите программу

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

2. Перейдите в папку проекта

   Codex работает относительно папки, из которой его запустили. Сначала откройте нужный проект, затем запускайте агент.

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 сам меняет файлы, коммит позволяет при необходимости быстро отменить изменения.

Как описать проект для Codex с помощью AGENTS.md?#

OpenAI подчёркивает порядок чтения инструкций:

Сначала читается общий файл ~/.codex/AGENTS.md, предназначенный для правил, общих для разных проектов. Затем Codex ищет файлы проекта по пути от корня репозитория до текущей папки — по одному на каталог. Инструкции объединяются сверху вниз, а более близкое правило имеет приоритет. Например, правило в services/payments важнее общего правила в корне проекта.

Пример простого файла:

# AGENTS.md

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

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

Общий объём объединённых инструкций не должен превышать 32 килобайта. При превышении оставшаяся часть может не учитываться. Короткий файл также экономит контекст, поскольку его содержимое передаётся агенту при каждом запуске.

Что Codex может делать сам, а для чего запрашивает разрешение?#

OpenAI отдельно объясняет, что эти параметры не заменяют друг друга:

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

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

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

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

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

Для полного доступа существует флаг --dangerously-bypass-approvals-and-sandbox. В документации он отмечен как рискованный и не рекомендуемый к использованию.

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

Лучший способ понять доступы и поведение агента — попробовать его на собственном проекте: пример из документации не показывает, как конкретная рабочая папка будет взаимодействовать с Codex.

Для первого знакомства подойдёт такой порядок:

1. Установите программу и войдите в активный аккаунт OpenAI.
2. Откройте настоящий проект и запустите codex.
3. Проверьте /status и /permissions, явно выберите доступ только на чтение для ознакомления и убедитесь в активном режиме до просьбы описать структуру.
4. Создайте коммит и поручите агенту внести небольшое изменение.
5. Запишите несколько правил в AGENTS.md и сравните ответы до и после.

Дополнительные материалы об использовании инструментов доступны в документации Ailoot.