Команды агентов: несколько Claude работают над одной задачей
Что такое Agent Teams в Claude Code, чем отличаются от субагентов и как запустить команду AI-агентов для параллельной работы. Практический гайд с примерами.
Сначала прочитайте:
Зачем это нужно
В предыдущем гайде ты узнал про субагентов — помощников, которые работают параллельно и возвращают результат главному Claude. Это мощный инструмент, но у него есть ограничение: помощники не знают друг о друге. Каждый делает свой кусок работы изолированно — как три человека в разных комнатах, которые не могут переговариваться.
Команды агентов (Agent Teams) снимают это ограничение. Здесь участники команды могут:
- Общаться друг с другом напрямую — не только с главным, но и между собой
- Видеть общий список задач — кто что делает, что уже готово, что заблокировано
- Подхватывать работу — если один участник закончил свои задачи, он берёт следующую из общего списка
- Спорить и проверять друг друга — один нашёл проблему, другой пытается её опровергнуть
Это как разница между тремя фрилансерами (каждый отчитывается тебе отдельно) и слаженной командой с общей доской задач и чатом.
Как это устроено
Когда ты просишь Claude Code создать команду агентов, он выстраивает такую структуру:
- Лид (team lead) — твоя основная сессия Claude. Он создаёт команду, раздаёт задачи и собирает итоговый результат.
- Участники (teammates) — отдельные сессии Claude, каждая со своим контекстом (то есть собственной «памятью» разговора). Они работают независимо, но могут переписываться между собой.
- Общий список задач — задачи проходят через три состояния: «ожидает», «в работе», «готово». Участники сами берут свободные задачи из списка.
- Почтовый ящик — система сообщений между участниками. Любой может написать конкретному коллеге или отправить сообщение всей команде.
Участники автоматически получают контекст проекта — файл CLAUDE.md с инструкциями, подключённые инструменты, навыки (Skills). Но историю твоего разговора с лидом они не видят — только задачу, которую лид им поставил.
Когда команды агентов полезны
1. Параллельная проверка с разных сторон
Ты хочешь проверить свой проект — но не одну вещь, а несколько аспектов одновременно, причём проверяющие должны видеть находки друг друга:
Создай команду агентов для проверки моего сайта. Трое участников: — первый проверяет безопасность: формы, ввод данных, защита от вредоносных запросов — второй проверяет производительность: скорость загрузки, размер файлов, оптимизация картинок — третий проверяет покрытие тестами: какие части кода не протестированы Пусть делятся находками между собой. В конце собери общий отчёт.
Ключевое: участники обмениваются информацией. Проверяющий безопасность находит уязвимое место — и тут же сообщает проверяющему тесты, что туда нужен тест.
2. Расследование проблемы с конкурирующими гипотезами
Пользователи жалуются на баг, но причина неясна. Вместо того чтобы проверять гипотезы одну за другой, ты запускаешь команду, где каждый участник отстаивает свою версию:
Пользователи жалуются, что приложение закрывается после первого сообщения. Создай команду из 4 агентов — каждый расследует свою гипотезу. Пусть спорят между собой и пытаются опровергнуть версии друг друга. Когда придут к консенсусу — зафиксируй результат.
Теория, которая выдержала критику коллег, скорее всего ближе к правде, чем первая попавшаяся идея.
3. Разработка нового функционала по частям
Новая функция затрагивает несколько частей проекта, и каждую часть может делать отдельный участник:
Создай команду агентов для реализации системы уведомлений. Распредели работу: — один участник делает серверную часть (отправка уведомлений) — второй делает интерфейс (как уведомления отображаются на экране) — третий пишет тесты для обоих частей Третий участник должен дождаться, пока первые двое закончат основной код, и только потом начинать тесты.
Обрати внимание: третья задача зависит от первых двух. Система задач это поддерживает — заблокированная задача не начнётся, пока не будут готовы задачи-зависимости.
4. Исследование с нескольких сторон
Тебе нужно сравнить подходы, и исследователи должны спорить между собой:
Мне нужно выбрать подход к хранению данных. Создай команду из трёх исследователей: первый изучает базу данных, второй — файловое хранилище, третий играет адвоката дьявола и ищет слабые места в обоих. Пусть обсуждают. В конце — рекомендация с обоснованием.
Сравнение с субагентами
| Субагенты | Команды агентов | |
|---|---|---|
| Общение | Только с главным Claude — друг о друге не знают | Между собой напрямую + общий список задач |
| Координация | Главный Claude управляет всем | Участники сами берут задачи из общего списка |
| Зависимости задач | Нет — все задачи независимые | Да — задача может ждать завершения другой |
| Лучше всего для | Чёткие изолированные задачи: аудит, генерация контента, research | Сложная работа, где нужны обсуждение и координация |
| Расход | Умеренный | Высокий — каждый участник это отдельная сессия Claude |
| Когда использовать | «Сделай три задачи параллельно и верни результат» | «Работайте командой, обсуждайте, проверяйте друг друга» |
Правило: не нужно общение между помощниками — субагенты (дешевле). Нужна координация или зависимости задач — команда агентов.
Как запустить команду агентов
Шаг 1. Включи функцию
Команды агентов — экспериментальная функция, по умолчанию выключена. Чтобы включить:
- Открой Claude Desktop
- Перейди в настройки Claude Code (Settings)
- Добавь в переменные окружения:
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSсо значением1
После этого перезапусти Claude Code — функция станет доступна.
Шаг 2. Опиши задачу и команду
Открой вкладку Code в Claude Desktop с нужным проектом и напиши запрос. Опиши, что нужно сделать, и какие роли у участников команды:
Создай команду агентов для [задача]. Нужны [число] участников: — [имя/роль]: [что делает] — [имя/роль]: [что делает] — [имя/роль]: [что делает] Когда все закончат — собери результаты в [формат].
Claude создаст команду, запустит участников и начнёт координировать работу.
Шаг 3. Следи за прогрессом и управляй
Во время работы команды ты можешь:
- Переключаться между участниками —
Shift+↓циклически переключает между лидом и участниками - Писать участникам напрямую — переключись на нужного участника и отправь ему сообщение
- Просматривать список задач —
Ctrl+Tпоказывает общую доску задач
В любой момент можешь дать указания конкретному участнику или попросить лида перераспределить работу.
Практический пример: параллельный код-ревью
Допустим, ты сделал большое обновление проекта и хочешь тщательно его проверить перед публикацией.
Промпт:
Создай команду агентов для ревью моих последних изменений. Три ревьюера: — security-reviewer: проверяет безопасность — ввод данных, обработка ошибок, защита от инъекций — perf-reviewer: проверяет производительность — медленные запросы, лишние загрузки, неоптимальные алгоритмы — test-reviewer: проверяет покрытие тестами — какие сценарии не протестированы, какие тесты хрупкие Пусть делятся находками между собой. Если security-reviewer найдёт уязвимость — пусть сразу скажет test-reviewer, что туда нужен тест. В конце собери общий отчёт: что нашли, приоритет каждой находки, рекомендации.
Что произойдёт:
- Claude (лид) создаст команду и запустит трёх участников
- Каждый начнёт проверку своего направления
- Участники обменяются находками — ревьюер безопасности сообщит ревьюеру тестов о непокрытом уязвимом месте
- Лид соберёт всё в один отчёт с приоритетами
Три проверки одновременно вместо трёх последовательных, и качество выше, чем у субагентов — проверяющие видят контекст друг друга.
Ограничения и осторожность
Расход. Каждый участник команды — полноценная сессия Claude со своим окном контекста. Команда из трёх участников потребляет примерно в 3-4 раза больше токенов (единиц оплаты), чем одна сессия. Используй команды только когда координация между участниками реально нужна.
Экспериментальная функция. Команды агентов пока в стадии эксперимента. Возможные проблемы:
- Участник может забыть отметить задачу как выполненную — другие задачи, которые от неё зависят, зависнут
- При возобновлении сессии участники не восстанавливаются — нужно создавать новых
- Одна команда на сессию — закончи работу с текущей командой, прежде чем создавать новую
Конфликты файлов. Как и с субагентами — два участника не должны одновременно редактировать один файл. Разделяй работу так, чтобы каждый участник отвечал за свой набор файлов.
Начни с малого. 3 участника — оптимальный старт. 5-6 задач на каждого участника — хороший баланс. Не запускай 10 агентов сразу — координация станет хаотичной.
Если застрял — команда ведёт себя непредсказуемо, не понимаешь, когда нужна команда, а когда хватит субагентов — запишись на консультацию.
Связь с CLAUDE.md
Все участники команды читают файл CLAUDE.md из корня проекта — правила действуют на всю команду. Если регулярно запускаешь команды для одних и тех же задач, добавь туда инструкции:
## Команды агентов
При код-ревью — команда из трёх ревьюеров: безопасность, производительность, тесты.
Максимум 5 участников. Каждый работает со своим набором файлов.
Что дальше
Ты освоил все инструменты параллельной работы — субагенты и команды агентов. Попробуй применить на своём проекте: параллельный аудит с обсуждением между участниками или расследование бага с конкурирующими гипотезами — хороший первый сценарий.