Как запускать субагентов в Codex

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

Это AI-перевод статьи, сделанный каналом Про AI: Лучшие Статьи и Исследования.

Как запускать субагентов в Codex

How to run subagents in Codex Автор: Emanuele Di Pietro Оригинальный текст:

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

Что такое субагенты?

Когда вы используете Codex сегодня, всё выполняется в одном потоке. Вы даёте задачу. Он исследует вашу кодовую базу. Пишет код. Запускает тесты. Всё последовательно.

Проблема в том, что со временем поток заполняется шумом — заметками от исследования, логами тестов, стек-трейсами. Codex начинает терять контекст. Производительность падает.

Субагенты решают эту проблему.

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

Один мозг координирует команду.

Как их использовать

Никакой сложной настройки. Вы просто говорите Codex, что хотите.

Пример промпта:

«Проверь эту ветку с параллельными субагентами. Запусти одного для рисков безопасности, одного для пробелов в тестах, одного для поддерживаемости кода. Дождись всех трёх, затем сделай сводку.»

Codex запускает 3 агентов. Они работают одновременно. Каждый исследует свой аспект. Главный агент объединяет всё в один чистый результат.

Выбор правильной модели для каждого агента

Вот тут становится интересно.

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

→ gpt-5.4 — для вашего главного агента и всего, что требует глубокого reasoning (рассуждения, цепочки мыслей). Сложная логика, неоднозначные задачи, анализ безопасности.

→ gpt-5.3-codex-spark — оптимизирована для скорости. Исследование, сканирование, быстрые саммари. Используйте для рабочих агентов.

А вообще — любую модель, которая вам нравится!

Вы также можете задать уровень reasoning effort (усилие рассуждения) для каждого агента:

→ high — сложная логика, анализ крайних случаев

→ medium — сбалансированный вариант по умолчанию

→ low — когда скорость важнее глубины

Практический пример

Ваш главный агент работает на gpt-5.4 с высоким уровнем рассуждения. Он запускает 3 spark-агента с низким уровнем рассуждения для параллельного сканирования кодовой базы. Они возвращают результаты. Главный агент синтезирует всё воедино.

Codex также поставляется с 3 встроенными агентами из коробки:

→ default — универсальный запасной вариант

→ worker — ориентирован на выполнение задач имплементации

→ explorer — ориентирован на чтение, для исследования и сканирования

Их можно использовать напрямую без какой-либо настройки. Если вам нужно что-то кастомное и детерминированное, определите собственного агента в TOML-файле:

toml
name = "security-reviewer"
description = "Scans for security vulnerabilities"
developer_instructions = "Focus only on security risks. Report findings clearly."
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"

Поместите его в .codex/agents/ в вашем проекте (или ~/.codex/agents/ для личного использования). Codex подхватит его автоматически.

Лучшие сценарии использования

→ Код-ревью — один агент на каждый аспект (безопасность, производительность, читаемость)

→ Сортировка багов — один агент на каждый зарепорченный баг, все работают одновременно

→ Исследование большой кодовой базы — разделите репозиторий, каждый агент сканирует свой участок

→ Покрытие тестами — один пишет тесты, другой проверяет крайние случаи, третий валидирует

→ Документация — агенты параллельно сканируют разные модули и генерируют документацию

→ Рефакторинг — агенты одновременно анализируют разные паттерны по всей кодовой базе

Правило простое: если работу можно разбить на независимые части, субагенты — правильный инструмент.

Когда НЕ стоит их использовать

→ Параллельная запись в одни и те же файлы — получите конфликты

→ Последовательные задачи, где шаг 2 зависит от шага 1 — агенты не могут координироваться в процессе работы

→ Простые изменения в одном файле — избыточные накладные расходы

Также стоит знать: субагенты потребляют больше tokens (токенов), поскольку каждый из них самостоятельно выполняет свою работу с моделью и инструментами. Используйте их тогда, когда параллелизм действительно имеет смысл.

Быстрый старт

Откройте Codex и попробуйте это:

«Проверь мой проект. Запусти 3 субагентов:

1. Проверь уязвимости безопасности
2. Найди недостающее покрытие тестами
3. Предложи улучшения производительности

Дождись всех трёх, затем выдай приоритизированный список действий.»

Вот и всё.

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

Чистый контекст. Быстрые результаты. Лучший результат.

Какую задачу вы бы первой разбили на параллельных агентов?

Подпишитесь на канал и каждый день читайте лучшие материалы про AI переведенные на русский!

Нашли интересную статью для перевода? Пришлите нашему боту: @ailongreadsbot