AI

Agent Teams в Claude Code: как запустить команду AI-агентов

Пошаговая инструкция по настройке Agent Teams в Claude Code. Несколько AI-агентов работают параллельно, общаются между собой и координируют задачи через общий список.

Pavel Matveev

Pavel Matveev

— 3 min read
Agent Teams в Claude Code: как запустить команду AI-агентов
TL;DR: В Claude Code появились Agent Teams — можно запустить несколько AI-агентов, которые работают параллельно, обмениваются сообщениями и координируют задачи через общий список. Один агент выступает лидером, остальные работают самостоятельно. Фича экспериментальная, но уже рабочая.

Помнишь, я писал про TeammateTool — скрытую мультиагентную систему, которую нашли в бинарнике Claude Code? Так вот, Anthropic её официально выкатили. Называется Agent Teams, и это уже не просто подагенты, которые выполняют одну задачу и возвращают результат. Тут агенты реально общаются друг с другом, спорят и сами разбирают задачи.

Я поковырялся с этим и собрал инструкцию — как включить, запустить и не потерять кучу токенов впустую.

Когда это нужно (а когда нет)

Сразу оговорюсь: Agent Teams жрут токены. Каждый агент — отдельная сессия Claude со своим контекстным окном. Если задача последовательная или касается одного файла, обычная сессия или подагенты справятся лучше и дешевле.

А вот где команды агентов реально полезны:

  • Код-ревью с разных сторон — один смотрит на безопасность, другой на перформанс, третий проверяет тесты
  • Дебаг с конкурирующими гипотезами — агенты параллельно проверяют разные теории и спорят между собой
  • Разработка новых модулей — каждый агент пилит свой кусок, не мешая остальным
  • Кросс-слойные изменения — фронт, бэк и тесты разнесены по разным агентам

Чем отличается от подагентов

Подагенты (субагенты) — это рабочие, которые выполнили задачу и вернули результат. Всё общение идёт через главного агента.

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

Если нужно быстро получить ответ и забыть — подагенты. Если задача требует обсуждения, взаимной проверки или параллельной работы над разными частями — Agent Teams.

Включение

Фича экспериментальная и выключена по умолчанию. Чтобы включить, добавь переменную окружения в settings.json:

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

Или можно задать переменную прямо в шелле перед запуском Claude Code.

Запуск команды

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

Пример промпта:

Создай команду агентов для ревью PR #142. Три ревьюера:
- один проверяет безопасность
- один смотрит на производительность
- один валидирует тестовое покрытие
Пусть проверят и соберут результаты.

Claude создаст команду, раздаст задачи и начнёт координировать работу.

Можно и попроще:

Я проектирую CLI-тул для трекинга TODO-комментариев в коде.
Создай команду агентов: один на UX, один на архитектуру,
один играет роль devil's advocate.

Режимы отображения

Два варианта:

In-process — все агенты работают в одном терминале. Переключаешься между ними через Shift+Up/Down. Работает везде, ничего дополнительно ставить не надо.

Split panes — каждый агент в своей панели. Видишь всех одновременно, кликаешь в панель для прямого взаимодействия. Нужен tmux или iTerm2.

Для iTerm2 надо установить it2 CLI, затем включить Python API в iTerm2 → Settings → General → Magic → Enable Python API.

По умолчанию стоит auto — если ты уже внутри tmux, будет split panes, иначе in-process. Можно переключить:

{
  "teammateMode": "in-process"
}

Или для одной сессии:

claude --teammate-mode in-process

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

Вся координация идёт через лидера на естественном языке. Но ты можешь и напрямую общаться с любым агентом.

Прямое общение с агентами

В режиме in-process — Shift+Up/Down для выбора агента, потом просто пишешь. Enter — просмотр сессии агента, Escape — прервать текущий ход. Ctrl+T — показать список задач.

В split panes — кликни в панель нужного агента.

Задачи и координация

У команды общий список задач с тремя статусами: pending, in progress, completed. Задачи могут зависеть друг от друга — заблокированная задача не будет взята в работу, пока зависимости не закроются.

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

Режим делегирования

Иногда лидер начинает сам писать код вместо того, чтобы ждать агентов. Чтобы этого избежать, нажми Shift+Tab — включится delegate mode. Лидер сможет только координировать: создавать агентов, писать сообщения, управлять задачами. Без прямого доступа к коду.

Требование плана перед работой

Для сложных задач можно потребовать, чтобы агент сначала составил план:

Запусти агента-архитектора для рефакторинга модуля авторизации.
Потребуй утверждение плана до начала изменений.

Агент будет работать в read-only режиме, пока лидер не одобрит план. Если план отклонён — агент получает фидбэк и переделывает.

Как это устроено внутри

Команда состоит из четырёх компонентов:

  • Лидер — основная сессия, которая создаёт команду и координирует
  • Агенты — отдельные инстансы Claude Code, каждый со своим контекстом
  • Список задач — общий для всей команды
  • Почтовый ящик — система обмена сообщениями между агентами

Данные хранятся локально: - Конфиг команды: ~/.claude/teams/{team-name}/config.json - Задачи: ~/.claude/tasks/{team-name}/

Каждый агент при запуске получает тот же проектный контекст, что и обычная сессия — CLAUDE.md, MCP-серверы, скиллы. Но история разговора лидера не передаётся. Поэтому важно давать агентам достаточно контекста в промпте при создании.

Ограничения

Фича экспериментальная, и ограничения пока серьёзные:

  • /resume и /rewind не восстанавливают in-process агентов. После возобновления сессии лидер может пытаться писать агентам, которых уже нет
  • Агенты иногда забывают отметить задачу как выполненную, что блокирует зависимые задачи
  • Завершение работы агента может быть медленным — он дожидается окончания текущей операции
  • Одна команда на сессию. Нужно очистить текущую перед созданием новой
  • Агенты не могут создавать свои команды (нет вложенных команд)
  • Лидер фиксирован на всю жизнь команды
  • Split panes не работают в VS Code terminal, Windows Terminal и Ghostty

Что ещё почитать