Claude Code агенты: как делегировать задачи субагентам — гайд 2026
Субагенты в Claude Code это та фича, которую все включают месяц спустя после того, как она реально пригодилась бы. Я сам полгода игнорировал /agents, делал всё в основном чате и удивлялся, почему контекст забивается мусором за полтора часа работы. Потом разобрался, настроил четыре своих ИИ-агента Claude и теперь не понимаю, как раньше жил.
Ниже разбираю, что это такое, зачем нужно и как настроить за один вечер. Без воды про "будущее ИИ", только практика.
Что такое субагенты в Claude Code
Субагент: отдельный ИИ-помощник со своим контекстом, системным промптом и набором инструментов. Главный Claude в чате может его позвать, делегировать задачу и получить обратно только результат.
Ключевое отличие от обычного разговора: у обычного named subagent собственное окно контекста. Он не получает твою историю переписки, не знает, что ты обсуждал десять минут назад. Он получает задачу, делает её и возвращает summary. Всё, что произошло у него внутри, остаётся у него внутри.
Это как делегировать коллеге задачу "разберись с логином в этом репо и принеси мне выжимку на страницу". Ты ведёшь проект, тебе нужно понимать, как работает аутентификация в чужом коде. Можно полезть читать 40 файлов самому и забить голову деталями, можно отдать коллеге. Ты получишь выжимку, а сам останешься в курсе общей картины.
Субагент работает так же. Ты делегируешь задачу, получаешь ответ в 30 строк вместо 2000 строк сырого поиска по репозиторию. Главный диалог остаётся чистым.
Зачем нужны субагенты: 4 ситуации, где они спасают
Я выделил для себя четыре сценария, где субагенты окупаются.
Сохранение главного контекста. Помню, искал баг в auth-флоу: основной Claude вывалил мне 1200 строк grep-результатов по проекту, и через час я уже не помнил, с чего начали. Если эту работу делает субагент Explore, ты получаешь summary на 20-30 строк (где что лежит, как связано, что важно), а сырой вывод остаётся в его контексте, не в твоём.
Специализация под задачу. У каждого субагента свой системный промпт. Code-reviewer смотрит на код глазами ревьюера, ищет баги и проблемы читаемости. Debugger разбирает стектрейс и проверяет гипотезы. В основном чате этот фокус быстро размывается: Claude одновременно держит контекст задачи, историю обсуждения и текущие правки.
Параллельная работа. Можно запустить трёх субагентов одновременно. Пока один копается в API-маршрутах, второй смотрит миграции, третий разбирается с фронтом. Через минуту ты получаешь три summary вместо последовательного исследования на 15 минут.
Контроль модели и стоимости. Для каждого субагента задаётся своя модель. Простой поиск по коду: Haiku, она дешевле. Сложное архитектурное ревью: Opus, он мощнее. Не нужно гнать тяжёлую модель на задачи, где хватит лёгкой.
Как создать агента в Claude Code: два способа
Первый способ, интерактивный. В Claude Code запускаешь команду:
/agents
Откроется меню. Выбираешь "Create new agent", дальше Claude задаёт вопросы: имя, описание, инструменты, модель, системный промпт. По итогу файл сохраняется автоматически. Удобно, если не хочешь возиться с YAML руками.
Второй способ, вручную. Создаёшь md-файл с YAML frontmatter в одной из двух папок:
.claude/agents/в корне проекта: агент доступен только в этом проекте, можно закоммитить в git и делиться с командой~/.claude/agents/в домашней папке: агент доступен везде, на всех проектах
Минимальный пример файла .claude/agents/code-reviewer.md:
---
name: code-reviewer
description: Делает ревью изменённого кода, ищет баги, оценивает читаемость
tools: Read, Grep, Glob, Bash
model: sonnet
---
Ты ревьюер кода с опытом 10+ лет. Когда тебя зовут:
1. Посмотри изменения через git diff
2. Проверь читаемость, типизацию, обработку ошибок
3. Найди потенциальные баги и edge-cases
4. Верни список замечаний по приоритету: критично, важно, мелочи
Не предлагай переписать всё, не ругай стиль, если он консистентен.
Фокус на реальных проблемах, не на вкусовщине.
Из обязательных полей frontmatter только два: name (идентификатор латиницей через дефис) и description (когда Claude должен делегировать этому агенту). Остальное опционально. Кстати, важный момент: если ты создал файл вручную в редакторе, перезапусти сессию Claude Code, чтобы он подхватил агента. Агенты, созданные через /agents, работают сразу без рестарта. Дальше можно либо явно звать ("позови code-reviewer"), либо положиться на то, что Claude сам делегирует ревью, когда увидит подходящую задачу.
Frontmatter поддерживает ещё несколько полей: skills (подключить готовые скиллы), mcpServers (доступ к MCP), hooks (хуки на события). Подробнее в официальной документации (opens in new tab).
Встроенные субагенты Claude Code
На практике чаще всего встречаются три встроенных агента, которые Claude использует автоматически. Есть ещё служебные вроде statusline-setup и claude-code-guide, но они вызываются под конкретные задачи и в работе попадаются редко.
Explore. Ридонли-агент для поиска по кодовой базе. Работает на быстрой модели, умеет читать файлы, искать по regex, ходить по структуре. Когда ты просишь "найди, где обрабатывается оплата", Claude чаще всего делегирует это Explore и получает обратно карту: где лежит, что вызывается, какие зависимости.
Plan. Собирает контекст для plan mode. Когда ты переходишь в режим планирования, Plan сначала проходится по проекту, понимает архитектуру, читает релевантные куски и только потом Claude начинает формулировать план. Без этого этапа план получился бы абстрактным.
general-purpose. Универсальный агент для сложных многошаговых задач, которые не вписываются в специализацию. Используется как запасной вариант, когда задача требует и поиска, и анализа, и небольших действий.
Что важно: ты не обязан их звать руками. Claude сам решает, когда делегировать. Если задача пахнет поиском, отдаст Explore. Если ты в plan mode, отдаст Plan. Можно посмотреть, кого он позвал, в выводе.
Примеры готовых субагентов с кодом
Покажу три md-файла, которые лежат у меня и работают.
code-reviewer
---
name: code-reviewer
description: Ревью кода после изменений, ищет баги и проблемы читаемости
tools: Read, Grep, Glob, Bash
model: sonnet
---
Ты senior-разработчик, который делает ревью.
Алгоритм:
1. Сначала git status и git diff, чтобы понять что изменилось
2. Прочитай файлы целиком, не только diff (нужен контекст)
3. Проверь: типизация, обработка ошибок, edge-cases, безопасность
4. Сгруппируй замечания: 🔴 критично, 🟡 важно, 🟢 мелочи
5. Если всё хорошо, так и скажи, не выдумывай проблемы
Не предлагай переписать архитектуру. Не спорь о табах против пробелов.
Если не хочешь писать промпт с нуля, можно подключить готовый скилл Code Reviewer (opens in new tab) через поле skills: в frontmatter. Claude Code прелоадит полный контент скилла в контекст субагента, не просто ссылку:
skills:
- code-reviewer
Скилл уже содержит проверенный системный промпт и инструкции, ты получаешь его весь, без копипасты.
debugger
---
name: debugger
description: Анализирует ошибки, стектрейсы и помогает найти причину бага
tools: Read, Grep, Glob, Bash
model: sonnet
---
Ты отладчик. Когда тебя зовут с ошибкой:
1. Прочитай стектрейс снизу вверх, найди точку отказа
2. Открой файл с ошибкой, прочитай функцию целиком
3. Проследи, какие данные туда приходят и откуда
4. Сформулируй 2-3 гипотезы о причине
5. Предложи минимальный способ проверить каждую
Не угадывай вслепую. Если данных не хватает, скажи, какие логи добавить.
Аналогично, готовый промпт можно взять из скилла Debugging Wizard (opens in new tab) и подключить вместо самописного.
content-researcher
Этот для маркетолога, не для кода:
---
name: content-researcher
description: Исследует тему для статьи, собирает источники и тезисы
tools: WebSearch, WebFetch, Read
model: sonnet
---
Ты контент-исследователь. Когда дают тему:
1. Найди 5-7 авторитетных источников по теме (документация, исследования, кейсы)
2. Выпиши ключевые тезисы и факты с указанием URL
3. Найди 2-3 угла, под которыми тема ещё не раскрыта
4. Верни структурированный бриф: тезисы, цитаты, источники, идеи углов
Не пересказывай статьи целиком. Для быстро меняющихся тем проверяй дату публикации и предпочитай актуальные источники.
Этого агента я связываю со скиллом Контент-стратегия (opens in new tab), чтобы он сразу выдавал бриф в нужном для блога формате.
Параллельная работа и команда агентов
Самая недооценённая фича. В одном сообщении можно вызвать несколько субагентов сразу, и они побегут параллельно.
Пример: я пишу новую фичу для авторизации и хочу понимать, как она ляжет на существующий код. Прошу Claude:
"Параллельно: посмотри, как сейчас устроены роуты в app/api/auth, какие миграции связаны с user_sessions, и какие компоненты на фронте используют auth-контекст".
Claude запускает три инстанса Explore одновременно. Каждый идёт в свою область, через пару минут возвращаются три summary, я получаю целостную картину быстрее, чем если бы шёл последовательно.
Когда окупается: задача делится на независимые куски, и для каждого нужен поиск или анализ. Когда не окупается: задачи цепляются друг за друга (результат первой нужен второй), или вся работа в одном файле, параллелить нечего.
Для совсем больших проектов есть продвинутый случай: agent teams (opens in new tab), где несколько сессий Claude Code координируются через общий список задач и сообщения между участниками. Фича экспериментальная, включается отдельно, для одного разработчика обычно избыточно.
Когда субагенты избыточны
Не каждая задача требует делегирования. Антипаттерны, на которых я обжёгся.
Простая задача в 1-2 шага. Если нужно поправить опечатку или переименовать переменную, не зови агента, сделай руками. Накладные расходы на запуск субагента (он же грузит свой контекст с нуля) превысят выгоду.
Нужен полный контекст разговора. Обычный named subagent не получает историю основного чата. Если задача завязана на детали из истории, кратко переформулируй ему задачу с нужным контекстом или делай в главном диалоге.
Субагенты не спавнят других субагентов. Это явное ограничение (opens in new tab) для обычного режима. Если ты строишь иерархию "босс зовёт менеджера, менеджер зовёт исполнителей", не выйдет: цепочку нужно строить из основного диалога.
Искусственное разделение. Если задача естественно решается в одном диалоге, не разрывай её насильно. Иногда проще оставить всё в основном чате, даже если контекст немного разрастётся.
Правило: делегируй, когда задача объёмная по контексту (много файлов, много вывода) или требует другого фокуса (ревью, отладка, исследование). В остальных случаях работай напрямую.
Частые вопросы
Чем субагенты отличаются от скиллов Claude?
Субагент это исполнитель с собственным контекстом и набором инструментов. Скилл это переиспользуемый рецепт, инструкция, которая подключается к субагенту или к главному Claude. Если коротко: субагент это сотрудник, а скилл это методичка, по которой он работает. Можно создать субагента и подключить ему скилл через поле skills: в frontmatter, тогда не нужно писать промпт с нуля. Удобно начинать со Skill Creator (opens in new tab), который помогает собрать свой скилл по шаблону.
Можно ли передать субагенту доступ к MCP?
Да, через поле mcpServers во frontmatter. Указываешь, какие MCP-серверы из настроенных проектом доступны конкретно этому агенту. Если у тебя своих MCP пока нет, посмотри MCP Builder (opens in new tab), он поможет собрать собственный сервер под нужный сервис.
Какую модель выбрать для субагента?
По задаче. Для поиска по коду и простой обработки текста хватит Haiku, она дешевле и быстрее. Для архитектурного ревью, сложной отладки, генерации кода бери Sonnet или Opus. Если сомневаешься, начни с Sonnet, он закрывает большинство случаев.
Где хранить файлы субагентов: в проекте или глобально?
Зависит от агента. Code-reviewer под конкретный стек кладу в .claude/agents/ проекта, потому что промпт привязан к языку и фреймворку. Универсальные вещи (general-purpose researcher, debugger) живут в ~/.claude/agents/, чтобы были везде. Я держу два-три глобальных и по 3-5 проектных на каждый репозиторий.
Можно ли делиться субагентами с командой через git?
Да, для этого и придумали .claude/agents/ в корне проекта. Коммитишь md-файлы, коллеги клонируют репо, у них появляются те же агенты автоматически. Это работает в обе стороны: если кто-то улучшил промпт, PR прилетает к тебе. Так агенты становятся частью кодовой базы.
Что такое Claude Agent SDK и зачем он нужен?
Claude Agent SDK это библиотека для построения собственных агентов вне Claude Code, например в своих сервисах или ботах. Если ты хочешь встроить агентов в продукт, не привязываясь к IDE, SDK даёт API для управления контекстом, инструментами и оркестрацией. Для внутренней работы в Claude Code SDK не нужен, достаточно /agents и md-файлов.
Итого
Субагенты остаются одной из самых практичных фич Claude Code, которую большинство не использует первые месяцы. Они дают чистый главный контекст, специализацию под задачи и параллельную работу там, где обычно приходится ждать.
С чего начать сегодня:
- Открой проект, запусти
/agents, создай одного агента под свою частую задачу (ревью, отладка, поиск) - Положи md-файл в
.claude/agents/и закоммить - Поработай неделю, посмотри, что Claude делегирует, поправь промпт
- Добавь второго агента, когда поймёшь, какая задача снова забивает контекст
Если не хочешь писать промпты с нуля, собери своего агента на базе готового скилла из каталога. Skill Creator (opens in new tab) поможет упаковать твой собственный рецепт в переиспользуемый скилл, который потом подключается к любому субагенту одной строкой во frontmatter.
Главное правило: не пытайся делегировать всё. Начни с одной болезненной задачи, доведи её до ума, потом масштабируй. Через месяц у тебя в .claude/agents/ будет 3-5 файлов, и Claude сам начнёт звать нужного агента в нужный момент.
