OpenAI Codex — агент для разработки, который может исследовать репозиторий, редактировать файлы, запускать локальные инструменты и проверять изменения. Он доступен в терминале, интегрированной среде разработки (IDE), облачных окружениях и настольном приложении.

Материал проверен по официальной документации Codex CLI, журналу изменений (changelog) и карточке модели 2 сентября 2026 года.

Оглавление

  1. Что умеет Codex
  2. Где можно работать
  3. Установка и первый запуск CLI
  4. Настройка проекта через AGENTS.md
  5. Полезные сценарии
  6. Как проверить результат
  7. Доступ, модели и стоимость
  8. Ограничения и безопасность
  9. Официальные ссылки

Что умеет Codex

ВозможностьЧто получает пользователь
Работа с репозиториемCodex читает структуру проекта, ищет связанные файлы и объясняет существующий код
Изменение кодаСоздаёт и редактирует файлы в пределах выданных разрешений
Запуск командИспользует установленные в рабочей среде тесты, линтеры, сборщики и другие инструменты
Исправление ошибокИсследует причину сбоя, предлагает патч и может проверить его командами проекта
Проверка кода (code review)Проверяет незакоммиченные изменения, отдельный коммит или изменения относительно базовой ветки
АвтоматизацияКоманда codex exec позволяет запускать повторяемые задачи в скриптах и CI (непрерывной интеграции)
Параллельная работаОблачные окружения и субагенты помогают разделять независимые задачи
Расширение возможностейНавыки (Skills), плагины и MCP-серверы подключают дополнительные инструкции, инструменты и источники данных
📌
Codex работает как агент: получает сформулированную задачу, исследует доступный контекст и выполняет разрешённые действия. Границы работы зависят от выбранной среды, настроек песочницы и профиля разрешений.

Где можно работать

Codex CLI (интерфейс командной строки)

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

Полезные команды и возможности:

  • /init создаёт файл AGENTS.md с инструкциями для агента;
  • /status показывает конфигурацию текущей сессии;
  • /permissions позволяет проверить и изменить доступные действия;
  • /model открывает выбор модели и уровня рассуждения;
  • /review запускает отдельную проверку изменений;
  • codex resume возвращает к сохранённой сессии;
  • codex --image добавляет к исходному запросу скриншот или другую иллюстрацию;
  • codex --search включает поиск актуальной внешней информации, когда он разрешён;
  • codex cloud отправляет задачу в настроенное облачное окружение и позволяет применить результат локально;
  • codex mcp управляет подключениями к MCP-серверам.

Codex cloud

Облачный режим запускает задачи в настроенных удалённых окружениях и позволяет выполнять несколько задач параллельно. Из CLI можно просматривать активные и завершённые задачи, отправлять новые и переносить готовые изменения обратно в локальный репозиторий.

Сетевой доступ, доступные инструменты и права на изменение файлов определяются конфигурацией конкретного окружения. Перед задачей, зависящей от внешнего API или загрузки пакетов, проверьте эти настройки.

Расширение для среды разработки (IDE)

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

Настольное приложение

Настольное приложение предназначено для координации проектов и продолжительных задач. Старое ограничение «только macOS с Apple Silicon» не следует переносить в текущую документацию как общее правило: поддержка платформ меняется, поэтому перед установкой проверьте актуальный раздел документации OpenAI.

Установка и первый запуск CLI

В актуальной документации для macOS и Linux указан самостоятельный установщик:

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

В официальном changelog от 1 сентября 2026 года опубликована команда установки CLI версии 0.152.1:

npm install -g @openai/codex@0.152.1

Перед установкой другой версии сверяйте номер с текущим changelog.

После установки откройте каталог проекта и запустите Codex:

cd path/to/project
codex .

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

Пример первого запроса:

Промпт:

Объясни структуру проекта, найди команды проверки и пока не меняй файлы.

Затем откройте /permissions и убедитесь, что профиль разрешений соответствует задаче. Старую тройку режимов Suggest, Auto Edit и Full Auto не используйте как актуальную универсальную схему управления: в текущей CLI-документации границы действий проверяются через /permissions, а поведение зависит от песочницы и настроек разрешений.

Настройка проекта через AGENTS.md

AGENTS.md содержит инструкции, которые помогают Codex ориентироваться в репозитории. Зафиксируйте в нём структуру проекта, команды проверки, правила оформления и запреты.

# AGENTS.md

## Project overview
Краткое описание продукта и стека.

## Structure
- `src/` — основной код
- `tests/` — тесты

## Verification
- `npm test`
- `npm run lint`
- `npm run typecheck`

## Conventions
- Сохраняйте совместимость публичного API
- Добавляйте тест для исправленной ошибки

## Do not
- Не читайте и не меняйте `.env`
- Не меняйте схему базы данных без отдельного согласования

Создать начальный файл можно командой /init, после чего его следует адаптировать под реальный проект.

⚠️
Инструкции проекта тоже нужно рассматривать как входные данные с точки зрения безопасности. В changelog Codex CLI 0.150.0 указано, что недоверенные проекты больше не передают инструкции из проектного AGENTS.md как инструкции уровня проекта. Это не отменяет необходимость самостоятельно проверять источник репозитория и активные разрешения.

Полезные сценарии

Исправление воспроизводимого бага

Задача: конечная точка API (endpoint) возвращает 500 при пустом запросе.

Исходные данные: путь к обработчику, способ воспроизведения и команда тестов.

Промпт:

Найди причину ответа 500 при пустом запросе. Исправь обработку, добавь регрессионный тест и запусти относящиеся к изменению проверки.

Наблюдаемый результат: в диффе есть локальный патч и тест, а журнал выполнения показывает результат команды проверки. Если тестовая среда недоступна, Codex должен явно сообщить, что фактический запуск не состоялся.

Исследование незнакомого проекта

Задача: понять механизм фонового опроса без изменения кода.

Промпт:

Объясни, как работает polling в scheduler.js: откуда приходит задача, где меняется состояние и какие граничные случаи не покрыты тестами. Файлы не изменяй.

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

Локальная проверка кода

Запустите /review и выберите проверку незакоммиченных изменений, коммита или изменений относительно базовой ветки.

Наблюдаемый результат: Codex возвращает приоритизированные замечания без изменения рабочего дерева. Каждое замечание нужно сопоставить с диффом и воспроизвести, если оно описывает ошибку выполнения.

Параллельная работа

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

Ограничение: результаты параллельных задач могут конфликтовать. Перед объединением сравните диффы и повторно запустите общую проверку проекта.

Как проверить результат

Готовый ответ агента ещё не доказывает корректность изменения. Используйте короткий проверочный цикл:

  1. Просмотрите список изменённых файлов и полный дифф.
  2. Убедитесь, что Codex не затронул секреты, конфигурацию окружения и несвязанные части проекта.
  3. Запустите узкие тесты для изменённого поведения.
  4. Запустите линтер, проверку типов и сборку, если они предусмотрены проектом.
  5. Воспроизведите исходную ошибку или основной пользовательский сценарий.
  6. При необходимости выполните отдельный /review.
  7. Сохраните изменение в Git только после успешной проверки.

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

Доступ, модели и стоимость

Доступ и лимиты проверяйте в выбранной среде и по актуальной документации. В changelog Codex CLI 0.152.0 указано, что уведомления об ограничении запросов (rate limit) предлагают проверить использование, управлять кредитами, сбросить лимит и управлять планом.

Отдельная API-модель codex-mini-latest всё ещё имеет официальную карточку, но помечена там как Deprecated. По состоянию на 2 сентября 2026 года в карточке указаны следующие цены:

Тип токеновЦена за 1 млн токенов
Входные$1.50
Кэшированные входные$0.375
Выходные$6.00

Для прямого использования в API карточка рекомендует начинать с gpt-4.1. Поэтому codex-mini-latest не следует автоматически выбирать для нового проекта только из-за названия. Доступность, рекомендуемую замену и цены проверьте перед внедрением.

Ограничения и безопасность

  • Codex действует только в пределах доступных файлов, инструментов, сетевых правил и разрешений.
  • Команды установки зависимостей, миграции и обращения к внешним сервисам могут быть заблокированы песочницей или потребовать подтверждения.
  • MCP-серверы и плагины могут расширять область доступа. Подключайте только доверенные источники и проверяйте запрашиваемые права.
  • Параллельные задачи требуют отдельной проверки конфликтов перед объединением результатов.
  • Сгенерированный патч необходимо проверять тестами и проверкой кода; прежняя оценка о фиксированном проценте небезопасного AI-кода не подтверждена предоставленными источниками.
  • В официальном changelog на 1 сентября 2026 года последней опубликованной версией CLI указана 0.152.1, поэтому названия команд и элементы интерфейса со временем могут измениться.
  • Универсальный лимит выполнения облачной задачи в 1–30 минут не подтверждён актуальными источниками и исключён из руководства.

Официальные ссылки

Если вы выбираете режим Codex для рабочего репозитория, заранее определите границы доступа, обязательные команды проверки и правила приёмки результата.

Следующий шаг

Если вам нужны дополнительные инструкции для расширения Codex, продолжите с материалом Skills для OpenAI Codex.

Границы доступа, проверка изменений и выбор среды особенно важны для командной разработки. Это обсуждение может быть полезно, если вы внедряете Codex в рабочий процесс.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov