Субагенты в Claude Code: делегирование и параллельная работа
Что такое субагенты в Claude Code, зачем помощник запускает себе помощников и когда это полезно. Простыми словами, на реальном опыте QuboLab.
Обновлено 30 июня 2026 г.
Субагент — это отдельный помощник, которого Claude Code запускает для одной узкой задачи. Представьте, что у главного помощника есть стажёры: он отправляет одного «обыщи весь проект и найди, где это используется», другого — «продумай план переделки», а сам ждёт от них короткий отчёт. Главное удобство в том, что вся черновая работа стажёра не засоряет внимание основного помощника — назад приходит только готовый результат. А ещё несколько стажёров могут работать одновременно.
Определение
Обычно вы общаетесь с одним помощником-агентом. Но на крупной задаче ему приходится держать в голове слишком много всего сразу, и он начинает путаться.
Субагент решает это разделением труда. Главный помощник поручает кусок работы отдельному помощнику — с чистой «головой» и узкой задачей. Тот делает своё дело (например, перелопачивает сотню файлов в поиске нужного) и возвращает только выжимку. Вся гора прочитанного остаётся у субагента и не забивает основную беседу. Получается как с командой: руководитель не вникает в каждую бумажку сам, а раздаёт поручения и собирает итоги.
Когда использовать
Субагенты особенно полезны на больших и параллельных задачах:
- Поиск по большому проекту. «Найди все места, где мы дёргаем этот сервис» — субагент перероет файлы и вернёт список, не вываливая вам сотни строк.
- Продумать план перед работой. Отдельный помощник изучает код и предлагает план, а основной потом по нему действует.
- Несколько дел разом. Пока один субагент ищет, другой проверяет — они работают параллельно и экономят время.
Когда НЕ стоит
Делегировать имеет смысл не всегда:
- Простая задача в пару шагов. Запуск отдельного помощника — это лишние хлопоты; мелочь основной помощник сделает сам быстрее.
- Когда важен живой диалог. Субагент уходит, делает и возвращается с отчётом — по ходу его не поправить. Где нужно обсуждать на каждом шаге, лучше работать напрямую.
- Когда вы хотите видеть процесс. Вам приходит итог субагента, а не вся его «кухня». Если вам важно следить за каждым действием, делегирование тут мешает.
Пошаговая инструкция
Чаще всего помощник сам решает, когда позвать субагента. Но логику стоит понимать, чтобы направлять его.
- 1Понять, что задача «широкая»
Если задача требует перелопатить много всего (обыскать проект, сверить десятки файлов) или распадается на независимые куски — это кандидат на делегирование. Узкую правку в одном файле делегировать незачем.
- 2Попросить делегировать
Можно прямо сказать: «поищи это по всему проекту через субагента» или «сначала пусть отдельный помощник составит план». Часто Claude Code и сам предлагает позвать субагента на подходящей задаче.
- 3Дождаться отчёта
Субагент работает у себя и возвращает выжимку — найденное, предложенный план. Основная беседа при этом остаётся чистой: в неё попадает результат, а не весь черновой поиск.
- 4Действовать по результату
Дальше работаете как обычно: принимаете план, правите по найденному списку. Если субагентов было несколько и они шли параллельно — вы получаете их итоги вместе.
Пример
Работая над этим проектом QuboLab, я постоянно так делаю. Когда нужно понять, как устроена незнакомая часть кода, я запускаю субагента-исследователя: он сам обходит десятки файлов и возвращает короткий ответ «вот здесь и вот здесь», вместо того чтобы вываливать мне всё их содержимое. А перед крупной переделкой отправляю субагента-планировщика — он изучает код и предлагает порядок действий.
Выигрыш двойной: основная беседа не забивается сотнями строк чужого кода, и пока один субагент ищет, другой может заниматься своим. По сути это команда из нескольких ИИ-помощников под одной задачей.
Частые ошибки
Типичные заблуждения:
- Ждут, что субагент продолжит беседу. Он стартует «с чистого листа», вашей переписки не знает. Поэтому задачу ему надо описать целиком, а не намёком «ну ты помнишь».
- Делегируют мелочь. На простой правке запуск отдельного помощника только замедляет. Делегирование окупается на широких задачах.
- Хотят вмешаться в процесс. Субагент возвращает итог, а не пошаговый разговор. Нужен контроль на каждом шаге — работайте с основным помощником напрямую.
- Путают с MCP. MCP даёт помощнику новые умения (доступ к сервисам). Субагент — это не новое умение, а отдельный исполнитель той же работы.
Частые вопросы
Субагент — это другая нейросеть?+
Нет, это тот же Claude, просто запущенный отдельным экземпляром под узкую задачу и с чистым контекстом. Можно сказать, главный помощник создаёт себе временного помощника на одно поручение.
Чем субагент отличается от обычного помощника?+
Обычный агент ведёт с вами беседу и помнит её ход. Субагент — одноразовый исполнитель: получил задачу, сделал, вернул отчёт и закрылся. Он нужен, чтобы разгрузить основную беседу и работать над несколькими делами параллельно.
Я сам должен решать, когда звать субагента?+
Не обязательно. Claude Code часто сам понимает, что задача широкая, и предлагает делегировать. Но вы можете и попросить напрямую — например, «поищи через субагента» или «сначала пусть отдельный помощник составит план».
Это дороже по расходам?+
Несколько помощников делают больше работы, чем один, поэтому и расход на задачу может быть выше. Зато широкая задача решается быстрее и не засоряет основную беседу. На крупных делах это обычно оправданно, на мелких — нет.
Термины
- Субагент (subagent)Субагент — это отдельный ИИ-помощник, которого основной помощник запускает под одну узкую задачу: что-то найти, продумать план, проверить. Он делает своё дело «с чистого листа» и возвращает короткий итог, не засоряя основную беседу.
- ИИ-агент (agent)ИИ-агент — это помощник на основе искусственного интеллекта, который не просто отвечает текстом, а действует сам: берётся за задачу, делает шаг, смотрит на результат и решает, что дальше — и так, пока не доведёт дело до конца.
- Контекст (контекстное окно)Контекст — это то, что ИИ-помощник держит «в голове» прямо сейчас: ваш вопрос, открытые файлы, ход беседы. Объём этой «головы» ограничен — что в неё не поместилось, того помощник в этот момент как будто не знает.