Когда задача перестаёт помещаться в один разговор, хочется сразу «нанять побольше агентов». В Claude Code для этого есть целых три механизма: субагенты, dynamic workflows и команды агентов. Со стороны они похожи — все раздают части работы нескольким исполнителям. Но устроены по-разному и стоят по-разному.
Хорошая новость: чтобы выбрать, не нужно помнить всю документацию. Достаточно одного вопроса — кто держит план — и трёх проверок по порядку.
Кто держит план
| Схема | Кто держит план | Куда приходят результаты |
|---|---|---|
| Один разговор | ты и Claude в одном контексте | сразу в разговор |
| Субагенты | Claude решает ход за ходом | каждый результат возвращается в твой разговор |
| Workflow | скрипт, который написал Claude | промежуточные итоги остаются в скрипте, в разговор приходит только финал |
| Команда агентов | ведущая сессия; напарники пишут друг другу напрямую | через ведущего и сообщения между напарниками |
Отсюда видно, почему схемы нельзя считать взаимозаменяемыми. Субагенты — это делегирование на словах: Claude каждый раз заново решает, кого позвать. Workflow превращает план в код. Команда — это несколько полноценных сессий, которые спорят друг с другом.
Три вопроса по порядку
Каждая схема сложнее одного разговора добавляет расход: каждый субагент и каждый агент workflow отправляет свои запросы, а команда расходует заметно больше токенов, чем одна сессия. Поэтому задавай вопросы именно в таком порядке и останавливайся на первом «да»:
- Справится ли один разговор, не переполнив контекст? Да — оставайся в нём.
- Должны ли исполнители общаться между собой? Да — команда агентов.
- Нужно много агентов, перекрёстная проверка находок или повторный запуск? Да — workflow. Нет — субагенты.
Теперь — по каждой схеме на живом примере.
Субагенты: три независимых поручения
Задача: кратко описать новичку, что лежит в папках src, test и docs. В одном разговоре контекст забьётся содержимым файлов, которое потом не понадобится. Описаниям не нужно общаться между собой, и задача разовая. Значит, субагенты:
Изучи папки src, test и docs параллельно, отдельными субагентами, и дай по два предложения о каждой.
В интерактивной сессии субагенты по умолчанию работают в фоне, а поле ввода остаётся свободным. /tasks покажет список субагентов с состоянием и моделью, а Enter на строке откроет переписку конкретного субагента. После работы /usage на планах Pro, Max, Team и Enterprise покажет, сколько ушло на субагентов, навыки, плагины и MCP-серверы. Это оценка, а не счёт.
Хочешь видеть, кого Claude на самом деле запускал? Повесь хук SubagentStart: он срабатывает при старте каждого субагента и получает agent_id и agent_type. Записывай их в журнал, и через неделю будет понятно, где делегирование окупается.
Workflow: когда план должен быть кодом
Если задаче нужно много агентов, перепроверка находок или повторный прогон, — это dynamic workflow. Это скрипт на JavaScript, который Claude пишет под задачу. Скрипт сам запускает агентов, держит их результаты в своих переменных, а в разговор отдаёт только итог.
Попросить просто — достаточно слова «workflow» в запросе:
use a workflow to audit every file under src/ for errors that are caught and then ignored, and adversarially verify each finding before reporting it
Раз план — это код, у него появляются свойства, которых нет у субагентов:
- скрипт можно прочитать до запуска: Claude Code покажет фазы плана и предложит View raw script (или
Ctrl+G); - независимые агенты могут перепроверять находки друг друга;
- удачный прогон можно сохранить и потом вызывать как команду
/<имя>, напримерRun /todo-audit on src.
Пока прогон идёт, /workflows открывает пульт: пауза p, остановка x, сохранение s. Для экономии есть настройка /config workflowSizeGuideline=small — но это совет Claude при написании скрипта, а не лимит. На плане Pro workflows выключены, пока ты не включишь строку Dynamic workflows в /config.
Про auto-режим
В режиме auto Claude Code спрашивает только перед самым первым запуском workflow: любое «Да» записывает согласие в пользовательские настройки, и дальше прогоны стартуют без вопроса. Читай каждый скрипт до одобрения и пробуй новый workflow сначала на одной маленькой папке.
Команда агентов: когда нужен спор
Команда — последняя ступень. Твоя сессия становится ведущей и запускает напарников, каждого в своём контексте. Напарники пишут друг другу напрямую, и ты тоже можешь написать любому. Субагенты так не умеют: они в основном просто возвращают результат.
Где это реально нужно? Там, где одно мнение опасно. Классика — отладка с неизвестной причиной: три напарника, у каждого своя гипотеза, и каждый пытается опровергнуть версии остальных. Ведущий записывает объяснение, которое выдержало спор.
Важно знать до включения:
- функция экспериментальная и выключена по умолчанию, её включает переменная
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1— лучше в отдельном файле настроек, который ты передаёшь через--settings, а не глобально; - напарник загружает твой CLAUDE.md, MCP-серверы и навыки, но не разговор ведущего — всё нужное должно быть в задании;
- напарников удобно собирать из read-only определений субагентов (
tools: Read, Grep, Glob), чтобы они только читали; - Claude Code запускает напарников без подтверждения, а останавливать их нужно по имени: «Ask the security and tests teammates to shut down»;
- напарники работают в твоей общей рабочей папке, а не в отдельных worktree, поэтому не давай двоим править один файл.
Если нужна именно параллельная правка файлов
Команда агентов делит одну рабочую папку. Если две независимые задачи правят файлы и заканчиваются коммитом, возможно, тебе нужны не агенты, а две сессии в отдельных worktree — об этом наш пост «Worktree в Claude Code».
Шпаргалка выбора
| Ситуация | Схема |
|---|---|
| Задача умещается в контекст | один разговор |
| Несколько независимых разовых поручений | субагенты |
| Одна проверка по всем файлам, с перепроверкой, перед каждым релизом | workflow |
| Нужно, чтобы исполнители спорили и уточняли друг друга | команда агентов |
Частые вопросы
Чем workflow отличается от субагентов?
У субагентов план держит Claude, и каждый результат возвращается в твой разговор. У workflow план держит скрипт: он хранит промежуточные результаты у себя, может перепроверять находки и запускаться повторно как команда, а в разговор отдаёт только итог.
Как включить команду агентов в Claude Code?
Задай переменную CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Удобнее всего — в блоке env отдельного файла настроек, с которым ты запускаешь одну сессию через claude --settings. Функция экспериментальная и по умолчанию выключена.
Какая схема самая дешёвая?
Один разговор. Каждая следующая ступень добавляет запросы: субагенты и агенты workflow отправляют свои, а команда расходует заметно больше токенов, чем одна сессия. Поэтому выбирай самую простую схему, которой хватает задаче.
Дальше — практика
Весь четвёртый уровень курса «Claude Code: уровень профи» посвящён этим схемам: как выбрать схему, workflows и команды агентов. В каждом уроке есть тренажёр в браузере, а короткая выжимка команд — в шпаргалке по Claude Code. Про основы субагентов у нас есть отдельный разбор — «Как Claude делегирует сам себе».