Subagents в Claude Code: как делегировать задачи и ускорить разработку

Андрей Отинов -

publishable: true

Как использовать subagents в Claude Code для ускорения разработки

Сцена: Вы открываете проект в Claude Code, загружаете CLAUDE.md, открываете десятки файлов, обсуждаете план рефакторинга. Через час контекст уже заполнен на 70 %. Каждый новый запрос к ассистенту отвечает всё медленнее, а качество рекомендаций падает, потому что модель пытается удерживать в памяти сразу сорок файлов.

Источник: Habr

Факт: В апреле 2026 года компания Anthropic выпустила механизм subagents — отдельные помощники, которые запускаются из основной сессии и работают в собственном контекстном окне.

Последствие: Основной чат остаётся лёгким и быстрым, а повторяющиеся задачи (например, проверка кода, поиск уязвимостей, оценка производительности) можно делегировать этим помощникам. Вы получаете ответы быстрее и экономите токены.

Что проверить: Есть ли в вашем процессе задачи, которые можно оформить в виде отдельного помощника? Готовы ли вы описать их так, чтобы модель поняла, когда их вызывать?

Что изменилось в практике работы с Claude Code

Subagent — это отдельный экземпляр Claude, который запускается из основной сессии. У него своё контекстное окно, собственный системный запрос и список разрешённых инструментов. Основной (parent)‑агент видит только итоговое резюме, а не промежуточные шаги работы помощника. Технически такой помощник — обычный markdown‑файл с YAML‑front‑matter, который помещается в каталог

.claude/agents/<имя>.md   (для проекта) 
или
~/.claude/agents/<имя>.md   (для пользователя)

Никакой отдельной SDK, регистрации или компиляции не требуется: достаточно создать файл, перезапустить сессию, и Claude Code автоматически обнаружит нового помощника.

Почему это важно именно сейчас

  • Скорость: Когда основной контекст переполняется, каждый запрос обрабатывается дольше. Делегируя часть работы subagents, вы сохраняете основной чат «тонким», а ответы приходят быстрее.
  • Масштабируемость: В март 2026 года Anthropic добавила Dynamic Workflows — возможность запускать сотни агентов параллельно (fan‑out) и автоматически оценивать их результаты (Performance Outcomes). Это открывает путь к автоматическому тестированию, массовому рефакторингу и другим тяжёлым операциям без потери отзывчивости.
  • Контроль расходов: Поскольку каждый subagent использует отдельный контекст, вы можете ограничить количество токенов, которые он потребляет, и сравнивать эффективность разных помощников.

Как превратить это в повторяемый рабочий процесс

  1. Определите задачу, которую хотите делегировать.
    Пример: автоматический обзор кода после каждого коммита.
  2. Создайте markdown‑файл с YAML‑front‑matter.
    ```yaml

name: code-reviewer description: Senior code reviewer. Use immediately after writing or modifying code. tools: Read, Grep, Glob model: sonnet

You are a senior code reviewer focused on quality, security, and maintainability.

When reviewing changes: 1. Read the diff carefully and identify modified files 2. Check for security issues (input validation, secrets, auth) 3. Look for performance problems (N+1 queries, memory leaks) 4. Verify error handling and edge cases 5. Suggest concrete improvements with code examples

Return your review as: - Summary (2‑3 sentences) - Critical issues (must fix before merge) - Suggestions (nice to have) - LGTM‑points (what's done well) ```

  1. Поместите файл в нужный каталог (.claude/agents/ или ~/.claude/agents/).
  2. Перезапустите Claude Code — помощник появится в списке доступных.
  3. Вызовите помощника:
  4. Через чат‑директиву @code-reviewer.
  5. Через командную строку claude --agent code-reviewer.
  6. Настройте описание (description) как сигнал для модели.
    Пишите в активной форме, указывая триггер: «Use immediately after writing or modifying code». Чем точнее формулировка, тем надёжнее будет автоматический роутинг.
  7. Проверьте результаты: сравните вывод помощника с ожидаемым форматом, убедитесь, что он не «утекает» в лишние детали.

Лучшие практики описания

Что писать в description Почему это работает
Use immediately after writing or modifying code Явный триггер «сразу после изменения кода».
Use when the user asks about database performance issues Связывает запрос с конкретной темой, модель быстрее выбирает нужный помощник.
Избегайте: «Reviews code quality», «Database expert» Такие формулировки слишком общие, модель может не понять, когда их применять.

Где находятся ограничения и риски

Риск Как его минимизировать
Дополнительные токены — каждый subagent потребляет свои токены, что может увеличить расходы. Ограничьте модель (model) в front‑matter до нужного уровня (например, sonnet вместо более дорогих opus).
Неправильный роутинг — если описание слишком расплывчатое, основной агент может не вызвать нужного помощника. Пишите описания в активной форме с чёткими триггерами, проверяйте работу через директиву @name.
Отсутствие встроенных инструментов — помощник может не иметь доступа к нужным утилитам. Указывайте необходимые инструменты в поле tools (например, Read, Grep, Glob).
Сложные цепочки — вложенные subagents могут запутать логику. На начальном этапе используйте один уровень делегирования, добавляйте вложенность только после проверки.
Неожиданные ошибки — помощник может вернуть неполный или неверный результат. Включайте в описание проверку Performance Outcomes (если доступно) или вручную проверяйте вывод перед автоматическим принятием.

Что сделать уже на этой неделе

Шаг Действие
1 Выберите одну повторяющуюся задачу (например, проверку стиля кода).
2 Сформулируйте её в виде активного описания (см. таблицу выше).
3 Создайте markdown‑файл с YAML‑front‑matter и разместите его в ~/.claude/agents/.
4 Перезапустите Claude Code и вызовите помощника через @имя.
5 Оцените время ответа и качество вывода, сравните с текущим процессом.
6 При необходимости скорректируйте description или список tools.

Источники

  • https://habr.com/ru/companies/otus/articles/1054590/?utm_source=habrahabr&utm_medium=rss&utm_campaign=1054590
  • Habr: Subagents в Claude Code – https://habr.com/ru/companies/otus/articles/1054590/

Эти рекомендации помогут вам быстрее внедрять subagents в ваш процесс разработки и экономить ресурсы.

Темы журнала

Что почитать дальше