Субагенты Claude Code и Agent Teams: практическое руководство

Вы видели слова «субагенты», «Agent Teams», «оркестрация», и вы задаетесь вопросом, не упускаете ли вы что-то. Короткий ответ: для большинства ваших задач нет. Но на большой работе, да, и это стоит понимать.

Давайте распутаем его без жаргона.

Что такое субагент на самом деле

Субагент - это специализированный помощник с собственным контекстом, собственной подсказкой и собственными разрешениями на использование инструментов.

Когда основной агент попадает в четко определенную подзадачу, он делегирует ее субагенту. Этот субагент работает в своем собственном контексте, выполняет свою работу и возвращает только результат. Главный агент не получает полную историю, загрязняющую его контекст, он получает заключение.

Суть в том, чтобы сохранить контекст главного агента в чистоте. Вместо одного агента, утопающего в 50 000 токенов поиска файлов, у вас есть субагент, который выполняет поиск и сообщает три полезные строки.

Вы заявляете о своих субагентах в папке .claude/agents/ вашего проекта. У каждого есть имя, описание, которое говорит, когда его использовать, и подсказка системы.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams: следующий шаг

Agent Teams - это мультиагентный оркестратор, встроенный в Claude Code. Все еще экспериментальный, отключен по умолчанию, но твердая точка входа.

Идея: ведущий агент разделяет большую задачу, делегирует каждую часть специализированному агенту (с собственной моделью, подсказками, инструментами), специалисты работают параллельно в общей файловой системе, и результаты возвращаются к лидеру.

Если "делегат специалисту" звучит как субагенты, это нормально. Идея Agent Teams заключается в том, чтобы запустить несколько агентов параллельно, а не один за другим.

Помимо встроенного, есть сторонние оркестранты, такие как Multiclaude и Gas Town. Они самоуверенные, что делает их хорошими отправными точками, когда вы начинаете: они решают за вас, пока вы не создадите свои собственные привычки.

Когда вам это нужно (а когда нет)

Давайте проясним: мультиагентная оркестровка бессмысленна для 95% задач с агентской помощью. Для большей части вашей повседневной работы один агент быстрее и проще.

В настоящее время мультиагент по-прежнему является дорогостоящим и экспериментальным способом атаки на крупные проекты.

Вам это нужно, когда:

• Проект разделен на действительно независимые части, которые касаются различных файлов.
• Одно окно контекста не может удержать все.
• Вы хотите провести параллель между широким рефактором или репо-широкой миграцией.

Вам не нужно это для исправления ошибок, сфокусированной функции или чего-либо, что помещается в одну голову.

Ловушка раскручивает десятиагентную «команду» для того, что один агент сделал бы за пять минут. Вы платите токенами и сложностью за параллелизм, о котором никогда не просили.

Реальная проблема: видимость

Вот о чем недостаточно говорят. В тот момент, когда вы управляете несколькими субагентами или командой агентов, вы теряете нить.

Ведущий делегат пяти специалистов. Кто из них работает? Что закончилось? Кто ждет решения? В терминале вы видите стену прокручивающего текста, и вы не можете сказать, кто что делает.

Именно здесь визуальная панель приборов меняет все. AgentsRoom показывает каждого агента и каждого субагента как свою собственную плитку. Вы наблюдаете, как происходит делегирование, вы видите, кто ждет вашего ответа, вы видите, кто потерпел крушение. Стена текста становится читаемой картой.

Без этой точки зрения мультиагентная оркестровка остается впечатляющей демонстрацией, которая неуправляема изо дня в день. Это становится инструментом, который вы действительно используете.

С чего начать

Не прыгайте прямо в команду из восьми агентов.

Начните с одного или двух субагентов для точных, повторяющихся задач: тот, который пишет тесты, тот, который ищет кодовую базу. Вы быстро почувствуете выгоду от контекста вашего главного агента.

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

Мультиагент вознаграждает людей, которые строятся до запуска. Не те, кто запускает большинство агентов.