Содержание
Когда в Claude Code нужно «заставить несколько ИИ работать, поделив задачу между собой», есть два похожих, но разных механизма — subagents и Agent Teams. Названия путают, но их роли и способы координации различаются фундаментально. В этой статье на основе официальной документации разбираем, что собой представляет каждый из них, в чём решающее различие, что и как использовать.
Сразу три ключевых момента. (1) Subagents — встроенная возможность: главный агент делегирует узкую побочную задачу «помощнику со свежим контекстом» и получает обратно только сводку (иерархично, запускаются под задачу). (2) Agent Teams — экспериментальная опциональная функция, по умолчанию отключённая. Она работает лишь после того, как вы установите CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 — несколько независимых сессий координируются как равные через общий список задач (одноранговая модель, долговременная). (3) Вкладываться умеют только subagents (по умолчанию до 3 уровней ниже основного диалога); Agent Teams не умеют вкладываться (они плоские) — не путайте эти две вещи.
Иерархия или равные?
— делегировать и получить сводку или координироваться на равных
Subagents: главный агент передаёт задачу помощнику и получает результат. Agent Teams: равные участники координируются через общий список задач.
Teams — это по умолчанию выключенная экспериментальная функция — требуется CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
1. Что такое Subagents
Subagents — это специализированные агенты, которые выполняют отдельные виды работы в рамках одной сессии. Согласно официальной документации, «каждый субагент работает в собственном окне контекста, с отдельным системным промптом и определёнными разрешениями на инструменты». Главный агент делегирует автоматически на основании поля description каждого субагента, а субагент работает самостоятельно и возвращает в основной диалог только сводку.
Главное здесь — то, что «каждый субагент работает в свежем, отдельном контексте»: он не видит вашу историю диалога и уже прочитанные вами файлы. Поэтому вы можете поручить ему тяжёлый поиск «снаружи» и получить только вывод, не засоряя основной контекст логами и выводом тестов. Чтобы создать или изменить субагента, попросите об этом Claude или отредактируйте файл определения напрямую (начиная с v2.1.198 /agents больше не открывает интерактивный мастер создания). Определяются они в .claude/agents/<name>.md с YAML-фронтматтером (name / description / tools / model). Встроенные включают Explore (только чтение; начиная с v2.1.198 наследует модель основного диалога, в Claude API — не выше Opus), Plan и general-purpose. Субагенты могут вкладываться, по умолчанию до 3 уровней ниже основного диалога (v2.1.219+; на предельной глубине инструмент Agent уже не передаётся, поэтому дальше плодиться они не могут. Предел меняется через CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH; значение 1 отключает вложенность). Для общей картины см. Что такое мультиагентная система.
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) |
| Статус | Встроены, всегда доступны | Экспериментальны, за флагом, выключены по умолчанию |
| Вложенность | По умолчанию до 3 уровней вниз (предел настраивается) | Без вложенности (teammates не могут плодить teammates) |
Одной строкой: Subagents = «главный агент передаёт узкую задачу помощнику со свежим контекстом и получает обратно вывод (иерархично, под задачу, только сводка)». Agent Teams = «несколько долговременных сессий координируются через общий список задач и обмен сообщениями, и вы можете управлять каждой из них (равные, независимые)». Частая ошибка: вложенность — это возможность subagents, тогда как Teams плоские (без вложенности).
4. Что выбрать
Выбирайте по цели — и не будете мучиться. Большинство повседневной работы прекрасно решается subagents (или одной сессией).
Выбирайте по цели
· работа самодостаточна и важен только результат
· нужны ограничения инструментов или модель подешевле
· исполнителям не нужно общаться
· параллельное исследование окупается (параллельное ревью / отладка конкурирующих гипотез / много модулей)
· хочется управлять каждым исполнителем
(принимаете более высокую стоимость + флаг)
· нужны частые туда-обратно
· затрагиваются одни и те же файлы
· это быстрая локальная правка
По умолчанию — «если сомневаешься, одна сессия или subagents».
Берите Agent Teams только для параллельной работы, которой действительно нужна одноранговая координация.
5. Шпаргалка по использованию
Краткий справочник по командам и настройкам.
# --- Subagents (встроены) ---
/agents # с v2.1.198 без мастера (попросите Claude или правьте файлы ниже)
.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)В файле определения субагента можно ограничить инструменты через tools или направить на более лёгкую модель вроде haiku через model. Как определяется модель и что показала проверка на разных моделях, см. Claude Code: как запускать субагентов на другой модели. О создании и проектировании агентов см. Как построить мультиагентную систему и Как создать ИИ-агента.
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 встроены: главный агент делегирует узкую задачу помощнику со свежим контекстом и получает обратно только сводку (иерархично, под задачу, отчитываются в основном вызывающему, по умолчанию вкладываются до 3 уровней). Agent Teams — экспериментальная опциональная функция, по умолчанию выключенная (нужен CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1): несколько независимых сессий координируются как равные через общий список задач и обмен сообщениями (долговременные, управляешь каждой, без вложенности).
Как выбирать: «нужен только результат / не хочется засорять контекст → subagents», «параллельная работа, где исполнители должны делиться и координироваться → Agent Teams», «последовательно / одни и те же файлы / быстрая правка → одна сессия». Частая путаница: вложенность — это возможность subagents; Teams плоские. И учтите, что v2.1.178 упростила запуск команд — она не «включила их по умолчанию». Teams дороги и экспериментальны, поэтому ограничивайте их случаями, где координация окупается. При этом оба сравниваемых здесь способа работают на вашей собственной машине. Облачный вариант, который продолжает работать и после того, как вы закрыли ноутбук, появился в сентябре 2026 года: это Projects, где Claude сам открывает треды и следит за ними. По теме: Что такое мультиагентная система, как её построить, наблюдаемость ИИ.
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. Кто из них умеет вкладываться?
A. Subagents. Субагент может порождать собственных субагентов, по умолчанию до 3 уровней ниже основного диалога (v2.1.219+; предел меняется через CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH, значение 1 отключает вложенность). Agent Teams вкладываться не умеют — teammates не могут плодить teammates, и только лид управляет командой. Не путайте эти две вещи.
Q. Есть ли способы распараллелить работу, кроме этих двух?
A. Есть. Официальная документация раскладывает распараллеливание на пять подходов: помимо двух из этой статьи, есть agent view (dispatch), динамические рабочие процессы и добавившиеся в сентябре 2026 года Projects. Agent view — это экран, который открывается командой claude agents и где вы передаёте независимые задачи, а результаты забираете позже (research preview). Subagents означают «Claude делегирует внутри одного диалога», Agent Teams — «всем распоряжается Claude», тогда как в agent view распоряжаетесь вы сами. Модель изоляции и то, за чем здесь нужно следить, разобраны в отдельной статье.
Q. Не могу понять, что использовать.
A. В большинстве случаев достаточно одной сессии или subagents. Если вам нужен только результат и не хочется, чтобы обильный вывод засорял основной контекст, используйте subagents. Если исполнители должны делиться находками, перепроверять друг друга и самокоординироваться в параллельной работе (параллельное ревью, отладка конкурирующих гипотез, разработка нескольких модулей) и вы хотите управлять каждым — используйте Agent Teams. Для последовательной работы, частых туда-обратно или работы с одними и теми же файлами подходит одна сессия.
Q. На что обратить внимание с Agent Teams?
A. Высокий расход токенов (каждый teammate — отдельный экземпляр; рекомендуется 3-5), одна команда на сессию без вложенности, teammates не изолированы в worktree, поэтому конфликтуют на одних и тех же файлах (разделяйте вручную), экспериментальные ограничения у /resume и /rewind, а для разделённых панелей нужен tmux/iTerm2. Используйте это лишь для параллельной работы, где координация перевешивает стоимость.
