Термос Беспалова
Уровень · Продвинутый

OpenAI Codex: что умеет агент в терминале и как начать

Что такое Codex сейчас и чем он отличается от одноимённой модели 2021 года, как установить и настроить, как работает песочница, какие команды экономят время и во что обходится подписка.

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.mdread-only
21–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).

Гайды 2026

Разобрано до шаблонов: три гайда по 490 ₽

Всё, что в статьях идёт по верхам, здесь собрано в PDF: пошаговые схемы, готовые промпты и шаблоны, которые можно взять и применить в тот же день.

Обложка гайда «Промпты, которые работают: система и 60 готовых шаблонов»

Промпты, которые работают: система и 60 готовых шаблонов

Как писать запросы к нейросетям так, чтобы ответы можно было брать в работу без переписывания

  • Формула промпта из семи элементов с разбором «плохо / хорошо»
  • Работа с контекстом и файлами: как кормить модель данными
  • Итерации: как дорабатывать ответ, а не начинать заново
  • Few-shot и цепочки промптов со схемами

PDF, 57 стр., A4

Посмотреть фрагмент (PDF)
Обложка гайда «Свой ИИ-агент за выходные: пошагово, с кодом и без»

Свой ИИ-агент за выходные: пошагово, с кодом и без

Три рабочих проекта, выбор платформы, безопасность, стоимость и тесты: от агента в конструкторе до Python-кода с MCP

  • Цикл агента и пять архитектур со схемами
  • Честный раздел «когда агент не нужен» и дерево решений
  • Сравнение платформ no-code и кода по девяти критериям
  • Три проекта пошагово: секретарь заявок, аналитик отчёта, агент на коде

PDF, 51 стр., A4

Посмотреть фрагмент (PDF)
Обложка гайда «Claude с нуля: от первого чата до скиллов и Claude Code»

Claude с нуля: от первого чата до скиллов и Claude Code

Модели, проекты, 18 сценариев с промптами, скиллы, MCP и Claude Code для тех, кто не пишет код

  • Как выбрать модель Claude по задаче (актуально на 25.09.2026)
  • Схема интерфейса и разбор возможностей: проекты, артефакты, поиск, память, рассуждение
  • Формула запроса и приёмы, которые работают именно у Claude
  • 18 рабочих сценариев с готовыми промптами: письма, договоры, презентации, таблицы, исследования

PDF, 42 стр., A4

Посмотреть фрагмент (PDF)

Оплата на стороне платёжного сервиса. После оплаты вы вернётесь на сайт, и файл откроется сразу. Оплачивая, вы принимаете оферту.

Дальше

Что почитать дальше

Claude Code или Codex

Сравнение двух главных агентов: безопасность, экосистема, тарифы.

Открыть

ИИ-агенты в терминале

Обзор агентов 2026 года, включая бесплатные и открытые.

Открыть

MCP-серверы

Как подключить к агенту трекер задач, базу данных и документацию.

Открыть
Вопросы

Частые вопросы

Что такое OpenAI Codex?
Агент OpenAI для работы с кодом: читает проект, меняет файлы, запускает команды и тесты и доводит задачу до проверяемого результата. Работает в терминале, редакторе, облаке и приложении ChatGPT. Не путать с моделью Codex 2021 года, на которой работала первая версия GitHub Copilot.
Как установить Codex CLI?
Командой npm install --global @openai/codex при установленном Node.js. Затем в папке проекта запустить codex и войти через аккаунт ChatGPT или API-ключ. Команда /init создаст заготовку файла AGENTS.md, которую стоит дополнить своими правилами.
Codex бесплатный?
Есть ограниченный бесплатный доступ для быстрых задач в приложении. Полноценная работа в терминале, редакторе и облаке — с подписки ChatGPT Plus за 20 долларов в месяц; расширенный объём — в Pro от 100 долларов. Можно работать и через API-ключ с оплатой за токены.
Как Codex защищает от опасных действий?
Песочницей на уровне системы: по умолчанию агент пишет только в рабочую папку и не имеет доступа в сеть, а для выхода за рамки спрашивает подтверждение. Режим без ограничений (флаг --yolo) предназначен только для одноразовых окружений вроде контейнера.
Чем Codex cloud отличается от Codex CLI?
CLI работает на вашем компьютере с вашими файлами. Cloud выполняет задачи в изолированных облачных машинах OpenAI с доступом к репозиторию на GitHub: можно отдать несколько задач параллельно и получить результаты на проверку. В облачном режиме код уходит на серверы OpenAI.
Можно ли запускать Codex в CI и скриптах?
Да, через codex exec: агент получает задачу строкой, выполняет её и завершает работу. По умолчанию exec работает в песочнице только на чтение; если нужно менять файлы, режим указывается явно флагом --sandbox workspace-write.

Хотите внедрить агентов в разработку команды?

Общие файлы инструкций, настройки безопасности, ревью силами агента и автоматические задачи в CI — это настраивается один раз для всей команды. В «Термос Беспалова» помогаем выстроить такой процесс и собираем агентов под задачи бизнеса.

Получить консультацию

Пн–Вс, 10:00–20:00. Отвечаю лично.