Agent Teams в Claude Code: как устроены команды агентов изнутри

Claude Code получил крупное обновление агентной системы — Agent Teams. Это не косметическая итерация старой модели «задача + суб-агент», а принципиально другая модель исполнения: 3–5 независимых инстансов Claude Code работают над одним проектом, делят контекст, обмениваются сообщениями и координируются через общий список задач.

Чем команды отличаются от суб-агентов

Старая модель (суб-агенты): главный агент вызывает инструмент Task → поднимается суб-агент → работает в изоляции → сессия завершается → главному возвращается только краткое резюме. Никакого общения по ходу работы.

Новая модель (Agent Teams): общий список задач, обмен сообщениями между агентами и явное управление жизненным циклом (запуск и остановка участников).

flowchart TD
  L["Team Lead<br/>(главный агент)"] -->|"создаёт команду и задачи"| T[".claude/teams/ + tasks/"]
  L -->|"delegate / сообщения"| A1["Агент 1"]
  L --> A2["Агент 2"]
  L --> A3["Агент 3"]
  A1 <-->|"sendMessage · inbox"| A2
  A2 <-->|"споры и проверка гипотез"| A3
  A1 -->|"taskUpdate: беру задачу"| T
  A3 -->|"статусы задач"| T

Как включить

1. Обновите Claude Code до последней версии.
2. Agent Teams пока за экспериментальным флагом — добавьте его в глобальный settings.json и перезапустите терминал.
3. Команда создаётся, когда промпт явно просит собрать команду:

«Проектирую CLI-инструмент для отслеживания TODO-комментариев. Собери команду агентов и посмотри на задачу с разных сторон: один отвечает за UX, второй — за архитектуру, третий играет адвоката дьявола».

Лучший способ наблюдать за командой — многопанельный терминал (tmux или iTerm2 с включённым Python API): отдельная панель у тим-лида и у каждого агента. Можно кликнуть в любую панель, смотреть работу агента вживую и даже писать ему напрямую.

Пять внутренних инструментов

Автор вытащил из логов механику целиком:

1. TeamCreate — создаёт папку команды в .claude/teams/. Пока это только каркас, агентов ещё нет.
2. TaskCreate — создаёт задачи (JSON-файлы в .claude/tasks/<team-id>): ID, описание, статус, владелец, зависимости (blocks / blocked_by). Задачи раздаёт тим-лид сверху вниз, либо агенты сами разбирают их из общего списка.
3. Task — тот же инструмент, что поднимал суб-агентов, но с новыми параметрами name и team_name: с ними вместо изолированного суб-процесса запускается участник команды.
4. taskUpdate — агент отмечает: взял задачу, работает, закончил.
5. sendMessage — личные сообщения агент→агент и broadcast на всю команду. Под капотом сообщения пишутся в inbox/ каждого агента и подмешиваются в его диалог как новые реплики. Остановка тоже через сообщения: тим-лид шлёт shutdown_request, агент подтверждает.

Когда команды лучше суб-агентов

Показательный пример из официальной документации — глубокая отладка:

«Пользователи жалуются, что приложение закрывается после одного сообщения. Подними 5 агентов с разными гипотезами. Пусть они спорят и опровергают теории друг друга, как в научном дебате. Зафиксируй консенсус в документе».

Суб-агенты такое не умеют в принципе: они не видят друг друга. Команда — умеет, и автор подтверждает, что на реальном проекте это сработало отлично.

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

Что здесь важно, если вы не разработчик

От себя. Посмотрите на паттерн, а не на код: несколько специализированных «сотрудников» с разными ролями, общим списком задач и правом спорить друг с другом — это модель любого сильного отдела, включая маркетинговый. Именно так я собираю AI-системы клиентам: агент-квалификатор, агент-контентщик и аналитика не работают в вакууме — они обмениваются данными, и решения рождаются из их «спора». Инфраструктура для этого, как видите, уже становится штатной функцией инструментов.

Хотите такую «команду» под ваш маркетинг? Напишите «система» в Telegram — за 15 минут разберём, какие роли нужны именно вам.