Зачем это нужно#

Иногда одна задача слишком большая для одного агента. Представьте ремонт квартиры: электрик, сантехник и маляр работают параллельно, каждый в своей зоне, но координируют действия.

Agent Teams (команды агентов) — это функция Claude Code, где несколько экземпляров Claude работают одновременно над разными аспектами задачи:

• 🔀 Параллельная работа — несколько задач выполняются одновременно
• 💬 Общение между агентами — участники команды могут обмениваться информацией
• 🎯 Специализация — каждый агент отвечает за свою область
• 👤 Прямой доступ — вы можете общаться с любым участником команды напрямую

Agent Teams vs Субагенты#

В Claude Code есть два способа параллельной работы. Важно понимать разницу:

Правило: используйте субагентов для простых задач, Agent Teams — для сложных, требующих координации.

Включение Agent Teams#

Agent Teams отключены по умолчанию. Включите их одним из способов:

Способ 1: Через переменную окружения#

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude

Способ 2: Через settings.json#

Добавьте в файл .claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Запуск команды агентов#

После включения просто опишите задачу и структуру команды на естественном языке:

Пример 1: Исследование и ревью#

Создай команду из 3 агентов:
1. Первый агент — исследует архитектуру проекта и документирует её
2. Второй агент — проверяет код на безопасность
3. Третий агент — проверяет тестовое покрытие

Каждый пусть работает параллельно и поделится результатами.

Пример 2: Реализация фичи#

Мне нужна команда для реализации системы аутентификации:
- Агент "backend" — создаёт API-эндпоинты для login/logout/register
- Агент "frontend" — создаёт UI формы входа и регистрации
- Агент "tests" — пишет тесты для обоих частей

Координируйтесь между собой по API-контрактам.

Пример 3: Отладка с конкурирующими гипотезами#

Есть баг: приложение зависает при загрузке файлов > 10MB.

Создай команду для отладки:
- Агент 1: проверяет гипотезу утечки памяти
- Агент 2: проверяет гипотезу таймаута сети  
- Агент 3: проверяет гипотезу проблемы с буферизацией

Пусть каждый исследует свою гипотезу и доложит результаты.

Управление командой#

Просмотр статуса#

Claude Code покажет статус каждого участника команды: кто чем занят, кто завершил работу.

Общение с конкретным агентом#

Вы можете обратиться к любому участнику команды напрямую, не через лидера.

Назначение задач#

Лидер команды координирует работу, но вы можете вмешиваться и перенаправлять задачи.

Когда Agent Teams эффективны#

✅ Хорошие сценарии:

• Исследование разных аспектов проблемы параллельно
• Новые модули/фичи, где агенты работают в разных файлах
• Отладка с несколькими гипотезами одновременно
• Кросс-слойная работа: фронтенд + бэкенд + тесты

❌ Неподходящие сценарии:

• Последовательные задачи (где каждый шаг зависит от предыдущего)
• Работа в одном и том же файле (конфликты изменений)
• Задачи с множеством зависимостей
• Простые задачи (избыточная координация)

Лучшие практики#

1. Чёткие роли — каждый агент должен иметь ясную зону ответственности
2. Минимум пересечений — агенты не должны редактировать одни и те же файлы
3. Конкретные задачи — общие формулировки приводят к дублированию работы
4. Помните о токенах — каждый агент тратит токены отдельно, команда обходится дороже
5. Начинайте с малого — попробуйте 2-3 агента, прежде чем создавать большую команду

Итоги урока#

• Agent Teams — это несколько экземпляров Claude Code, работающих параллельно
• В отличие от субагентов, участники команды могут общаться друг с другом
• Включается через переменную CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
• Описывайте команду и задачи на естественном языке
• Лучше всего работает для параллельных задач без пересечений в файлах
• Не используйте для последовательных задач — это будет дороже и медленнее
• Каждый агент — отдельная сессия, расход токенов выше