Команды агентов Claude Code: когда использовать множественных агентов и как это сделать
Когда достаточен один агент, четыре способа добавления дополнительных агентов, шаблоны оркестрации, стили общения, восемь модусов сбоя и выбор между версией от разработчиков и DIY для команд Claude Code.
Источники: Claude Code agent teams: when and how to go multi-agent
Создание скоординированной команды агентов, способных взаимодействовать друг с другом внутри экосистемы Claude Code, уже возможно, и готовая версия может хорошо функционировать. Однако заставить её работать сложнее, чем кажется, и многие люди сразу приступают к созданию команд агентов, не учитывая связанные с этим недостатки. Команды агентов кажутся очевидным следующим шагом после того, как сабагенты начнут стабильно работать. Но это не происходит автоматически. Команда представляет собой уровень координации, сопряжённый с реальными затратами в виде токенов, имеющий известные способы сбоев и ограниченный набор задач, которые она может эффективно решать.
Самый негламурный урок, полученный за месяцы реального использования многокомпонентных систем, одновременно является и самым полезным: начните с одного хорошо настроенного агента, качественных инструментов и дисциплинированного управления контекстом. Добавляйте новых агентов только тогда, когда у вас есть конкретная причина для этого. Рекомендации компании Anthropic по созданию эффективных агентов гласят то же самое: командам следует искать самое простое работоспособное решение и добавлять сложность только тогда, когда это необходимо.
Далее приведен способ тщательного обдумывания решения и действий после его принятия. В нем предполагается, что вы знакомы с подагентами, отличиями их от навыков и тем, почему изоляция контекста является основной причиной использования подагентов. Открытым вопросом остается момент, когда одного подагента, сообщающего об итогах работы, уже недостаточно, и что следует создать вместо него.
В материале рассматриваются следующие аспекты:
- Почему большинству команд пока не нужно несколько агентов, и какая распространённая ошибка заключается в выборе более мощных команд.
- Четыре конкретных признака того, что у одного агента исчерпаны возможности.
- Четыре способа комбинирования агентов в таксономии, независимой от поставщика: оркестратор, конвейер, параллельные специалисты и стая.
- Стек Anthropic для команд агентов, позволяющий разделять стабильные решения от экспериментальных или предварительных версий.
- Что такое команды агентов Claude Code и в чём они отличаются от сабагентов.
- Как агенты взаимодействуют: три формата, четыре схемы времени и что передаётся между ними.
- Восемь способов сбоев с практическими методами их устранения.
- Чертеж для принятия решений относительно использования нативной, самостоятельной или гибридной оркестрации.
Большинству команд достаточно одного агента
Многие люди, которые ищут команды агентов, решают неправильную проблему. Обычное мнение заключается в том, что субагенты сработали, система становится всё более сложной, и команды — это следующий шаг. Такая логика путает возможности с сложностью. Команда не делает систему более функциональной; она делает её более децентрализованной, а децентрализация — это издержка, а не улучшение.
В посте компании Anthropic о создании эффективных агентов подробно рассматриваются экономические аспекты. Рабочие процессы, не основанные на использовании агентов, более предсказуемы, дешевле в реализации и проще в отладке; совет сводится к следующему: если задачу можно выполнить с помощью обычной функции, лучше написать эту функцию, чем собирать комитет из вероятностных распределений. Эту мысль легко упустить тем, кто не понимает, что большие языковые модели имеют вероятностную природу. Даже прямая инструкция может быть выполнена правильно, а может — и нет. Каждый добавленный агент — это ещё один компонент, который может выйти из строя, генерировать ложную информацию или создавать выходные данные, которые будет неправильно интерпретировать следующий агент, поэтому добавление агентов увеличивает вероятность ошибок в масштабе.
Потолок возможностей одного агента выше, чем предполагают многие. Один агент, обладая подходящими инструментами, четкими системными указаниями, правильной передачей сложных задач подагентам и тщательным управлением контекстом, может справляться с поразительно большим объемом работы. Потолок достигается, когда выполняется хотя бы одно из следующих условий:
- Работа слишком объемна для одного окна контекста, даже при передаче задач подагентам.
- Для разных частей работы требуются совершенно разные специализации, что означает необходимость доступа к разным инструментам и наличие разных ограничений в поведении, а не просто разные указания.
- Часть работы может выполняться параллельно, и здесь важна продолжительность времени.
- Качество результата требует независимой оценки, например, со стороны второго агента, который не видел процесса рассуждений первого.
Ни одно из этих утверждений не касается возможностей. Все они связаны с архитектурой. Когда применяется тот или иной подход, дополнительные агенты оправданы. Когда их не применяют, они лишь создают помехи, и если невозможно указать конкретный вариант, путь с использованием одного агента по-прежнему доступен.
Четыре фактора, вызывающих необходимость использования агентов, с примерами
Изоляция контекста. Предположим, что задача подразумевает чтение десятков файлов, проведение обширных поисков и хранение крупных промежуточных результатов, ни один из которых не должен оставаться в основной сессии. Для этого подходит подагент. Но если объем работы настолько велик, что заполняется даже контекст подагента, или задача делится на независимые параллельные исследования, тогда требуется несколько агентов. Это самый распространенный законный фактор, побуждающий к использованию нескольких агентов.
Специализация. Для выполнения такой работы требуются не просто отдельные инструкции — нужен доступ к разным инструментам и особые ограничения в поведении. Рецензент кода, который не может создавать файлы или запускать команды оболочки, имеет совершенно иной профиль риска, чем генератор кода. Однако эти различия часто можно представить в виде отдельных субагентов, у каждого из которых свои системные указания и ограниченный список инструментов, поэтому одна лишь специализация не должна становиться причиной для перехода к командным форматам работы. В самой документации по агентам-командам говорится, что именно субагенты здесь наиболее эффективны: изолированные контексты, краткие сводки, возвращаемые вызывающему элементу, и инструкции, специфичные для конкретной задачи.
Параллельная работа. Задача разделяется на независимые подзадачи, не имеющие общего изменяемого состояния: три агента одновременно изучают разные аспекты ошибки в кодовой базе, или четыре агента по отдельности рассматривают другие разделы документа. Именно в таких ситуациях многоагентные системы обеспечивают реальную экономию времени, поскольку агенты работают одновременно. Цена этого — большее количество токенов, поэтому такой обмен оправдан только тогда, когда время выполнения важнее затрат.
Независимая критика. Результату необходимо второе мнение, которое не было бы исказлено аргументацией первого. Представьте себе оценщика, который читает только окончательный результат, не изучая причины, лежащие в его основе, или агента красной команды, который ищет ошибки вместо того, чтобы проверять утверждения. Именно так работает исследовательская система с несколькими агентами от Anthropic: параллельные подагенты исследуют различные аспекты, а ведущий агент самостоятельно синтезирует информацию.
Когда одно из этих утверждений явно верно, и можно определить, какое именно, добавление агентов оправдывает свои затраты.
Четыре способа объединения агентов
Предположим, решение принято. Однако исследования быстро показывают хаос, поскольку лаборатории на передовой каждая разработала схемы работы с несколькими агентами по-своему, хотя существуют и некоторые общие элементы. Ниже приведена синтезированная таксономия, составленная на основе документации по рабочему процессу Anthropic и опыта работы его инженерной команды. Это не официальная классификация Anthropic — это аналитическое резюме, соответствующее описанию, приведенному в этих источниках.
Последовательная схема
Агенты или этапы выполняются в фиксированном порядке, причем более поздние этапы используют результаты предыдущих. Из четырех вариантов этот самый простой для объяснения инженерам, поскольку он напоминает обычное программное обеспечение: сначала исследования, затем синтез, затем разработка черновика, затем его оценка, и в конце — извлечение данных и их проверка.
Его сильная сторона — четкие контракты между этапами. Его слабость — каскадные ошибки, поскольку ошибка при извлечении данных на первом этапе может привести к ошибкам на последующих этапах с большими потерями. Блоки проверки между этапами являются обязательными, так как они не позволяют процессу двигаться в неверном направлении. Схемы контрактов JSON и другие элементы, сохраняющие информацию о ходе выполнения, обеспечивают наилучшие механизмы контроля.
Центральный оркестратор или планировщик-исполнитель
Основной агент разделяет задачу на части, поручает их исполнителям и синтезирует полученные результаты. Исполнители не координируют действия друг с другом; они отчитываются перед организатором. Это самый распространённый и полезный стандартный вариант. Используйте его, когда структура подзадач неизвестна заранее, но важно чёткое определение ответственности на высшем уровне. Функция Research в Anthropic работает именно по этой схеме: основной агент анализирует запрос, одновременно запускает специализированные подагентов, а затем объединяет полученные ими данные.
Не используйте этот подход, если рабочий процесс уже настолько стандартизирован, что его можно описать с помощью скриптов; в таких случаях конвейер будет проще и предсказуемее.
Характерной проблемой является сбой оркестратора: когда ведущий агент дает распоряжения с нечеткими указаниями, сотрудники вынуждены повторять поиски друг у друга, пропускать важные границы или получать несогласованные результаты. Решением является предоставление каждому сотруднику четкой цели, определенного формата результата, рекомендаций по источникам информации и четких рамок задачи.
Параллельные специалисты, дебаты и команда атак
Здесь несколько агентов одновременно выполняют одну и ту же задачу или смежные подзадачи, после чего их результаты голосуются, анализируются или объединяются. Этот подход подходит для ситуаций, где важнее устойчивость, чем аккуратность: соперничество в поиске объяснений ошибки, критический анализ решения по правилам, проверка безопасности с нескольких точек зрения.
Стоимость очевидна. Увеличение количества агентов приводит к значительному росту количества токенов, усилению объединительных процессов и риску ложной уверенности, возникающей в результате консенсуса. Как сообщается, исследовательской системе Anthropic пришлось ввести бюджеты на выполнение задач и более строгую систему делегирования полномочий, чтобы предотвратить бесконтрольное распространение работы среди сотрудников. Используйте эту модель только тогда, когда это действительно необходимо в данной области.
Стая, или децентрализованный общий контекст
Координация достигается за счёт общего состояния, общих потоков сообщений или изменений в окружающей среде, а не благодаря строгому лидеру. В этом случае многократные агентные системы превращаются в распределённые системы, что сопровождается такими сложностями, как неоднозначность вопросов принадлежности, ситуации гонки при работе с общим состоянием и сложности в отладке. Этот подход подходит для по-настоящему открытых задач, где агенты должны взаимодействовать друг с другом независимо от границ сессий или времени выполнения. Избегайте его там, где требуется простая отчётность или строгое соблюдение правил.
Для большинства пользователей первые два подхода охватывают практически всё.
Что предлагает Anthropic сегодня
Прежде чем создавать собственную систему, стоит проверить, что уже предоставляет Anthropic и чему учат его решения. Существует несколько способов выполнения задач с использованием агентов, и они не являются взаимозаменяемыми. Представьте себе лестницу, ведущую от прямого управления до централизованного управления. Ниже приведена картина ситуации примерно на апрель 2026 года, при этом эти продукты быстро меняются.
- API Messages. Вы полностью контролируете весь процесс. Существует возможность использования инструментов, но логику выполнения пишете вы сами, причем встроенной поддержки нескольких агентов нет. Это самый гибкий уровень, но и требующий наибольших усилий.
На практике утверждение «Claude поддерживает команды агентов» верно, в то время как утверждение «Claude предоставляет оркестрацию нескольких агентов производственного уровня для общего использования на любых платформах» — нет.
Команды агентов Claude Code на практике
Краткий обзор различий:
- Подагенты работают внутри одной основной сессии. Основная инстанция Claude Code создаёт их; каждый из них работает самостоятельно в своём собственном окне контекста и отправляет результаты обратно. Вы сами осуществляете оркестрацию, а основная сессия никогда не берёт на себя выполнение работ для получения результата.
Настройка
- Конфигурация команды находится по пути
~/.claude/teams/{name}/config.json. - Общий список задач находится по пути
~/.claude/tasks/{name}/. - Участники команды определяются в файлах агентов, которые можно использовать повторно; это по сути определения подагентов с присвоенными ролями участников команды.
- Хуки могут служить контрольными точками качества при переходе между задачами.
Для проектирования важны два архитектурных аспекта. Во-первых, сабагенты могут сохранять собственную автономную память. Это способствует специализации, но когда работа распределяется между несколькими агентами с отдельными памятьми, необходимо принимать архитектурное решение о том, какие знания остаются локальными, какие делятся между агентами и какие обобщаются заново. Это вопрос проектирования системы.
Во-вторых, в документации прямо указано, когда команды работают хуже сабагентов: при выполнении последовательных задач, редактировании одного и того же файла и при работе с большим количеством зависимостей между этапами. Если агенты вынуждены передавать один и тот же результат по порядку, не работая параллельно, сабагенты в последовательной цепочке оказываются проще и предсказуемее.
Поскольку команды на тот момент ещё были экспериментальными и по умолчанию отключены, включайте их только по четкой причине из перечисленных выше, ожидая наличия недостатков.
Как агенты общаются друг с другом
Обмен сообщениями между агентами часто рассматривается как проблема формулировки запросов. В масштабном масштабе это проблема самой системы. Существуют три основных вида такого обмена.
- Сообщения простым языком. Самая очевидная форма, но самая ненадежная в масштабном использовании. Коллеги в Claude Code обмениваются сообщениями напрямую через почтовый ящик. Это гибко, но естественный язык менее точен по сравнению со структурированными запросами, что создает больше возможностей для неправильного понимания между агентами.
- Структурированные запросы. Использование определений инструментов в формате JSON Schema и строгое соблюдение правил их применения. Определения инструментов от Anthropic гарантируют, что аргументы соответствуют заданной структуре. Этот уровень обеспечивает надежность обмена сообщениями между агентом и инструментом, а тот же механизм делает вызовы между агентами более точными, когда они моделируются как вызовы инструментов вместо сообщений свободного формата.
Время выполнения имеет такое же значение, как и формат. Выделяются четыре подхода:
- Синхронные вызовы. Руководитель обращается к специалисту, ждёт ответа, затем продолжает работу. Легко понимать принцип работы, но это может стать узким местом. По сообщениям исследовательской команды Anthropic, синхронная работа главного агента блокировалась медленной работой подагентов, поэтому было решено отказаться от корректировки действий в процессе выполнения.
То, как агенты передают друг другу данные, влияет на надежность всей системы. Передача полной истории разговора обеспечивает максимальную преемственность, но линейно увеличивает затраты и задержки. Часто более эффективным является сжатый краткий обзор, и именно это делают подагенты Claude Code по замыслу разработчиков. Передача специфических для задач объектов, таких как структурированные файлы вывода, патчи кода, списки функций в формате JSON и сохраненные отчеты, как правило, представляет собой практически оптимальный вариант. Агент, принимающий данные, может напрямую изучить эти объекты вместо того, чтобы полагаться на краткий обзор, что позволяет обеспечить аудитируемость системы на уровне, недостижимом при передаче данных в формате разговора.
То, что передается, также определяет способ и момент его передачи, что подчеркивает ключевую мысль: создание команд агентов — это проблема проектирования систем, и ее решение сложнее, чем при линейном организованном потоке обработки данных.
Восемь причин неудач команд агентов
Большинство учебных материалов по многокомпонентным системам пропускают эту часть. Инженерные записки Anthropic являются хорошим источником информации. Они больше похожи на дневник команды, которая постепенно, исправляя одну ошибку за другой, понимала, что увеличение количества агентов умножает проблемы управления, чем на научную статью. Из них можно извлечь восемь уроков.
- Отклонение в координации. Нечеткое делегирование задач заставляет сотрудников повторять чужие поиски, пропускать границы или возвращать результаты, которые нельзя объединить. В одной из публикаций исследовательской группы Anthropic это было непосредственно отмечено, и решением стало обучение оркестратора формулировать цель, формат вывода, руководящие принципы и объем задач для каждого сотрудника. Там, где не определена ответственность, агенты импровизируют, причем часто неудачно, так же как и люди.
Нативные решения, самостоятельная разработка или гибридные варианты
Вот главный вопрос: создавать оркестрацию самостоятельно или использовать готовое решение? Это архитектурный компромисс между тремя вариантами, причем их наверняка больше, поэтому рассматривайте это как одну из точек зрения.
- Нативные управляемые решения означают, что Anthropic контролирует среду выполнения и механизмы координации: Claude Managed Agents, а также более узко — Managed Agents для работы с несколькими агентами или команды агентов Claude Code. Преимущества заключаются в меньшей нагрузке на инженеров и наличии хостинговой инфраструктуры, которую не нужно обслуживать. Недостатки — ограниченная переносимость (доступ к Managed Agents возможен только через прямой API Claude), экспериментальный или ограниченный превью интерфейса для работы с несколькими агентами, а также зависимость от стороннего поставщика. Выбирайте этот вариант, когда проблема заключается в инфраструктуре, а ограничения, связанные с Anthropic, являются приемлемыми.
Короче говоря: встроенные решения — когда проблема в инфраструктуре, самостоятельная разработка — когда проблема в топологии и правилах работы, а гибридный вариант — когда вы хотите использовать примитивы Anthropic, но нуждаетесь в свободе для собственных архитектурных решений.
Вопрос архитектуры
Наиболее распространённое представление у людей о командах агентов связано с их функциональными возможностями — считается, что чем больше агентов, тем выше их эффективность. Однако более полезным подходом является архитектура: какую проблему решает дополнительный агент и сколько это стоит?
Подагенты определяют, кто будет выполнять работу, в каких условиях и с помощью каких инструментов. Команды агентов добавляют на эту структуру уровень координации, включающий общее состояние задач, возможность прямой переписки между участниками и параллельную обработку, которая организуется сама по себе. Такой уровень оправдан только в тех случаях, когда это действительно необходимо.
Для реального случая использования достаточно одной хорошо настроенной команды агентов — это объём работы, который можно выполнить за неделю. Сложность может возрастать дальше, но не обязательно начинаться именно с этого. Приведённые выше каталоги неудач и шаблоны коммуникации служат справочными материалами, а не планом по созданию всего сразу. Начните с определения того, какой из четырёх триггеров действительно срабатывает, и если ни один из них не срабатывает, путь с использованием одного агента по-прежнему будет правильным.