Модуль 1 · Codex без человека в цикле · урок 2 из 14
codex exec: Codex в скриптах
codex exec запускает Codex без интерфейса: одна команда, одна задача, результат в stdout. На нём построено почти всё в этом курсе, от job в GitLab CI до GitHub Action. Ниже о том, как он устроен, какие права получает по умолчанию и какие флаги нужны, чтобы в пайплайне он каждый раз вёл себя одинаково.
Базовый вызов
Задачу передают одним аргументом:
codex exec "опиши структуру репозитория и назови пять самых рискованных мест"Пока Codex работает, ход выполнения (команды, рассуждения, правки) идёт в stderr. В stdout попадает только финальное сообщение агента, так что результат удобно перенаправить в файл или передать дальше:
codex exec "составь заметки о релизе по последним 10 коммитам" | tee release-notes.mdУ команды есть короткий алиас codex e. Запускать её нужно внутри Git-репозитория, это защищает от необратимых изменений. Для одноразовых каталогов без Git есть --skip-git-repo-check, но берите его, только если уверены, что в каталоге нечего сломать.
Данные через pipe
Когда на вход подан stdin и при этом есть аргумент-промпт, аргумент считается инструкцией, а stdin дополнительным контекстом. В агентстве так делают чаще всего: вывод одной команды становится материалом для Codex.
vendor/bin/phpunit 2>&1 \
| codex exec "кратко перечисли упавшие тесты и предложи минимальное исправление" \
> test-summary.mdtail -n 300 storage/logs/system.log \
| codex exec "найди вероятную первопричину ошибок и предложи три шага для отладки" \
> log-triage.mdЕсли весь промпт собирает скрипт, передайте его через stdin, а вместо аргумента поставьте -:
cat .codex/prompts/weekly-report.md | codex exec -Тогда промпты можно хранить в репозитории рядом с кодом и править через MR, как любой другой файл.
Права: по умолчанию только чтение
По умолчанию codex exec запускается в песочнице read-only: агент читает файлы и выполняет команды, но записать ничего не может. Для автоматизации это правильная отправная точка. Права расширяют явно:
# разрешить правки внутри рабочего каталога
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 |
задать рабочий каталог |
Вот запуск, который не зависит от окружения разработчика:
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.
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:
RUST_LOG=info codex exec "..." 2> codex-debug.logЧтобы разобраться в поведении самого агента, удобнее поток событий --json, о нём следующий урок.
Попробуйте сами
10–15 мин на рабочем месте- В своём репозитории запустите
codex exec "опиши структуру проекта в 10 строках" > structure.md. Проверьте, что ход работы шёл в терминал (stderr), а в файл попал только итог. - Передайте Codex вывод реальной команды:
git log --oneline -20 | codex exec "сгруппируй эти коммиты по темам для отчёта клиенту". - Повторите первый запуск с
--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.