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

Коротко

Субагент — это вспомогательный агент, которого основной кодинг-агент запускает, чтобы передать ему конкретную задачу. У него свои контекстное окно, инструкции и права на инструменты, а по завершении он возвращает только краткий итог, поэтому основной диалог не забивается подробностями.

Как это работает

Основной агент передаёт субагенту задачу, например поиск по кодовой базе, запуск тестов с кратким отчётом о сбоях или ревью изменения. Субагент начинает с чистого контекста; прочитанные им файлы и вывод команд остаются в его окне, а основной агент получает только результат. Несколько субагентов могут работать одновременно.

Как описать субагентов в Claude Code

В Claude Code субагенты — это Markdown-файлы с YAML-frontmatter. Субагенты проекта лежат в .claude/agents/, личные — в ~/.claude/agents/; управлять ими можно и командой /agents.

name и description: как называется субагент и когда его использовать. Основной агент решает по этому описанию.
tools: какими инструментами он может пользоваться, например только инструментами чтения для ревьюера.
model: при желании другая модель для субагента.
Тело файла — системный промпт субагента.

Когда субагенты помогают

Больше всего пользы от субагентов, когда нужно сохранить основной диалог чистым.

Исследование с чтением множества файлов: подробности остаются в субагенте, а основной контекст небольшим.
Узкие роли: проверка безопасности, написание тестов, документация.
Параллельное изучение: несколько субагентов одновременно просматривают разные модули.

Ограничения

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

Субагенты в AgentVera

AgentVera делает видимыми субагентов, которых запускает Claude Code. В представлении Subagents окна «тур по проекту и карта кода» перечислены субагенты, запущенные агентом Claude Code.

Для каждого: тип, работал ли он в фоне, статус, число инструментов и длительность, а также временная шкала его шагов.
Он читает локальные транскрипты и пока работает с локальными агентами Claude Code.
Линия задач, командный вид и параллельная команда используют вместо субагентов отдельных видимых агентов: у каждого своя панель и свой диалог, и с ним можно говорить напрямую.

FAQ

Чем субагент отличается от отдельной сессии агента?

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

Экономят ли субагенты токены?

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

Может ли субагент править файлы?

Это зависит от инструментов, разрешённых в его описании. Субагент, которому доступны только Read, Grep и Glob, может читать код, но не менять его.

Где хранить файлы субагентов?

Те, которыми должна пользоваться вся команда, кладите в .claude/agents/ в проекте; те, что нужны только вам, — в ~/.claude/agents/. Файлы в папке проекта доходят до команды через git.