Антон Ларичев

Субагенты в Codex выполняют отдельные части задачи в собственных потоках и возвращают главному агенту короткий результат. Чтобы их запустить, прямо попросите об этом: например, «запусти двух агентов и дождись обоих». Лучше всего они подходят для задач, где нужно много читать: исследования кода, тестов и логов. Параллельная запись в одни и те же файлы создаёт конфликты, поэтому её нужно изолировать.
Ниже — как запускать субагентов, как создать свою роль и когда параллельность только тратит токены.
Зачем нужны субагенты
Главная польза не только в скорости. Логи, результаты поиска и трассировки быстро заполняют контекст. Если поручить этот шум отдельному агенту, основной поток сохранит требования и решения, а получит только вывод.
Документация OpenAI называет проблему загрязнением контекста. Но есть и цена: каждый субагент сам обращается к модели и инструментам, поэтому такой процесс расходует больше токенов, чем работа одного агента.
Как запустить
В актуальных версиях Codex субагенты включены по умолчанию. Хороший запрос объясняет, как разделить работу, нужно ли ждать всех и что вернуть:
Проверь эту ветку с помощью параллельных субагентов.
Запусти одного на проблемы безопасности, второго на пробелы в тестах,
третьего на сопровождаемость. Дождись всех трёх и сгруппируй замечания
по категориям со ссылками на файлы.В CLI команда /subagents показывает потоки агентов и переключает между ними. Можно также попросить Codex направить работающего субагента, остановить его или закрыть завершённые потоки.
Если делегирование нужно регулярно, опишите его в AGENTS.md или навыке: Codex учитывает такие инструкции.
Встроенные агенты
| Агент | Для чего |
|---|---|
default | общий запасной вариант |
worker | реализация и исправления |
explorer | чтение и исследование кода |
Как создать свою роль
Свои агенты хранятся в TOML-файлах. Личные лежат в ~/.codex/agents/, а агенты проекта — в .codex/agents/. Обязательны три поля: name, description и developer_instructions.
Создайте .codex/agents/test-scout.toml:
name = "test_scout"
description = "Находит тесты и команды запуска, не меняя файлы."
model = "gpt-6-luna"
model_reasoning_effort = "low"
developer_instructions = """
Не редактируй файлы.
Найди тесты и команду их запуска.
Верни короткий список: файл и что он проверяет.
"""Теперь к нему можно обратиться по имени:
Запусти двух субагентов test_scout параллельно: первый ищет тесты,
второй команду запуска. Дождись обоих и перескажи результат одной строкой.Мы проверили такую роль на Codex CLI 0.167. Описание description стоит писать конкретно: главный агент ориентируется на него при выборе роли.
Какую модель выбрать
Если модель не указана, субагент наследует модель и уровень рассуждений родителя. OpenAI предлагает простое разделение: gpt-6.1-sol для сложных задач с неоднозначностью, gpt-6-luna для быстрых, узких и повторяющихся.
Такой подход помогает контролировать расход. Поиск по проекту не требует той же настройки, что архитектурное решение.
Глобальные параметры находятся в разделе [agents] файла config.toml. Например, можно ограничить число одновременно открытых потоков:
[agents]
max_concurrent_threads_per_session = 4Что важно знать о правах
Субагенты наследуют песочницу и правила подтверждения родительской сессии, а также провайдера и MCP-серверы. Файл роли не может их заменить.
Отсюда важный вывод: строка «не редактируй файлы» в роли — это просьба, а не техническое ограничение. Если изменения запрещены, запускайте родительскую сессию с --sandbox read-only.
В интерактивном CLI запрос на подтверждение может прийти из неактивного потока. Окно покажет его источник, а клавиша o откроет этот поток. В неинтерактивном запуске действие, которому требуется новое подтверждение, завершится ошибкой, и она вернётся родителю.
Запуск без интерфейса
Субагентов можно использовать и в codex exec:
codex exec --sandbox read-only \
"Запусти двух субагентов test_scout, дождись обоих и верни итог." < /dev/nullЗдесь есть нюанс. В нашем тесте на Codex CLI 0.167 с флагом --ephemeral запуск субагента завершился ошибкой no rollout found for thread id. Без этого флага тот же запрос сработал. Перенаправление < /dev/null нужно, чтобы команда не ждала ввода из stdin.
Как параллелить запись
OpenAI советует начинать с задач на чтение и осторожно относиться к параллельным правкам. Если несколько агентов редактируют один код, возникают конфликты и лишние затраты на координацию.
Безопасный порядок такой:
- Сначала разделите задачу на независимые части и назначьте каждой свои файлы.
- Запускайте запись в отдельных git worktree, чтобы агенты не мешали друг другу.
- Заранее определите способ объединения.
- После объединения запустите полную проверку.
Если задачи затрагивают одни и те же файлы или зависят друг от друга, лучше выполняйте их последовательно.
Когда субагенты не нужны
| Используйте | Не используйте |
|---|---|
| Ревью с разных сторон | Небольшая правка в одном файле |
| Поиск по большому репозиторию | Шаги, где каждый зависит от предыдущего |
| Анализ длинных логов | Правки одного участка кода |
| Независимые модули | Задача дешевле, чем её разделение |
Частые вопросы
Сколько субагентов запускать? Столько, сколько есть действительно независимых частей. Лишний агент прибавит расход, но не качество.
Может ли субагент вызывать MCP-инструменты? Да, он наследует MCP-серверы родителя.
Видно ли, что делает субагент? Да, в CLI используйте /subagents.
Работают ли субагенты через свой провайдер? Да, провайдер наследуется. Настройка провайдера из России описана в статье Как войти в Codex.
Итог
Начните с агентов только для чтения: они снижают шум в контексте и почти не создают рисков. Для повторяющихся задач оформите роль в .codex/agents/, а права задавайте на уровне родительской сессии. Свои роли, параллельные сценарии, хуки, worktree и паттерны оркестрации разбираем на практике в курсе «Продвинутый Codex».






Комментарии
0