Subagents в Claude Code: когда и как использовать
Subagent это подчинённый агент со своим контекстом. Главный агент поручает ему побочную работу вроде поиска по коду или исследования, получает обратно короткий результат, а весь промежуточный мусор остаётся в контексте субагента и не летит в основной. На задачах с перебором это режет расход и разгружает главное окно.
Зачем нужны субагенты
Без них поиск и исследование идут в основном контексте: агент перебирает десятки файлов, и все они оседают в окне, раздувая каждый следующий ход. Субагент делает эту грязную работу отдельно и возвращает выжимку. Основной контекст остаётся чистым и дешёвым.
Когда применять, а когда нет
| Задача | Subagent? |
|---|---|
| Найти по кодовой базе, где реализовано X | да |
| Исследовать незнакомую библиотеку | да |
| Проверить гипотезу по нескольким файлам | да |
| Простая правка в одном файле | нет, быстрее в основном |
| Линейная задача, где важна нить разговора | нет |
Свой субагент в файле
Готовые субагенты лежат в .claude/agents/ как markdown-файлы с фронтом:
--- name: code-explorer description: Ищет реализацию по кодовой базе. Используй, когда нужно понять, где и как работает функция или фича. tools: Read, Grep, Glob --- Ты поисковый агент. Не пиши код, только ищи. Верни: список файлов с путями и одной строкой, что в каждом релевантного.
После этого Claude Code сам зовёт code-explorer, когда задача подходит под описание. Инструменты ограничены: агент-исследователь не должен писать файлы.
Как это экономит токены
- Главный агент ставит задачу субагенту коротким промптом.
- Субагент перебирает файлы в своём контексте, основной их не видит.
- В основной контекст возвращается только результат: пути и выжимка.
- Следующий ход основного агента платит за компактный контекст, а не за сотни прочитанных файлов.
Экономия от субагентов виднее, когда платишь за токены напрямую. CLOD даёт доступ к Opus 4.8 и Sonnet 4.6 с оплатой рублём по факту расхода.
Частые вопросы
Subagent это то же, что и новый чат?
Нет. Новый чат вы начинаете вручную и теряете связь. Субагента вызывает сам Claude Code под задачу, и результат возвращается в основной разговор.
Может ли субагент писать код?
Может, если ему разрешены инструменты записи. Но для поиска лучше ограничить инструменты чтением, чтобы он не наредактировал лишнего.
Сколько субагентов можно держать в проекте?
Сколько угодно, но практично 3-5 под типовые задачи: исследователь, ревьюер, тестировщик. Больше превращается в шум.
Subagents работают с любой моделью?
Да, это механизм оркестрации, не свойство модели. На Opus 4.8 исследователь работает точнее, на Sonnet 4.6 дешевле.