Субагенты в Claude Code: параллельная работа над задачей

Что такое субагенты в Claude Code, когда их использовать и как запускать параллельную работу над большими задачами. С примерами.

Зачем это нужно

Представь: тебе нужно проверить 20 страниц своего сайта — чтобы везде были правильные заголовки, живые ссылки и без опечаток. Если делать это последовательно — это часы работы. Claude Code по умолчанию работает так же: берёт задачу, доводит до конца, потом берёт следующую.

Субагенты меняют это. Ты говоришь главному Claude: “разбей задачу на три части и запусти три помощника параллельно”. Пока один помощник проверяет заголовки, второй проверяет ссылки, третий ищет опечатки. Работа, которая занимала 40 минут, делается за 10–15.

Субагенты — продвинутый инструмент. Для простых задач они не нужны. Но для большого аудита, research по нескольким источникам или массовой проверки контента — это серьёзная экономия времени.

Термины, которые будут встречаться в гайде (запомни одну строчку и двигайся дальше):

Оркестратор — главный Claude, который раздаёт задачи помощникам и собирает результаты.
Субагент — помощник. Отдельная сессия Claude, которая делает один кусок работы.
Изолированный процесс — каждый субагент работает сам по себе и не знает, что делают другие. Узнаёт только оркестратор в конце.
Параллельно — все помощники работают одновременно, а не по очереди.

Как это устроено

Когда ты просишь Claude Code сделать что-то большое параллельно, происходит вот что:

Оркестратор (главный Claude) получает задачу и делит её на независимые куски.
Для каждого куска оркестратор запускает субагента — отдельного помощника.
Субагенты работают одновременно, каждый сам по себе.
Оркестратор собирает результаты и выдаёт тебе один общий ответ.

Ключевое слово — независимые. Если второй кусок работы зависит от первого, параллельность не сработает: второй помощник не дождётся результата первого. Субагенты подходят только для задач, которые реально можно делать одновременно без пересечений.

Когда субагенты полезны

Ниже — четыре сценария, которые реально встречаются у тех, кто делает свой продукт.

1. Аудит своего сайта или продукта

У тебя есть сайт на 20–50 страниц. Ты хочешь проверить, что всё в порядке:

Проверь мой сайт. Запусти трёх субагентов параллельно: — первый: пройди по всем страницам и проверь, что заголовки оформлены единообразно (везде одинаковый стиль, одинаковые правила капитализации) — второй: собери все внешние ссылки и проверь, какие из них не открываются — третий: найди опечатки и грамматические ошибки в текстах В конце сведи всё в один отчёт: что нашёл, где именно, насколько критично.

Без субагентов Claude пройдёт по этому списку последовательно и потратит много времени. С субагентами — три проверки идут одновременно.

2. Research нескольких продуктов параллельно

Ты думаешь, как устроить в своём продукте онбординг (первое знакомство пользователя с сервисом), и хочешь посмотреть, как это делают другие:

Мне нужно разобраться, как устроен онбординг у трёх продуктов: Notion, Linear и Figma. Запусти трёх субагентов параллельно, каждый изучает один продукт. Каждый субагент должен ответить: сколько шагов, что пользователь делает на каждом шаге, как продукт объясняет свою ценность, какие приёмы используются. В конце собери результаты в таблицу: три колонки (по одной на продукт), строки — сравнительные характеристики.

Один research вместо трёх последовательных — разница во времени в три раза.

3. Параллельная проверка сайта на работоспособность

Ты выкатил обновление и хочешь убедиться, что ничего не сломалось:

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

4. Генерация контента по списку тем

У тебя есть список из 10 тем для постов в блог, и ты хочешь быстро получить черновики:

У меня есть список из 10 тем в файле topics.md. Запусти 10 субагентов параллельно — каждый пишет черновик одного поста по своей теме. Длина — 400–600 слов, стиль — как в предыдущих постах в папке blog/.

Каждый субагент пишет один пост. Вместо последовательной работы “пост за постом” — все десять черновиков готовы почти одновременно.

Для тех, кто уже пишет код

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

Когда субагенты не нужны

Маленькие задачи. Если всё решается в 2–3 шага, запускать помощников нет смысла — накладные расходы на их создание съедят всю экономию.

Зависимые шаги. Если второй шаг требует результата первого (“сначала собери данные, потом на их основе напиши отчёт”) — это не параллельная работа, это обычная последовательная.

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

Как запустить субагентов

Самый простой способ — написать в промпте “запусти субагентов параллельно” и перечислить, кто что делает.

Шаблон, который работает почти всегда:

Задача: [опиши общую цель]. Запусти [число] субагентов параллельно: — субагент 1: [что именно делает] — субагент 2: [что именно делает] — субагент 3: [что именно делает] Когда все закончат, собери результаты в [формат: отчёт / таблица / список].

Claude сам создаст нужное количество помощников, распределит работу и вернёт объединённый результат. Никаких специальных команд учить не нужно.

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

Ограничения и осторожность

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

Расход. Каждый субагент — это отдельное обращение к Claude. Ты платишь за использование API-токенами (это единицы оплаты использования Claude — чем больше задач, тем больше расход). Запуск 10 субагентов вместо одного большого Claude — это примерно в 10 раз больше токенов. На сложных аудитах это заметно.

Сложность отладки. Когда что-то пошло не так в параллельной работе — сложнее понять, какой именно помощник ошибся. Начинай с 2–3 субагентов, увеличивай только когда понимаешь, как это работает.

Не для интерактивных задач. Субагенты работают автономно — они не могут задать тебе вопрос в процессе. Убедись, что задача описана достаточно подробно, чтобы помощник мог её доделать сам.

Компьютер должен быть включён. Субагенты работают на твоём компьютере. Если ты закроешь крышку ноутбука или выключишь компьютер — работа остановится. Для задач, которые должны крутиться без тебя (ночью, по расписанию), нужен VPS — удалённый сервер, который работает круглосуточно. Но для большинства задач это не требуется — субагенты справляются за минуты.

Всё управляется из одного окна. Ты не открываешь отдельные окна для каждого субагента. Запустил из одного чата — субагенты работают в фоне, каждый в своём контексте. Когда они закончат, результаты автоматически вернутся в твой основной чат.

Если застрял на настройке — запросы выдают непредсказуемый результат, субагенты мешают друг другу, не понимаешь, какой объём работы им поручить — запишись на консультацию. Разберём твой конкретный сценарий вместо гаданий.

Связь с CLAUDE.md

Если ты регулярно гоняешь субагентов на похожих задачах, опиши правила в CLAUDE.md (файл с инструкциями для Claude в корне проекта — о нём отдельный гайд):

## Субагенты
При аудите моего сайта — всегда запускать три субагента параллельно:
заголовки, ссылки, опечатки.
Максимум 5 субагентов одновременно.
Каждый субагент работает с отдельной частью сайта, не пересекаясь с другими.

Так ты один раз объяснишь правила, и потом не придётся повторять их в каждом промпте.

Что дальше

Субагенты — мощный инструмент для параллельных задач. Теперь ты умеешь разбивать большую работу на независимые куски и запускать нескольких помощников одновременно. Попробуй на своём проекте: аудит, research или генерация контента — хороший старт.

Для тех, кто хочет разобраться в технических деталях

Постоянные субагенты через файлы в `.claude/agents/`

Кроме запуска “по месту” через промпт, есть способ создать постоянного субагента — файл с описанием его роли, который Claude подхватывает автоматически. Это удобно, если ты хочешь один раз описать помощника и потом вызывать его по имени.

Файл лежит в папке .claude/agents/ в корне проекта, имеет расширение .md и начинается с блока настроек (front matter — шапка с метаданными в формате ключ: значение). Пример .claude/agents/content-reviewer.md:

---
name: content-reviewer
description: Проверяет страницы сайта на единообразие и опечатки
---

Ты — редактор контента. Для каждой переданной страницы проверь:
1. Заголовки оформлены единообразно (капитализация, пунктуация)
2. Нет опечаток и грамматических ошибок
3. Все ссылки живые и ведут куда обещают
4. Нет оборванных предложений или дублей

Верни список замечаний в формате:
[страница] описание проблемы, где именно

После создания этого файла Claude увидит помощника по имени content-reviewer и сможет его использовать, когда ты попросишь. Это удобно для повторяющихся задач — один раз описал, дальше просто вызываешь.

Если не планируешь часто гонять одну и ту же проверку — постоянные субагенты не обязательны. Разового запуска через промпт хватит в 90% случаев.