Agent Teams в Claude Code: гайд с кейсами

Sergey Golubev 2026-02-25 6 мин чтения
🌐 Read in English

Agent Teams in Claude Code VS Subagents

5 агентов работают одновременно. Один ревьюит безопасность, другой - перформанс, третий - тесты. У Nicholas Carlini из Anthropic 16 параллельных агентов собрали C-компилятор на 100 000 строк Rust - он компилирует ядро Linux 6.9 и проходит 99% torture-тестов GCC. Стоило ~$20 000 в API. На задачах поменьше результаты скромнее - @the_ai_architect на 1.7K строк получил провал.

Claude Code запустил Agent Teams 5 февраля 2026, вместе с Opus 4.6. Несколько экземпляров Claude Code работают в одной сессии, общаются напрямую. Не путать с субагентами (Task tool) - те только отчитываются главному. Собрал гайд из документации Anthropic, Telegram-каналов и чужих факапов, хотя в документации и в реальных кейсах советы иногда противоречат друг другу.

Как устроены Agent Teams

Один экземпляр - Team Lead. Координирует, назначает задачи, синтезирует результаты. Остальные - Teammates со своим контекстным окном и фокусом. Честно, я ждал что-то сложнее в настройке - а включается одной переменной окружения.

Ключевое отличие от субагентов: тиммейты общаются напрямую друг с другом. Субагент отчитывается только главному агенту. Тиммейт может написать другому - “эй, мой API-контракт изменился, обнови свою часть”.

Включается одной строкой в settings.json:

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

После этого появляются новые возможности:

  • Shift+Down - переключение между тиммейтами в одном терминале
  • Split panes - через tmux или iTerm2 видишь всех одновременно
  • Shift+Tab - Delegate mode, где лид только координирует, не пишет код сам. По данным claudefa.st, Delegate mode + явные файловые границы в spawn-промпте устраняют большинство типичных ошибок Agent Teams
  • Plan Approval - тиммейт работает в read-only, пока лид не одобрит план

Задачи проходят цикл: pending, in progress, completed. Есть зависимости - тиммейт B не начнёт пока A не закончит.

Субагенты vs Agent Teams - когда что

Субагенты (Task tool)Agent Teams
КонтекстСвой, результат возвращается вызывающемуСвой, полностью независимый
КоммуникацияТолько с главным агентомНапрямую между тиммейтами
КоординацияГлавный агент рулит всемОбщий task list + самокоординация
Лучше дляФокусные задачи, нужен только результатСложная работа, нужна дискуссия
ТокеныМеньше: результат суммируетсяБольше: каждый тиммейт = отдельный экземпляр

Субагенты - работники, которые уходят и приносят результат.

Agent Teams - команда, которая обсуждает, спорит и координируется.

Промпты

Ресёрч CLI-инструмента:

I'm designing a CLI tool that helps developers track TODO comments
across their codebase. Create an agent team to explore this from
different angles: one teammate on UX, one on technical architecture,
one playing devil's advocate.

Code review PR:

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.

Дебаг с научным подходом:

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.

С контекстом для конкретного тиммейта:

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."

Что говорит комьюнити

Три кейса из Telegram.

@ilia_izmailov (3 360 просмотров) - декомпозирует задачу на 5 подзадач. Каждая получает кодера и ревьюера. Над ними - техлид, который перепроверяет.

@alxyrgin (1 380 просмотров) - три причины разделять роли. Точность: каждый агент глубоко погружается в свою область. Конфликт: разработчик спорит с безопасником и QA - качество растёт. Контекст: меньше контекста у каждого = больше внимания к деталям. И ещё - агенты не только для программистов, можно собрать продакта, UX-ресёрчера и критика.

@the_ai_architect (5 350 просмотров - самый залайканный) - попробовал Agent Teams на TG mini app. 1.7K строк, 3 бэкенда + фронтенд. Результат: провал. Бэкенд не синхронизировался с фронтом, контракты разъехались, инструкции игнорировались. GPT-5.3 Codex соло справился лучше. Это меня зацепило больше всего - 5 350 просмотров и главный вывод: “Осознанный процесс подготовки плана, декомпозиции и верификации всё ещё актуален.”

Cole Medin на YouTube сказал похоже: “Если бросить расплывчатый промпт в Agent Teams - гарантированно получишь кашу.”

5 причин разделять роли

Подробный разбор от @tired_glebmikheev - почему отдельные роли работают лучше одного агента:

  1. Фокусировка - один агент на безопасность+перформанс+архитектуру = первое ок, остальное мимо. Отдельные агенты копают глубже
  2. Противоречие - разработчик vs безопасник vs QA в споре, и результат ревью заметно точнее, чем от одного агента, который сам себя “проверяет”
  3. Контекстное окно - меньше контекста = больше внимания к деталям каждой задачи
  4. Конвергенция паттернов - десятилетия оргструктур (stories, DoR/DoD, роли) применимы к агентам. Закон Конвея наоборот
  5. Качество - хочешь фидбэк дизайнера на каждый анализ + тест-план от QA = отдельные роли

Его вывод: “Проектируй процесс, ответственности, требования, гайдлайны, накапливай успешные решения и практики.”

Best practices

  • 3-5 тиммейтов - оптимально. Больше = хаос координации
  • 5-6 задач на тиммейта - не перегружать
  • Избегать конфликтов файлов - два тиммейта в одном файле = merge hell
  • Quality gates - хуки TeammateIdle и TaskCompleted для контроля
  • Подписка - минимум Max план: Токены уходят в 3-4x быстрее. На Max плане за $100/мес терпимо, на $200/мес - комфортно. На Pro рискуешь упереться в лимит за пару сессий.

Что понял

Фича экспериментальная - есть ограничения, которые стоит знать до старта. Если закрыть терминал или Claude Code крашнется - тиммейты не восстанавливаются. /resume поднимет только лида, а тиммейтов придётся спавнить заново. Одна сессия = одна команда, параллельно две не запустишь. Вложенность не работает - тиммейт не может сам собрать команду внутри команды. Например, если тиммейт-архитектор хочет делегировать часть работы ещё трём агентам - не получится, спавнить новых может только тот, кто создал команду изначально. И поменять координатора на ходу тоже нельзя.

Code review, ресёрч с разных углов, рефакторинг независимых модулей - тут команда выигрывает. На задачах с тесно связанными компонентами (фронт + бэкенд с общими контрактами) один агент работает лучше. Agent Teams сильны там, где задачи параллельны и слабо связаны между собой.

Пока не уверен, что Agent Teams заменяют хорошо настроенные субагенты и скилы для большинства задач - сам ещё только начал пробовать на боевых проектах.

Источники

  1. Anthropic - Agent Teams Documentation
  2. Anthropic Engineering - Building a C Compiler with Agent Teams
  3. alexop.dev - From Tasks to Swarms: Agent Teams in Claude Code
  4. claudefa.st - Agent Teams Best Practices
  5. Cole Medin - Agent Teams Live Build (YouTube)
  6. @ilia_izmailov - Telegram
  7. @alxyrgin - Telegram
  8. @the_ai_architect - Telegram
  9. @tired_glebmikheev - 5 причин для отдельных ролей агентов