← Каталог

· AI Engineer Code 2025

Как добавить субагентов в Codex CLI

Hacking Subagents Into Codex CLI — Brian John, BetterUp

Субагентов в Codex CLI можно добавить без нативной поддержки: родительская сессия запускает дочерний codex exec через обёртку, а обмен идёт через файлы.

  • Права песочницы — родительской сессии нужен --sandbox workspace-write, и дочерней тоже, иначе она не запишет файл с ответом. Песочница закрывает доступ к учётным данным OpenAI в домашнем каталоге, поэтому обёртка копирует конфиг Codex в подкаталог и задаёт CODEX_HOME.
  • Одна и та же команда — имя агента и запрос передаются через файлы, а команда вызова не меняется. Тогда Codex спрашивает разрешение один раз, а не при каждом вызове субагента.
  • Серийный запуск и таймауты — Codex не умеет запускать субагентов асинхронно, поэтому они идут по очереди. По словам спикера, большие задачи по кодовой базе занимают до 10 минут, иногда до 20, так что таймаут стоит ставить с запасом.
  • Оценка риска — по подходу Meta к безопасности агентов схема попадает в категорию низкого риска: недоверенного ввода нет, но есть доступ к приватному коду и внешние запросы к API. Низкий риск при этом не значит нулевой.

Кому полезно: тем, кто хочет использовать субагентные workflow в Codex CLI и не привязываться к одной модели или одному инструменту.

Статья по теме

На какие вопросы отвечает доклад

  • Как запустить субагентов в Codex CLI, если встроенной поддержки нет?

    Родительская сессия вызывает wrapper-скрипт, который запускает codex exec как дочерний процесс. Промпт и результат передаются через файлы, а ответ возвращается родителю через stdout.

    ▶ 2:09Идеи для рабочих процессов и родительско-дочерняя архитектура Codex
  • Почему дочерний codex exec не может читать учётные данные и писать файлы из сессии?

    Песочница блокирует доступ к файлам вне рабочей директории, включая учётные данные OpenAI в домашнем каталоге. Нужны как минимум --sandbox workspace-write и отключение rollout recorder.

    ▶ 3:35Учетные данные sandbox, разрешения и безопасность API
  • Как не подтверждать запуск субагента вручную при каждом вызове в Codex?

    Разрешение привязано к точной команде, поэтому аргументы не меняются: имя агента и запрос записываются в файлы, а сама команда остаётся одинаковой. Тогда достаточно один раз ответить «да» и не спрашивать снова.

    ▶ 7:10Агенты для проверки концепции и Python AgentExecutor
  • Можно ли запускать несколько субагентов в Codex параллельно, как в Claude Code?

    Нет: по словам спикера, Codex запускает субагентов последовательно, поэтому работа идёт медленнее. Он считает, что Codex рассчитан на работу без присмотра, а Claude Code на итеративную работу.

    ▶ 10:25CODEX_HOME, подтверждения запуска, тайм-ауты и заключение
  • Какой таймаут ставить для долгих субагентов, которые анализируют большую кодовую базу?

    Спикер использует таймаут 600 секунд. По его наблюдениям, на большой кодовой базе агенты работают до 10 минут, иногда до 20, поэтому лимит может понадобиться больше.

    ▶ 10:25CODEX_HOME, подтверждения запуска, тайм-ауты и заключение
  • Как изолировать настройки Codex для дочернего агента, не меняя конфиг пользователя?

    Wrapper копирует файлы из домашнего каталога Codex в отдельную поддиректорию и задаёт для процесса переменную CODEX_HOME на неё. Так дочерний агент получает доступ к настройкам, а основной конфиг не затрагивается.

    ▶ 10:25CODEX_HOME, подтверждения запуска, тайм-ауты и заключение

Главы

Похожие доклады