Agent Team в Claude Code: когда одного агента в терминале уже не хватает

Claude Code давно вырос из «чата в терминале». Он читает проект, правит файлы, гоняет тесты, ковыряет логи. Но у обычного режима есть потолок: одна сессия — один контекст и одна линия мыслей. Пока задача простая, это норм. А вот когда надо одновременно посмотреть на безопасность, тесты, производительность и архитектуру — контекст распухает, агент скачет между темами, половина деталей теряется.

Для таких случаев есть экспериментальный режим Agent Team. Ниже — что это, как включить и где он правда помогает, а где только мешает.

Что это такое

Если коротко: вместо одного агента запускается команда.

Одна сессия становится team lead — координирует, ведёт общий список задач, в конце собирает итог. Остальные — teammates, каждый со своим контекстом. Главное отличие от субагентов: тиммейты переписываются друг с другом напрямую и сами разбирают задачи из общего списка, а не просто отчитываются наверх.

Грубо:

Обычный режим: ты → Claude → результат Agent Team: ты → lead → несколько teammates → они спорят между собой → итог

Чем отличается от субагентов

Субагенты (/agents) у вас, скорее всего, уже есть. Разница вот в чём:

• Субагент работает внутри основной сессии и возвращает результат наверх. С другими субагентами он не общается.

• Тиммейт — отдельная сессия. Они видят общий task list, могут переписываться и проверять выводы друг друга.

Надо быстро глянуть один файл — берите субагент. Надо, чтобы несколько агентов независимо раскопали разные гипотезы и сошлись на одной — это Agent Team.

Полезный момент: свои кастомные субагенты можно подключать как тип тиммейта — указываете subagent_type, и команда поднимет участника с этой ролью. Только переносятся не все поля: tools, model и тело промпта подхватятся, а skills и mcpServers из frontmatter для тиммейта не применятся.

Как включить

Фича выключена по умолчанию. Сначала версия:

claude —version

Нужна 2.1.32 или новее. Дальше переменная окружения:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

Или насовсем — в ~/.claude/settings.json:

{ «env»: { «CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS»: «1» } }

Отдельной команды вроде claude team create нет. Команда собирается обычным промптом:

Создай agent team из 3 тиммейтов: — backend reviewer — frontend reviewer — test reviewer Раздели работу между ними, пусть обсудят находки, потом дай мне общий итог.

Создавать команду без вашего согласия Claude не станет: вы либо сами просите team, либо он предлагает, а вы подтверждаете. Дальше lead заведёт общий список задач и начнёт раздавать работу.

Два режима отображения

Где смотреть, кто чем занят:

in-process — все тиммейты в одном терминале:

claude —teammate-mode in-process

Удобно на VPS и по SSH, ничего настраивать не надо. Переключение между участниками — Shift+Down (после последнего возвращает к lead), Enter — открыть сессию тиммейта, Escape — прервать его текущий ход, Ctrl+T — общий список задач.

Split panes — каждый тиммейт в своей панели, видно всех сразу:

claude —teammate-mode tmux

Нужен tmux или iTerm2 (с включённым it2 CLI). По умолчанию режим auto: если вы уже в tmux/iTerm2 — будут панели, иначе in-process. На голом сервере по SSH это in-process, на локальной машине с большим экраном удобнее панели.

Где реально помогает

Не везде. Если попросить команду «поправить одну функцию», они будут мешать друг другу.

Хорошо заходит, когда работу можно честно поделить:

• Code review с разных сторон. Один смотрит безопасность, второй производительность, третий тесты. Lead сводит в один список по приоритетам.

• Поиск мутного бага. Пять тиммейтов копают пять гипотез — фронт, API, база, сессии, гонки — и не ходят по одной тропе.

• Архитектурный спор. REST или gRPC, монолит или сервисы. Ценность не в параллельности, а в том, что агенты проверяют аргументы друг друга.

И чего я бы не делал:

• мелких правок — координация съест больше токенов, чем сама работа;

• задач в одном файле — будут конфликты, лучше заранее разнести зоны: «каждый правит только свою директорию»;

• строго последовательных шагов вроде «сначала миграция, потом API, потом фронт» — параллелить нечего.

Пара слов про промпт

Плохо: «Создай команду и улучши проект». Дальше — хаос.

Нормально — сразу задать рамки: сколько тиммейтов, роли, можно ли трогать файлы, нужен ли plan approval, в каком виде ждёте результат, что трогать нельзя. Для команды я почти всегда добавляю:

Сначала покажи мне план и не давай тиммейтам трогать файлы, пока я не отвечу.

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

И не забывайте закрывать команду, когда закончили:

Почисти команду.

Активные тиммейты — это живые сессии, которые продолжают жечь токены. Чистку всегда запускает lead, и только когда все тиммейты остановлены.

Итого

Agent Team — реально может сделать большие задачи быстрее и лучше за счет общего канала общения.

Источник: habr.com