Различайте Claude Code subagents и agent teams
Subagent выполняет изолированную подзадачу и возвращает результат основной сессии. Agent team состоит из отдельных сессий с общей координацией и прямым обменом сообщениями. Это разные поверхности, и путать их не стоит.
Claude Code рекомендует subagents для самостоятельной работы, которая создаёт много промежуточного контекста: исследование модулей, запуск тестов, анализ логов. Subagent имеет собственное context window, tools и permissions, затем возвращает summary в main conversation. Agent teams - другая поверхность: lead session координирует teammates, а teammates работают в независимых контекстах и могут общаться друг с другом. На дату среза документация помечает teams как experimental и disabled by default, перечисляет ограничения resume, coordination и shutdown; для включения указан флаг CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
Свойство · Subagent · Agent team
- Контекст - Отдельный, результат возвращается main session; Отдельный у каждого teammate
- Коммуникация - В основном через main agent; Teammates могут общаться напрямую
- Лучший fit - Короткое изолированное исследование или проверка; Устойчивая параллельная работа по независимым областям
- Риск - Summary переполняют main context; Стоимость, coordination overhead, file conflicts
Официальная cost-страница указывает ориентир около 7x tokens для agent teams относительно standard session, когда teammates работают в plan mode. Это характеристика конкретного продукта и режима, а не универсальная цена multi-agent паттерна.
Начните с research и review. Официальные best practices agent teams советуют выбирать self-contained задачи и избегать file conflicts. Параллельное редактирование одного тесно связанного участка остаётся плохим fit независимо от удобства UI.
Один продукт разобран. Более общий выбор - фреймворк, и делать его надо по нужному механизму, а не по слогану.