Agent Teams в Claude Code — как запустить 5 агентов на одном репо и не сойти с ума

Agent Teams в Claude Code — как запустить 5 агентов на одном репо и не сойти с ума

Субагенты в Claude Code — штука полезная, но ограниченная. Они делают работу и возвращают результат. Между собой не общаются, контекстом не делятся, спорить не умеют. Для параллельного grep'а хватит, а для чего-то сложнее — нет.

Agent Teams работают иначе. Это полноценные Claude Code сессии, каждая со своим контекстным окном на 200K токенов, которые видят общий task list, пишут друг другу сообщения и сами разбирают задачи без участия лида. Одна сессия — лид, остальные — тиммейты. Лид координирует, тиммейты работают.

TL;DR: Agent Teams — экспериментальная фича Claude Code (v2.1.32+), где несколько агентов параллельно работают над одним проектом, общаются peer-to-peer и координируются через shared task list. Стоит ~3-4x от обычной сессии, но на сложных задачах экономит часы. Включается одной строкой в settings.json.

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

Ключевое различие — коммуникация.

Субагенты работают внутри одной сессии. Получили задачу → выполнили → вернули результат главному агенту. Друг с другом не разговаривают. Главный агент — единственный посредник.

Agent Teams — это отдельные Claude Code инстансы, каждый в своём контексте. Они могут:

• Писать сообщения друг другу напрямую (без лида-посредника)
• Видеть и разбирать задачи из общего task list
• Оспаривать находки коллег (буквально — можно попросить их спорить)

Когда что использовать:

• Субагенты — быстрые изолированные задачи, где нужен только результат. Прочитать файл, прогнать тесты, собрать summary
• Agent Teams — работа, где агентам нужно координироваться. Cross-layer фичи (frontend + backend + тесты), дебаг с конкурирующими гипотезами, параллельный code review с разных углов

Правило простое: начни с субагентов. Если упираешься в то, что агентам нужно общаться — переходи на Agent Teams.

Как включить

Agent Teams выключены по умолчанию. Включаются через environment variable или settings.json:

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

Требования: Claude Code v2.1.32+, модель Opus 4.6. Проверить версию — claude --version.

Первый запуск — что написать в промпте

Не нужно руками создавать файлы или конфиги. Просто опиши задачу и структуру команды в natural language:

Create an agent team to review PR #142. Spawn three reviewers:
- One focused on security implications
- One checking performance impact  
- One validating test coverage
Have them each review and report findings.

Claude сам создаст команду, раздаст задачи и запустит тиммейтов. Конфиг сохранится в ~/.claude/teams/{team-name}/config.json, задачи — в ~/.claude/tasks/{team-name}/.

Три важных правила для промптов:

1. Будь конкретен с контекстом. Тиммейты загружают CLAUDE.md, MCP-серверы и skills автоматически, но историю чата лида НЕ наследуют. Всё, что нужно знать — пиши в spawn prompt:

Spawn a security reviewer teammate with the prompt: "Review the 
authentication module at src/auth/ for security vulnerabilities. 
Focus on token handling, session management, and input validation. 
The app uses JWT tokens stored in httpOnly cookies."

2. Указывай количество агентов явно. Иначе Claude сам решит сколько spawn'ить — может быть 2, может быть 7:

Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.

3. Проси plan approval для рискованных задач:

Spawn an architect teammate to refactor the authentication module.
Require plan approval before they make any changes.

Тиммейт составит план, отправит лиду на утверждение. Лид одобрит или вернёт с комментариями. Пока не одобрено — код не пишется.

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

In-process (по умолчанию) — все тиммейты в одном терминале. Переключаешься через Shift+Down, смотришь task list через Ctrl+T. Работает везде.

Split panes — каждый тиммейт в своём окне. Видишь всех одновременно, кликаешь в нужное окно. Требует tmux или iTerm2 с it2 CLI.

Настройка в settings.json:

{
  "teammateMode": "tmux"
}

Или для одной сессии: claude --teammate-mode in-process.

Split panes стоит настроить — когда видишь пять агентов одновременно, гораздо проще поймать момент, когда кто-то пошёл не туда. Но VS Code terminal, Windows Terminal и Ghostty не поддерживаются — нужен отдельный терминал.

Четыре кейса, где Agent Teams реально работают

1. Параллельный code review с разных углов

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

Create an agent team to review PR #142. Spawn three reviewers:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.

Лид потом синтезирует находки всех трёх.

2. Дебаг с конкурирующими гипотезами

Самый интересный паттерн. Вместо последовательного перебора гипотез (где каждая следующая уже предвзята) — запускаешь 5 агентов, каждый с своей теорией, и просишь их опровергать друг друга:

Users report the app exits after one message instead of staying connected.
Spawn 5 agent teammates to investigate different hypotheses. Have them 
talk to each other to try to disprove each other's theories, like a 
scientific debate.

Гипотеза, которая выживает в споре пяти агентов, с большей вероятностью и есть root cause.

3. Full-stack фича с разделением по слоям

Frontend, backend и тесты — каждый тиммейт владеет своим набором файлов. Ключевое — не давать двум агентам редактировать один файл. Иначе один перезапишет работу другого.

4. QA-swarm для сайта

Реальный кейс с alexop.dev: пять агентов параллельно проверяли блог — ответы страниц, рендеринг постов, целостность ссылок, SEO-метаданные, accessibility. За 3 минуты нашли 10 проблем, включая html class=false (строковое представление boolean) и пропущенные og:type теги.

Сколько это стоит

Agent Teams потребляют значительно больше токенов, чем одиночная сессия.

По документации Claude Code, agent teams в plan mode используют примерно 7x больше токенов. По данным alexop.dev, команда из 3 агентов тратит ~800K токенов против ~200K для соло-сессии — то есть ~4x.

Каждый тиммейт — полноценная Claude Code сессия со своим контекстным окном. Токены масштабируются линейно с количеством агентов.

Как снизить расход:

• Используй Sonnet для тиммейтов — для координационных задач хватает, а стоит в 5 раз дешевле Opus
• Держи команды маленькими — 3-5 агентов для большинства задач, по 5-6 задач на каждого
• Делай spawn prompt конкретными — всё, что попадает в промпт, добавляется в контекст с самого начала
• Убивай команду когда закончил — idle тиммейты продолжают тратить токены

Для подписчиков: если планируешь использовать Agent Teams регулярно, по рекомендациям claudefa.st — начинай минимум с Max 5x ($100/мес). На Pro ($20/мес) лимит закончится за первый день.

Подводные камни

1. Два агента на одном файле = потеря работы. Нет встроенного merge — если два тиммейта редактируют один файл, один перезапишет другого. Разделяй работу так, чтобы каждый агент владел отдельным набором файлов. Если это невозможно — используй task dependencies, чтобы работа шла последовательно.

2. /resume не восстанавливает тиммейтов. Если закрыл терминал или сессия упала — лид при resume попытается отправить сообщения несуществующим тиммейтам. Придётся сказать ему spawнить новых. Вся работа тиммейтов (файлы на диске) сохранится, но контекст потеряется.

3. Лид начинает делать работу сам вместо делегирования. Частая проблема — лид решает, что проще сделать самому, чем ждать тиммейтов. Лечится прямым указанием: "Wait for your teammates to complete their tasks before proceeding."

4. Статус задач зависает. Тиммейты иногда забывают пометить задачу как completed, что блокирует зависимые задачи. Если задача зависла — проверь вручную и скажи лиду подтолкнуть тиммейта.

5. Split panes оставляют orphaned tmux сессии. После завершения команды tmux-сессия может остаться висеть. Проверяй tmux ls и убивай tmux kill-session -t <name>.

6. Одна команда на сессию. Нельзя запустить вторую команду, пока не сделал cleanup первой. Нельзя вложить команды (тиммейт не может spawn'ить свою команду). Лид фиксирован на всё время жизни команды.

Вердикт

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

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

Реалистичная оценка: на Max 5x ($100/мес) хватит на 3-5 полноценных сессий Agent Teams в день при команде из 3 агентов. На Pro — одна сессия, и то не факт.

Как попробовать

1. Убедись, что Claude Code >= v2.1.32: claude --version
2. Добавь в ~/.claude/settings.json:

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

3. Установи tmux для split panes (опционально): brew install tmux на macOS
4. Запусти Claude Code и попроси создать команду. Начни с code review — он безопасный и наглядный:

Create an agent team to review the last 3 commits. Spawn two reviewers:
- One checking for bugs and edge cases
- One checking code style and test coverage

5. Следи за расходом через /cost и статус-бар

Документация: Agent Teams | Costs | Subagents для сравнения