Разработчики, плотно работающие с Claude Code, сталкиваются с типичной проблемой: через час сессии контекст забит на 70%, качество ответов падает, модель пытается удержать в внимании десятки файлов. В апреле 2026 Anthropic выпустила механизм subagents, который решает эту проблему через делегирование, а месяц спустя дополнила его Dynamic Workflows с fan-out на сотни параллельных агентов и Performance Outcomes для автоматической оценки результата.
Subagent — это отдельный экземпляр Claude, который запускается из основной сессии и работает независимо. У него собственное контекстное окно, собственный системный промпт, собственный allowlist инструментов и опционально собственная модель. Основной (parent) агент видит только финальный summary, который вернул subagent, и не включает в свой контекст ни один из промежуточных шагов исследования или рассуждений. Технически subagent — это markdown-файл с YAML-фронтматом, лежащий в.claude/agents/<name>.md (проектный или глобальный уровень). Никакого SDK или регистрации: положил файл в нужную директорию, перезапустил сессию — агент доступен. Claude Code обнаруживает его автоматически при старте.
| Роль | Допустимые инструменты |
|---|---|
| Read-only auditor | Read, Grep, Glob |
| Bug fixer | Read, Edit, Bash, Grep, Glob |
| Documentation generator | Read, Write, WebFetch, WebSearch |
| Database query validator | Read, Edit, Bash + PreToolUse hook |
Frontmatter содержит четыре основных поля: name — идентификатор, по которому агент вызывается; description — текст, по которому parent-агент решает, делегировать ли задачу этому subagent; tools — allowlist инструментов; model — конкретная модель (sonnet, opus, haiku). Тело файла после frontmatter — это полностью системный промпт subagent. Parent-агент использует description каждого зарегистрированного subagent как сигнал для роутинга: сравнивает намерение задачи с описаниями и выбирает подходящего. Описание пишется не для людей, а для модели — в активной форме с триггерами. Можно форсировать вызов через директиву @code-reviewer в чате или флаг claude --agent code-reviewer в shell.
Определяется через markdown-файл с YAML-фронтматом в директории.claude/agents/
В Claude Code есть три встроенных subagent: Explore — быстрый read-only агент на Haiku для поиска и анализа кода (запрещены Write и Edit); Plan — используется в plan mode для сбора контекста перед написанием плана; general-purpose — catch-all для сложных multi-step задач. Важно ограничивать инструменты subagent: поле tools — это allowlist, поле disallowedTools — denylist. Если заданы оба, сначала применяется denylist, потом allowlist резолвится против оставшегося. Например, для read-only аудитора дают только Read, Grep, Glob; для bug fixer — Read, Edit, Bash, Grep, Glob; для генератора документации — Read, Write, WebFetch, WebSearch. Принцип наименьших привилегий здесь так же важен, как в любой security-чувствительной системе.
Появление subagents существенно снижает нагрузку на контекстное окно при длительных сессиях. Разработчики могут создавать специализированных ассистентов под конкретные задачи — code review, рефакторинг, написание тестов — и делегировать их выполнение без потери качества из-за переполнения контекста. Остаются открытыми вопросы стоимости: каждый subagent — отдельный инстанс модели, что может увеличить расходы, особенно при массовом использовании. Anthropic пока не раскрыла детали тарификации subagents подписок на Claude Code. В июне 2026 ожидается релиз инструментов мониторинга и логирования работы subagents, что позволит компаниям точнее оценивать затраты.
