Содержание
Когда в Claude Code нужно «заставить несколько ИИ работать, поделив задачу между собой», есть два похожих, но разных механизма — subagents и Agent Teams. Названия путают, но их роли и способы координации различаются фундаментально. В этой статье на основе официальной документации разбираем, что собой представляет каждый из них, в чём решающее различие, что и как использовать.
Сразу три ключевых момента. (1) Subagents — встроенная возможность: главный агент делегирует узкую побочную задачу «помощнику со свежим контекстом» и получает обратно только сводку (иерархично, одноразово). (2) Agent Teams — экспериментальная опциональная функция, по умолчанию отключённая. Она работает лишь после того, как вы установите CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 — несколько независимых сессий координируются как равные через общий список задач (одноранговая модель, долговременная). (3) «Вложенность до 5 уровней» — это возможность subagents; Agent Teams не умеют вкладываться (они плоские) — не путайте эти две вещи.
Иерархия или равные?
— делегировать и получить сводку или координироваться на равных
Subagents: главный агент передаёт задачу помощнику и получает результат. Agent Teams: равные участники координируются через общий список задач.
Teams — это по умолчанию выключенная экспериментальная функция — требуется CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
1. Что такое Subagents
Subagents — это специализированные агенты, которые выполняют отдельные виды работы в рамках одной сессии. Согласно официальной документации, «каждый subagent работает в собственном окне контекста, с отдельным системным промптом и определёнными разрешениями на инструменты». Главный агент делегирует автоматически на основании поля description каждого subagent, а subagent работает самостоятельно и возвращает в основной диалог только сводку.
Главное здесь — то, что «каждый subagent работает в свежем, отдельном контексте»: он не видит вашу историю диалога и уже прочитанные вами файлы. Поэтому вы можете поручить ему тяжёлый поиск «снаружи» и получить только вывод, не засоряя основной контекст логами и выводом тестов. Управление — через /agents (вкладки Running / Library). Определяются они в .claude/agents/<name>.md с YAML-фронтматтером (name / description / tools / model). Встроенные включают Explore (Haiku, только чтение), Plan и general-purpose. Subagents могут вкладываться, до 5 уровней в глубину (на глубине 5 инструмент Agent уже не передаётся, поэтому дальше плодиться они не могут). Для общей картины см. Что такое мультиагентная система.
2. Что такое Agent Teams (экспериментально, за флагом)
Agent Teams позволяют координировать несколько сессий Claude Code как «команду». Одна из них — team lead (координирует, распределяет, синтезирует); остальные — teammates — каждый со своей независимой сессией и контекстом — которые общаются напрямую друг с другом через общий список задач и почтовый ящик (mailbox). В отличие от subagents, с отдельными teammates вы можете общаться напрямую.
Важно: Agent Teams — экспериментальная функция, отключённая по умолчанию
Официальная документация прямо заявляет, что «agent teams экспериментальны и отключены по умолчанию». Чтобы их использовать, установите переменную окружения CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 (или через env в settings.json). Без неё при запуске никакой команды не создаётся, и Claude не предложит и не создаст teammates.
Учтите, что изменение в v2.1.178 лишь «убрало этап настройки TeamCreate/TeamDelete, так что при установленном флаге у каждой сессии есть одна неявная команда» — оно не «включило команды по умолчанию». Флаг по-прежнему обязателен.
3. Решающее различие
Если поставить их рядом, способы координации у этих двух механизмов совершенно разные.
| Subagents | Agent Teams | |
|---|---|---|
| Координация | Иерархическая (главный делегирует, агрегирует результаты) | Одноранговая (самокоординация через общий список задач) |
| Связь | Отчитываются только перед вызывающим (никогда не общаются друг с другом) | Teammates обмениваются сообщениями напрямую друг с другом через mailbox |
| Долговечность | Одноразовые (после задачи возвращают сводку) | Долговременные независимые сессии (управляешь ими напрямую) |
| Контекст | Собственный свежий контекст; сводка возвращается главному | Полностью независимы (ничего не сводится обратно автоматически) |
| Стоимость в токенах | Относительно низкая | Высокая (каждый teammate — отдельный экземпляр Claude) |
| Статус | Встроены, всегда доступны | Экспериментальны, за флагом, выключены по умолчанию |
| Вложенность | Subagents вкладываются до 5 уровней | Без вложенности (teammates не могут плодить teammates) |
Одной строкой: Subagents = «главный агент передаёт узкую задачу помощнику со свежим контекстом и получает обратно вывод (иерархично, одноразово, только сводка)». Agent Teams = «несколько долговременных сессий координируются через общий список задач и обмен сообщениями, и вы можете управлять каждой из них (равные, независимые)». Частая ошибка: «вложенность до 5 уровней» — это возможность subagents, тогда как Teams плоские (без вложенности).
4. Что выбрать
Выбирайте по цели — и не будете мучиться. Большинство повседневной работы прекрасно решается subagents (или одной сессией).
Выбирайте по цели
· работа самодостаточна и важен только результат
· нужны ограничения инструментов или модель подешевле
· исполнителям не нужно общаться
· параллельное исследование окупается (параллельное ревью / отладка конкурирующих гипотез / много модулей)
· хочется управлять каждым исполнителем
(принимаете более высокую стоимость + флаг)
· нужны частые туда-обратно
· затрагиваются одни и те же файлы
· это быстрая локальная правка
По умолчанию — «если сомневаешься, одна сессия или subagents».
Берите Agent Teams только для параллельной работы, которой действительно нужна одноранговая координация.
5. Шпаргалка по использованию
Краткий справочник по командам и настройкам.
# --- Subagents (встроены) ---
/agents # менеджер (Running / Library)
.claude/agents/<name>.md # определение проекта (name/description/tools/model)
~/.claude/agents/<name>.md # пользовательское определение (все проекты)
claude --agent code-reviewer # запустить всю сессию как конкретный subagent
@agent-<name> # @-упоминание для явного вызова
# --- Agent Teams (экспериментально, за флагом) ---
# Включается через env (или env в settings.json); по умолчанию ВЫКЛ
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# Затем опишите обычным языком, например: "Создай трёх teammates для ревью PR #142:
# один по безопасности, один по производительности, один по покрытию тестами."
# Отображение через teammateMode (по умолчанию in-process; для разделённых панелей нужен tmux/iTerm2)В файле определения subagent можно ограничить инструменты через tools или направить на более лёгкую модель вроде haiku через model. О создании и проектировании агентов см. Как построить мультиагентную систему и Как создать ИИ-агента.
6. Оговорки про Agent Teams
Agent Teams мощны, но несут ограничения экспериментальной стадии и стоимость. Узнайте о них до внедрения.
(1) Одна команда на сессию, без вложенности — teammates не могут плодить teammates, а лид фиксирован. (2) Высокий расход токенов (каждый teammate — отдельный экземпляр Claude); рекомендация — 3-5 teammates. (3) Teammates не изолированы в worktree, поэтому, если они трогают одни и те же файлы, они перезаписывают работу друг друга — разделяйте файлы вручную. (4) Как у экспериментальной функции, есть ограничения вроде того, что /resume и /rewind не восстанавливают in-process teammates. (5) Для отображения разделёнными панелями нужен tmux или iTerm2 (некоторые терминалы, например встроенный в VS Code, не поддерживаются). Короче, используйте это лишь тогда, когда выгода параллельной координации перевешивает стоимость и усилия.
Итоги
В Claude Code и subagents, и Agent Teams «делят работу между ИИ», но их модели координации различаются. Subagents встроены: главный агент делегирует узкую задачу помощнику со свежим контекстом и получает обратно только сводку (иерархично, одноразово, не общаются друг с другом, вкладываются до 5 уровней). Agent Teams — экспериментальная опциональная функция, по умолчанию выключенная (нужен CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1): несколько независимых сессий координируются как равные через общий список задач и обмен сообщениями (долговременные, управляешь каждой, без вложенности).
Как выбирать: «нужен только результат / не хочется засорять контекст → subagents», «параллельная работа, где исполнители должны делиться и координироваться → Agent Teams», «последовательно / одни и те же файлы / быстрая правка → одна сессия». Частая путаница: «вложенность до 5 уровней» — это возможность subagents; Teams плоские. И учтите, что v2.1.178 упростила запуск команд — она не «включила их по умолчанию». Teams дороги и экспериментальны, поэтому ограничивайте их случаями, где координация окупается. По теме: Что такое мультиагентная система, как её построить, наблюдаемость ИИ.
FAQ
Q. Чем различаются subagents и Agent Teams?
A. Их координация фундаментально различна. Subagents иерархичны: главный агент делегирует узкую задачу помощнику со свежим контекстом и получает обратно только сводку (помощники не общаются друг с другом; одноразовы). Agent Teams одноранговы: несколько независимых сессий координируются через общий список задач и почтовый ящик, и вы можете управлять каждой (долговременны). Subagents встроены; Agent Teams экспериментальны и требуют флага.
Q. Можно ли использовать Agent Teams сразу?
A. Нет — они отключены по умолчанию. Нужно установить CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 в env (или в env файла settings.json). v2.1.178 лишь упростила запуск (она «убрала этап настройки TeamCreate, так что при установленном флаге у каждой сессии есть одна неявная команда») — она не «включила команды по умолчанию». Флаг по-прежнему обязателен.
Q. О чём из них речь, когда говорят «вкладывается до 5 уровней»?
A. О subagents. Subagent может порождать собственных subagents, до 5 уровней в глубину (на глубине 5 дальше уже нельзя). Agent Teams вкладываться не умеют — teammates не могут плодить teammates, и только лид управляет командой. Не путайте эти две вещи.
Q. Не могу понять, что использовать.
A. В большинстве случаев достаточно одной сессии или subagents. Если вам нужен только результат и не хочется, чтобы обильный вывод засорял основной контекст, используйте subagents. Если исполнители должны делиться находками, перепроверять друг друга и самокоординироваться в параллельной работе (параллельное ревью, отладка конкурирующих гипотез, разработка нескольких модулей) и вы хотите управлять каждым — используйте Agent Teams. Для последовательной работы, частых туда-обратно или работы с одними и теми же файлами подходит одна сессия.
Q. На что обратить внимание с Agent Teams?
A. Высокий расход токенов (каждый teammate — отдельный экземпляр; рекомендуется 3-5), одна команда на сессию без вложенности, teammates не изолированы в worktree, поэтому конфликтуют на одних и тех же файлах (разделяйте вручную), экспериментальные ограничения у /resume и /rewind, а для разделённых панелей нужен tmux/iTerm2. Используйте это лишь для параллельной работы, где координация перевешивает стоимость.
