← ПрактикаПрактика · Claude Code

Субагенты в Claude Code: выносите роль в файл, а не в промпт

Механика субагентов Claude Code на практике: изоляция контекста, параллельный запуск, постоянные субагенты через файлы в ~/.claude/agents/, с конкретным планом на первую неделю.

· 3 мин чтения

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

Что такое субагент

Субагент (subagent) в Claude Code — это отдельный запуск модели со своим контекстом. В основной чат он возвращает только итог, а черновики (открытые страницы, промежуточные заметки, поисковые запросы) остаются у него «в кабинете».

Четыре субагента работают параллельно, поэтому общее время равно самой долгой задаче, а не их сумме. На разборе 13 статей с vc.ru команда из трёх субагентов по спискам и четвёртого, который искал похожие материалы с охватом от 50 тысяч просмотров, уложилась в 30 минут вместо полутора дней ручной работы. Самый быстрый справился за 7 минут, самый медленный почти за полчаса.

Постоянный субагент как должностная инструкция

Разовый заказ удобен, но настоящая экономия начинается с постоянных субагентов. Технически — это обычный текстовый файл в папке ~/.claude/agents/ на компьютере: внутри имя, короткое описание и инструкция. По описанию Claude Code сам решает, когда такого субагента звать.

Сокращённый пример агента-аналитика из практики автора:


name: аналитик-отчётов description: Анализирует маркетинговые отчёты и таблицы, находит аномалии и точки роста — Ты — аналитик маркетингового агентства. Получив отчёт: 1. Сравни показатели с прошлым периодом, отметь изменения больше 20% в любую сторону. 2. Для каждой аномалии предложи гипотезу причины. 3. Верни выжимку: 3 главных вывода, 3 рекомендации, каждая с цифрой из отчёта.

Почему это лучше длинных промптов

  • Изоляция черновиков. Открытые страницы, поисковые выдачи и промежуточные заметки не засоряют основной чат, туда приходит только готовый результат.
  • Параллельность. Каждый субагент берёт свой кусок работы, общее время равно самому медленному.
  • Инструкция живёт в файле. Один раз описали роль в ~/.claude/agents/, дальше Claude Code сам подбирает её под задачу по описанию субагента.

Как применить

  1. Поставьте первое параллельное задание вручную. Сформулируйте как «изучи [ссылки], запусти параллельно несколько субагентов, каждый вернёт [формат], потом сведи в один вывод». Claude Code сам раздаст работу и сведёт результат, никаких настроек не нужно.
  2. Выпишите три самые повторяющиеся задачи недели. Это кандидаты в постоянные субагенты: копирайтер с голосом бренда, аналитик отчётов, проверяльщик стиля.
  3. Попросите Claude Code создать постоянного субагента под самую частую задачу. «Создай субагента, который проверяет тексты на соответствие нашему стилю: [правила]», и он сам напишет файл и положит его в ~/.claude/agents/, вам останется проверить инструкцию.
  4. Проверьте субагента на реальной задаче и поправьте инструкцию по результату. Первое ТЗ он поймёт по-своему, к третьему разу формулировки встанут на место. Заведите файл с удачными постановками, окупится быстрее всего.
  5. Посмотрите готовые библиотеки на GitHub: wshobson/agents даёт больше 200 субагентов под разные профессии, contains-studio/agents — это целый «отдел» из маркетологов, аналитиков и дизайнеров. Скачиваются архивом без регистрации, раскладываются в ту же папку, это тоже можно поручить Claude Code.
  6. Учитывайте лимиты. Несколько параллельных субагентов расходуют подписку примерно как несколько активных чатов одновременно; на тарифе Pro за $20 это заметно, тяжёлые исследования лучше планировать заранее.