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 — реально может сделать большие задачи быстрее и лучше за счет общего канала общения.