OpenAI Codex — агент для работы с кодом от OpenAI: он читает проект, меняет файлы, запускает команды и тесты и доводит задачу до результата, который вы проверяете. Codex работает в терминале, в редакторе кода, в облаке OpenAI и в приложении ChatGPT и входит в подписки ChatGPT начиная с тарифа Plus. По устройству он ближе всего к Claude Code от Anthropic; главное отличие — модель безопасности на основе песочницы и глубокая интеграция с экосистемой ChatGPT.
Статья — практическое введение: что это за инструмент, как поставить и настроить, как не дать агенту лишней свободы и какие команды пригодятся в первую неделю. Сравнение с конкурентом — в гайде Claude Code или Codex, обзор остальных агентов — в гайде ИИ-агенты в терминале.
Что такое Codex и где он работает
У названия есть история, из-за которой его путают. В 2021 году OpenAI выпустила модель Codex, обученную на коде, — именно на ней работала первая версия GitHub Copilot. Та модель давно выведена из работы. Нынешний Codex — не модель, а продукт: агент, который использует актуальные модели OpenAI и умеет самостоятельно выполнять многошаговые задачи. Когда в статьях 2021–2022 годов пишут «Codex генерирует код по описанию», речь о старой модели, а не об агенте.
Современный Codex работает циклом, общим для всех агентов: получить задачу, изучить проект, составить план, внести изменения, запустить команды и тесты, посмотреть на результат, исправить, повторить. От чат-бота его отличает именно этот цикл и доступ к инструментам: файловой системе, терминалу, поиску в интернете, внешним сервисам через MCP. Разницу между агентом и чат-ботом подробно разбирает статья блога что такое ИИ-агент.
Сейчас Codex и режим работы ChatGPT для задач общего назначения развиваются вместе: у них общие лимиты использования, общие плагины и скиллы, а в приложении ChatGPT можно переключаться между обычным чатом, режимом Work и Codex. Для пользователя это означает, что Codex доступен не только разработчикам: его используют и для задач с файлами и данными, где нужен агент, а не просто ответ.
Одна подписка открывает несколько способов работы, и между ними можно переключаться в зависимости от задачи. Настройки и файлы инструкций общие, поэтому агент ведёт себя одинаково, откуда бы его ни запустили.
| Где | Как работает | Когда удобно |
| Codex CLI | агент в терминале на вашем компьютере | скрипты, автоматизация, работа на сервере |
| Расширение для редактора | панель агента в VS Code и совместимых редакторах | когда хочется видеть файлы и правки рядом |
| Codex cloud | задачи в изолированных облачных машинах OpenAI | фоновые задачи, несколько задач параллельно |
| Приложение ChatGPT | десктоп и iOS: запуск задач, просмотр изменений | раздать задачи и проверить результат с телефона |
Облачный режим — сильная сторона Codex. Вы подключаете репозиторий GitHub, описываете задачу, и агент выполняет её в отдельной виртуальной машине, не занимая ваш компьютер. Можно отдать несколько задач сразу и получить результаты на проверку в виде изменений или пул-реквестов. Важно понимать, что в этом режиме код уходит на серверы OpenAI, — для проектов с ограничениями по данным это нужно согласовать заранее.
Для команд есть автоматическое ревью пул-реквестов в GitHub и интеграция со Slack: задачу можно поставить сообщением в рабочем чате. Эти облачные интеграции доступны в тарифах Plus и выше и недоступны при работе через API-ключ.
Установка и первый запуск
CLI ставится одной командой через npm — менеджер пакетов Node.js: npm install --global @openai/codex. Если Node.js не установлен, проще сначала поставить его с официального сайта или попросить установочный скрипт с сайта OpenAI. После установки в папке проекта запускается команда codex, и при первом запуске агент предлагает войти: через аккаунт ChatGPT (тогда работа идёт в рамках подписки) или через API-ключ (тогда оплата за токены).
Первое, что стоит сделать в новом проекте, — команда /init. Она создаёт заготовку файла AGENTS.md с описанием проекта, командами сборки и тестов, которые агент нашёл сам. Заготовку обязательно нужно отредактировать: добавить правила, которые агент не мог узнать из кода, — что нельзя трогать, как принято оформлять изменения, куда смотреть в первую очередь.
Первая задача для знакомстваИзучи этот репозиторий и ничего не меняй. Расскажи: что делает проект, как его запустить, какие тесты есть и как их запустить, какие 5 файлов самые важные. Потом предложи 3 небольших улучшения с оценкой риска каждого. Код не пиши, пока я не выберу.
Такая задача безопасна (агент только читает), быстро показывает, насколько хорошо Codex понял проект, и даёт материал для AGENTS.md. Если агент ошибся в том, как запускать тесты, — это первое, что нужно записать в файл инструкций. В папке, которая не находится под контролем git, Codex по умолчанию стартует в режиме только чтения, пока вы явно не доверите ему рабочую папку.
Песочница и подтверждения
Главная особенность Codex — песочница на уровне операционной системы. Она определяет, что агент может сделать технически, независимо от того, что он «решит». Режимов три: read-only — только чтение; workspace-write — запись внутри рабочей папки, но не за её пределами и без доступа в сеть; danger-full-access — без ограничений. В CLI, расширении и приложении по умолчанию используется workspace-write, а неинтерактивный режим codex exec по умолчанию работает только на чтение.
Поверх песочницы работает политика подтверждений: когда агенту нужно выйти за рамки — записать файл вне папки, выполнить команду с доступом в сеть, — он спрашивает. Политику можно сделать строже или мягче, вплоть до режима, где агент никогда не спрашивает и просто получает отказ на всё, что не разрешено песочницей. Переключаться удобно командой /permissions прямо в сессии.
Чтобы не разбираться со всеми настройками сразу, удобно осваивать Codex по такому плану на первую неделю. Каждый шаг добавляет агенту немного свободы только после того, как предыдущий показал, что он делает то, что нужно.
| День | Что делаем | Режим |
| 1 | знакомство с проектом, /init, правка AGENTS.md | read-only |
| 2 | 1–2 маленькие правки с проверкой каждого изменения | workspace-write, подтверждения по запросу |
| 3 | задача на 3–5 файлов с планом заранее и /review перед коммитом | workspace-write |
| 4 | подключение 1 MCP-сервера, например документации или трекера | workspace-write, сеть для конкретного адреса |
| 5 | первая фоновая задача в облаке или codex exec в скрипте | облако или exec с явным режимом |
Флаг --yolo. Сокращение для --dangerously-bypass-approvals-and-sandbox: без песочницы и без подтверждений. Название честно предупреждает о риске. Используйте его только в одноразовом окружении — контейнере или облачной машине, где нет ваших ключей, почты и рабочих данных. На основном компьютере это прямой путь к истории про удалённую базу данных.
Доступ в интернет — отдельная настройка. В workspace-write сеть для команд выключена, но поиск в интернете как инструмент агента может работать и без сетевого доступа для команд. Если агенту нужно поставить пакеты или обратиться к API, доступ в сеть включается в настройках явно — лучше для конкретных адресов, а не для всех.
Команды и приёмы, которые экономят время
/review — ревью кода силами агента: сравнение с базовой веткой, как в пул-реквесте, проверка незакоммиченных изменений или конкретного коммита, с вашими инструкциями или без. Если в проекте есть файл с правилами ревью и на него ссылается AGENTS.md, Codex им следует. Хорошая привычка — прогонять /review перед каждым коммитом, особенно когда код писал сам агент.
/compact — сжать историю разговора, когда он стал длинным; Codex делает это и автоматически. /new — начать новый разговор для отдельной задачи, чтобы не смешивать контекст. /resume или codex resume — вернуться к сохранённому разговору. Правило «одна задача — один разговор» работает здесь так же, как в любом агенте: почему, разобрано в гайде контекстное окно нейросети.
codex exec — неинтерактивный режим для скриптов и CI: агент получает задачу строкой, выполняет и завершает работу. Например, ночная проверка безопасности изменений или обновление документации по расписанию. По умолчанию exec работает в песочнице только на чтение; если задаче нужно менять файлы, режим указывается явно флагом --sandbox workspace-write.
Пример для CIcodex exec --sandbox workspace-write "Обнови раздел API в docs/api.md по изменениям в src/api за последний коммит. Меняй только docs/. Если изменений в API нет — ничего не делай и напиши об этом."
Для длинных задач полезен план: попросите агента сначала описать план и список файлов и ничего не менять до вашего согласия. Для параллельной работы Codex поддерживает субагентов и отдельные рабочие копии репозитория (git worktree), чтобы несколько задач не мешали друг другу.
AGENTS.md, config.toml, скиллы и MCP
AGENTS.md — файл инструкций для проекта в открытом формате, который понимают и другие агенты, включая Claude Code. В нём — всё, что агент должен знать в каждой сессии: как собрать и протестировать проект, соглашения по коду, запреты. Принципы хорошего файла инструкций одинаковы для всех агентов и подробно разобраны в гайде файл CLAUDE.md.
config.toml — настройки поведения: личные по умолчанию в ~/.codex/config.toml, проектные — в .codex/config.toml в репозитории. Здесь задаются модель и степень рассуждений, режим песочницы и политика подтверждений, MCP-серверы, субагенты и экспериментальные функции. Проектный файл удобно хранить в репозитории, чтобы у всей команды агент вёл себя одинаково.
Скиллы — инструкции для конкретных задач, которые агент подгружает, когда они нужны: например, как у вас принято писать миграции базы данных или оформлять релиз. Формат SKILL.md общий с Claude Code, поэтому многие скиллы из маркетплейса скиллов подходят без изменений. MCP-серверы подключают внешние сервисы — трекер задач, базу данных, документацию; как это устроено, разобрано в гайде MCP: как подключить сервисы к ассистенту.
Тарифы и ограничения
Codex входит в подписки ChatGPT и делит с ними лимиты использования. Цены — с официальной страницы OpenAI на сентябрь 2026 года.
| Тариф | Цена | Что с Codex |
| Free | $0 | быстрые задачи в приложении, по мере выкатки |
| Go | $8 в месяц | лёгкие задачи |
| Plus | $20 в месяц | CLI, редактор, облако, iOS, ревью в GitHub, Slack |
| Pro | от $100 в месяц | в 5 или 20 раз больше использования, чем Plus |
| Business | $20 за пользователя | рабочее пространство, SSO, данные не используются для обучения по умолчанию |
| API-ключ | по токенам | CLI, SDK и редактор без облачных функций |
Лимиты считаются в объёме использования за период и зависят от модели и длины контекста: длинные задачи в облаке расходуют лимит быстрее, чем короткие правки. Если лимита Plus стабильно не хватает, следующий шаг — Pro или дополнительные кредиты. Для пользователей из России сервис официально недоступен: нужны VPN и зарубежный способ оплаты — подробнее в гайде доступ к нейросетям и оплата.
Главные ограничения — не технические. Код в облачном режиме уходит на серверы OpenAI; для корпоративных проектов это требует согласования. Агент уверенно ошибается, как любая языковая модель: выдуманные функции и пакеты, тесты, которые проходят, но ничего не проверяют. Поэтому правило «агент предлагает, человек проверяет» здесь такое же, как везде, а команда /review — не замена чтению изменений, а помощь в нём. Почему модели ошибаются уверенно, разобрано в гайде галлюцинации нейросетей.
Автор: Артём Беспалов, маркетинговое ИИ-агентство «Термос Беспалова», Калининград.
Источники: руководство OpenAI по Codex: установка, песочница, команды, тарифы · карта документации Codex (проверено 27.09.2026).