# Субагенты, workflows или команда агентов: как выбрать в Claude Code
Канонический URL: https://zero2claude.ru/blog/subagents-workflows-agent-teams
Дата: 2026-10-14
Теги: claude-code, агенты, автоматизация
В Claude Code три способа раздать работу нескольким исполнителям: субагенты, dynamic workflows и команды агентов. Разница в том, кто держит план. Три вопроса, которые помогут выбрать самую дешёвую схему, которой хватит задаче.
Когда задача перестаёт помещаться в один разговор, хочется сразу «нанять побольше агентов». В Claude Code для этого есть целых три механизма: [субагенты](/glossary/subagent), dynamic workflows и команды агентов. Со стороны они похожи — все раздают части работы нескольким исполнителям. Но устроены по-разному и стоят по-разному.
Хорошая новость: чтобы выбрать, не нужно помнить всю документацию. Достаточно одного вопроса — **кто держит план** — и трёх проверок по порядку.
## Кто держит план
| Схема | Кто держит план | Куда приходят результаты |
|---|---|---|
| Один разговор | ты и Claude в одном контексте | сразу в разговор |
| Субагенты | Claude решает ход за ходом | каждый результат возвращается в твой разговор |
| Workflow | скрипт, который написал Claude | промежуточные итоги остаются в скрипте, в разговор приходит только финал |
| Команда агентов | ведущая сессия; напарники пишут друг другу напрямую | через ведущего и сообщения между напарниками |
Отсюда видно, почему схемы нельзя считать взаимозаменяемыми. Субагенты — это делегирование на словах: Claude каждый раз заново решает, кого позвать. Workflow превращает план в код. Команда — это несколько полноценных сессий, которые спорят друг с другом.
## Три вопроса по порядку
Каждая схема сложнее одного разговора добавляет расход: каждый субагент и каждый агент workflow отправляет свои запросы, а команда расходует заметно больше токенов, чем одна сессия. Поэтому задавай вопросы именно в таком порядке и останавливайся на первом «да»:
1. **Справится ли один разговор, не переполнив контекст?** Да — оставайся в нём.
2. **Должны ли исполнители общаться между собой?** Да — команда агентов.
3. **Нужно много агентов, перекрёстная проверка находок или повторный запуск?** Да — workflow. Нет — субагенты.
Теперь — по каждой схеме на живом примере.
## Субагенты: три независимых поручения
Задача: кратко описать новичку, что лежит в папках `src`, `test` и `docs`. В одном разговоре контекст забьётся содержимым файлов, которое потом не понадобится. Описаниям не нужно общаться между собой, и задача разовая. Значит, субагенты:
```text
Изучи папки src, test и docs параллельно, отдельными субагентами, и дай по два предложения о каждой.
```
В интерактивной сессии субагенты по умолчанию работают в фоне, а поле ввода остаётся свободным. `/tasks` покажет список субагентов с состоянием и моделью, а `Enter` на строке откроет переписку конкретного субагента. После работы `/usage` на планах Pro, Max, Team и Enterprise покажет, сколько ушло на субагентов, навыки, плагины и MCP-серверы. Это оценка, а не счёт.
Хочешь видеть, кого Claude на самом деле запускал? Повесь [хук](/glossary/hooks) `SubagentStart`: он срабатывает при старте каждого субагента и получает `agent_id` и `agent_type`. Записывай их в журнал, и через неделю будет понятно, где делегирование окупается.
## Workflow: когда план должен быть кодом
Если задаче нужно много агентов, перепроверка находок или повторный прогон, — это [dynamic workflow](/glossary/dynamic-workflow). Это скрипт на JavaScript, который Claude пишет под задачу. Скрипт сам запускает агентов, держит их результаты в своих переменных, а в разговор отдаёт только итог.
Попросить просто — достаточно слова «workflow» в запросе:
```text
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 Claude Code спрашивает только перед самым первым запуском workflow: любое «Да» записывает согласие в пользовательские настройки, и дальше прогоны стартуют без вопроса. Читай каждый скрипт до одобрения и пробуй новый workflow сначала на одной маленькой папке.
## Команда агентов: когда нужен спор
Команда — последняя ступень. Твоя сессия становится ведущей и запускает напарников, каждого в своём контексте. Напарники пишут друг другу напрямую, и ты тоже можешь написать любому. Субагенты так не умеют: они в основном просто возвращают результат.
Где это реально нужно? Там, где одно мнение опасно. Классика — отладка с неизвестной причиной: три напарника, у каждого своя гипотеза, и каждый пытается опровергнуть версии остальных. Ведущий записывает объяснение, которое выдержало спор.
Важно знать до включения:
- функция **экспериментальная и выключена по умолчанию**, её включает переменная `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` — лучше в отдельном файле настроек, который ты передаёшь через `--settings`, а не глобально;
- напарник загружает твой [CLAUDE.md](/glossary/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»](/blog/claude-code-worktree).
## Шпаргалка выбора
| Ситуация | Схема |
|---|---|
| Задача умещается в контекст | один разговор |
| Несколько независимых разовых поручений | субагенты |
| Одна проверка по всем файлам, с перепроверкой, перед каждым релизом | workflow |
| Нужно, чтобы исполнители спорили и уточняли друг друга | команда агентов |
## Частые вопросы
У субагентов план держит Claude, и каждый результат возвращается в твой разговор. У workflow план держит скрипт: он хранит промежуточные результаты у себя, может перепроверять находки и запускаться повторно как команда, а в разговор отдаёт только итог.
Задай переменную `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`. Удобнее всего — в блоке `env` отдельного файла настроек, с которым ты запускаешь одну сессию через `claude --settings`. Функция экспериментальная и по умолчанию выключена.
Один разговор. Каждая следующая ступень добавляет запросы: субагенты и агенты workflow отправляют свои, а команда расходует заметно больше токенов, чем одна сессия. Поэтому выбирай самую простую схему, которой хватает задаче.
## Дальше — практика
Весь четвёртый уровень курса «Claude Code: уровень профи» посвящён этим схемам: [как выбрать схему](/learn/claude-code-pro/4-2-kakuyu-shemu-vybrat), [workflows](/learn/claude-code-pro/4-3-workflows-scenarii-dlya-agentov) и [команды агентов](/learn/claude-code-pro/4-4-komandy-agentov). В каждом уроке есть тренажёр в браузере, а короткая выжимка команд — в [шпаргалке по Claude Code](/claude-code-shpargalka). Про основы субагентов у нас есть отдельный разбор — [«Как Claude делегирует сам себе»](/blog/subagents-in-practice).