Субагенты: запустить помощников

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

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

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

Главный агент (оркестратор) создаёт субагентов — отдельные изолированные разговоры. У каждого субагента чистый контекст, конкретная задача, и он не знает что делают другие.

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

Папка .claude/agents/

Каждый субагент — это markdown-файл в папке .claude/agents/. Создаёшь файл, описываешь агента — он готов к работе.

project/
  .claude/
    agents/
      researcher.md     ← агент для исследований
      code-writer.md    ← агент для написания кода
      reviewer.md       ← агент для проверки

Внутри каждого файла — два блока: шапка с метаданными и системный промпт. Вот как выглядит файл агента-исследователя:

---
name: researcher
description: Research agent. Searches for information, reads docs, summarizes findings.
  Use for: finding information, checking documentation, competitive analysis.
tools: Read, Grep, Glob
model: haiku
---

You are a research assistant. Your task is to find and summarize information.
Always cite sources. Be concise. Output structured summaries.

Поле description — самое важное. Именно по нему оркестратор решает, какого агента вызвать под конкретную задачу. Пиши описание чётко: что делает, когда использовать. Поле tools ограничивает доступ — если не указать, субагент наследует все инструменты главного агента. model можно задавать алиасом (sonnet/opus/haiku) или конкретным ID. Если не указать — наследует модель основной сессии.

Выбор модели под задачу

Разные агенты могут использовать разные модели. Это позволяет не тратить дорогие токены Opus на задачи, которые отлично решает дешёвый Haiku.

Сложная задача / принять решение → Opus
Написать код / рефакторинг / статья → Sonnet (по умолчанию)
Поиск / суммаризация / простой ответ → Haiku

Foreground или background

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

Background — субагент работает параллельно, главный агент не ждёт и занимается другими задачами. Это для независимых задач, которые можно делать одновременно.

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

"Запусти три агента параллельно:
 - Один ищет конкурентов в этой нише
 - Второй анализирует наш сайт
 - Третий пишет черновик статьи
 Жди всех трёх, потом соберём результаты."

Оркестрация через CLAUDE.md

Можно прописать в CLAUDE.md когда и какого агента вызывать. Тогда Claude сам будет выбирать нужного агента под тип задачи — без лишних объяснений:

## Агенты и когда использовать

Если задача = исследование → агент researcher
Если задача = написание кода → агент code-writer
Если задача = проверка результата → агент reviewer

Для комплексных задач: сначала researcher, потом code-writer, потом reviewer.

Это особенно удобно для повторяющихся рабочих процессов. Один раз описал логику — и не думаешь об этом каждый раз заново.

Встроенные субагенты Anthropic

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

Agent Teams — следующий уровень

Обычные субагенты не знают друг о друге — каждый работает в своём изолированном пузыре. Agent Teams — это другой режим, где агенты могут общаться между собой напрямую.

Когда это нужно: сложные исследовательские задачи, где важно рассмотреть тему с нескольких сторон — один агент ищет аргументы за, другой против, третий синтезирует. Или сценарии ревью, где один агент пишет, другой критикует.