Amiga
Оглавление курса · урок 2 из 14

Модуль 1 · Codex без человека в цикле · урок 2 из 14

codex exec: Codex в скриптах

codex exec запускает Codex без интерфейса: одна команда, одна задача, результат в stdout. На нём построено почти всё в этом курсе, от job в GitLab CI до GitHub Action. Ниже о том, как он устроен, какие права получает по умолчанию и какие флаги нужны, чтобы в пайплайне он каждый раз вёл себя одинаково.

Базовый вызов

Задачу передают одним аргументом:

bash
codex exec "опиши структуру репозитория и назови пять самых рискованных мест"

Пока Codex работает, ход выполнения (команды, рассуждения, правки) идёт в stderr. В stdout попадает только финальное сообщение агента, так что результат удобно перенаправить в файл или передать дальше:

bash
codex exec "составь заметки о релизе по последним 10 коммитам" | tee release-notes.md

У команды есть короткий алиас codex e. Запускать её нужно внутри Git-репозитория, это защищает от необратимых изменений. Для одноразовых каталогов без Git есть --skip-git-repo-check, но берите его, только если уверены, что в каталоге нечего сломать.

Данные через pipe

Когда на вход подан stdin и при этом есть аргумент-промпт, аргумент считается инструкцией, а stdin дополнительным контекстом. В агентстве так делают чаще всего: вывод одной команды становится материалом для Codex.

bash
vendor/bin/phpunit 2>&1 \
  | codex exec "кратко перечисли упавшие тесты и предложи минимальное исправление" \
  > test-summary.md
bash
tail -n 300 storage/logs/system.log \
  | codex exec "найди вероятную первопричину ошибок и предложи три шага для отладки" \
  > log-triage.md

Если весь промпт собирает скрипт, передайте его через stdin, а вместо аргумента поставьте -:

bash
cat .codex/prompts/weekly-report.md | codex exec -

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

Права: по умолчанию только чтение

По умолчанию codex exec запускается в песочнице read-only: агент читает файлы и выполняет команды, но записать ничего не может. Для автоматизации это правильная отправная точка. Права расширяют явно:

bash
# разрешить правки внутри рабочего каталога
codex exec --sandbox workspace-write "исправь падающий тест в tests/OrderTest.php"

# полный доступ — только в изолированном раннере или контейнере
codex exec --sandbox danger-full-access "<задача>"

Есть и промежуточный вариант, --approve-for-me. С ним песочница работает в режиме workspace-write, а запросы выйти за её пределы рассматривает агент-ревьюер вместо человека. Совмещать этот флаг с --sandbox и --yolo нельзя. Как устроено автоматическое ревью одобрений и почему оно не гарантирует безопасность, описано в документации.

В режиме workspace-write сеть по умолчанию выключена. Если задаче нужна сеть, например чтобы установить зависимость, её включают отдельно в конфигурации, см. урок «Песочница всерьёз».

Если вы читали старые инструкции. Флаг --full-auto больше не поддерживается, вместо него используйте --sandbox workspace-write или --approve-for-me. В старых статьях и даже в некоторых примерах OpenAI Cookbook он ещё попадается.

Воспроизводимый запуск

На машине разработчика codex exec подхватывает личный ~/.codex/config.toml, правила и сохранённую авторизацию. В пайплайне это скорее мешает: результат начинает зависеть от того, чей конфиг оказался на раннере. Пригодятся такие флаги:

Флаг Что делает
--ephemeral не сохранять файлы сессии на диск
--ignore-user-config не загружать $CODEX_HOME/config.toml (авторизация по-прежнему берётся из CODEX_HOME)
--ignore-rules не загружать пользовательские и проектные .rules
-m, --model закрепить модель для этого запуска
-p, --profile наложить файл профиля $CODEX_HOME/<имя>.config.toml
-c key=value переопределить отдельный ключ конфигурации, флаг можно повторять
-C, --cd задать рабочий каталог

Вот запуск, который не зависит от окружения разработчика:

bash
codex exec \
  --ephemeral \
  --ignore-user-config \
  --sandbox read-only \
  -c model_reasoning_effort=medium \
  "проверь, что все миграции в updates/ имеют откат"

Модель здесь не указана, поэтому Codex возьмёт модель по умолчанию. В CI её лучше закрепить флагом -m: модель по умолчанию со временем меняется, а с ней и поведение пайплайна. Названия моделей на октябрь 2026 года есть в документации.

И ещё одна деталь. Если в конфиге MCP-сервер помечен required = true и не запустился, codex exec завершается с ошибкой и не пытается продолжить без него. Для CI так и надо: пусть лучше упадёт, чем выдаст результат без нужного инструмента.

Авторизация в автоматизации

Локально codex exec пользуется сохранённым входом. В CI ключ обычно передают явно, и рекомендованный по умолчанию способ — API-ключ в переменной CODEX_API_KEY. Документация отдельно настаивает: задавайте ключ только для того вызова, которому он нужен, а не для всего job.

bash
CODEX_API_KEY="$OPENAI_API_KEY" codex exec --json "разбери открытые баг-репорты"

Причина простая. Ключ из переменных окружения всего job может прочитать любой код из репозитория, который выполняется в том же job: сборочные скрипты, тесты, хуки установки зависимостей. Как устроить это в GitLab, подробно разобрано в уроке «Codex в GitLab CI».

Войти через аккаунт ChatGPT в CI тоже можно, но это продвинутый сценарий. В файле ~/.codex/auth.json лежат токены доступа, и обращаться с ним нужно как с паролем. Для публичных репозиториев документация этот путь не рекомендует. Подробности на странице Maintain Codex account auth in CI/CD.

Отладка запуска

По умолчанию codex exec выводит только ошибки внутренних компонентов. Если запуск ведёт себя странно, поднимите уровень логов переменной RUST_LOG:

bash
RUST_LOG=info codex exec "..." 2> codex-debug.log

Чтобы разобраться в поведении самого агента, удобнее поток событий --json, о нём следующий урок.

Попробуйте сами

10–15 мин на рабочем месте
  1. В своём репозитории запустите codex exec "опиши структуру проекта в 10 строках" > structure.md. Проверьте, что ход работы шёл в терминал (stderr), а в файл попал только итог.
  2. Передайте Codex вывод реальной команды: git log --oneline -20 | codex exec "сгруппируй эти коммиты по темам для отчёта клиенту".
  3. Повторите первый запуск с --ephemeral --ignore-user-config и сравните результат. Если он отличается, ваш личный конфиг влияет на поведение, и об этом лучше узнать до переноса в CI.

Коротко

  • codex exec пишет ход работы в stderr, а итоговое сообщение в stdout.
  • stdin вместе с промптом становится контекстом, а - вместо промпта читает задачу из stdin.
  • По умолчанию песочница read-only. Права расширяйте явно через --sandbox workspace-write, полный доступ давайте только в изоляции.
  • Для воспроизводимости нужны --ephemeral, --ignore-user-config и закреплённая модель.
  • CODEX_API_KEY задавайте только для вызова Codex, не для всего job.
Отметка хранится только в вашем браузере
Хотите связаться с владельцем
компании напрямую?
Дмитрий Тарасов
Дмитрий Тарасов
СЕО

НАПИСАТЬ

Написать в MAX