Субагенты в Claude Code
Каждый subagent получает собственное контекстное окно, системный промпт, модель и набор разрешённых инструментов, а основной агент видит только итоговое резюме. Агент задаётся обычным Markdown-файлом с YAML-frontmatter в каталоге .claude/agents/: поле description отвечает за автоматический выбор исполнителя, tools ограничивает доступные действия, а model позволяет разделять задачи между Haiku, Sonnet и Opus.
Subagents можно запускать последовательно, параллельно или веером. Последовательная схема подходит для зависимых этапов вроде спецификации, разработки и проверки, параллельная — для независимых ревью, тестов и документации, а fan-out — для массовой обработки десятков или сотен однотипных задач. Для повседневной работы автор считает разумным пределом 3–5 параллельных агентов, после которого расходы на координацию начинают съедать выигрыш во времени.
Изоляция контекста требует дополнительных токенов и строгих разрешений: по оценке автора, workflow с активным использованием subagents может расходовать примерно в семь раз больше токенов, чем одиночная сессия. Для простой инструкции лучше использовать skill, для детерминированного действия — tool call, для обязательной проверки — hook; subagent нужен тогда, когда отдельную тяжёлую работу действительно стоит вынести из основного контекста.
Коротко
- Subagent настраивается Markdown-файлом с YAML-frontmatter и автоматически обнаруживается Claude Code при запуске сессии.
- Поле description служит сигналом маршрутизации, поэтому его советуют писать как конкретный триггер для модели, а не как описание для человека.
- Allowlist tools и session-level permissions снижают риск опасных действий, включая случайные изменения файлов и деструктивные команды Bash.
- Для оценки эффективности автор предлагает отслеживать acceptance rate, стоимость задачи, экономию времени и долю отклонённых результатов.
- Конфигурации subagents можно хранить в репозитории и распространять через Git, превращая настройки агентов в часть кодовой базы.
FAQ
Зачем выносить задачу в subagent, если Claude Code может выполнить её в основной сессии?
Чтобы промежуточные файлы, рассуждения и выводы не заполняли основной контекст. Parent-агент получает только итоговое резюме и сохраняет место для общего плана.
Как выбрать между subagent, skill, tool call и hook при настройке рабочего процесса?
Skill добавляет технику в основной контекст, tool call выполняет детерминированное действие, hook обеспечивает обязательное правило, а subagent изолирует отдельную сложную работу.
Как снизить стоимость параллельной работы нескольких subagents в Claude Code?
Можно назначать дешёвые модели для read-only задач, ограничивать число параллельных агентов и задавать общую модель через CLAUDE_CODE_SUBAGENT_MODEL.
Читайте также
Когда, зачем и как правильно начинать новую сессию в Claude Code
«Сильно отстаём»: Цукерберг признал замедление Meta* в разработке ИИ-агентов- ИИ-агенты для бизнеса в России: обзор 10 локальных платформ и решений
- Инструменты для подготовки сайта к работе с AI-агентами
- Мультиагентная разработка в Cursor: как заставить субагентов работать на большие проекты
- Изоляция сложных задач через subagents в Claude Code: Subagent запускается как отдельный экземпляр Claude со своим контекстным окном, системным промптом, моделью и набором инструментов. Основная сессия получает только итоговое резюме, поэтому промежуточное исследование не переполняет её контекст.
[AI-разработка / Управление контекстом]
Зарегистрированные пользователи видят только два тезиса.
Зарегистрироваться
Claude Code поддерживает subagents — отдельные экземпляры Claude для изолированного выполнения сложных задач без переполнения контекста основной сессии. Автор разбирает настройку агентов, схемы оркестрации, ограничения инструментов и способы контролировать расходы.