Агенты Claude Code: субагенты, фоновые задачи и общий лимит
Агенты Claude Code могут делегировать задачи другим ИИ-помощникам внутри сессии. Такие субагенты работают в отдельных контекстных окнах, используют собственные инструкции и возвращают результат основному агенту. Их запросы расходуют тот же лимит использования, что и основная беседа.
Для разработчика разница заметна при поиске по репозиторию, запуске тестов и работе с логами. Промежуточные данные можно оставить в отдельном контексте, но выполнение дополнительных запросов к модели продолжает учитываться.
Каждый субагент получает отдельный контекст и инструменты
Субагент запускается для определённой задачи. Он получает системные инструкции, сообщение с поручением, набор инструментов и собственные разрешения.
Контекстное окно представляет собой информацию, доступную модели во время выполнения запроса.
Обычный субагент начинает работу с новым контекстом. Он не видит всю историю основной беседы или файлы, которые Claude уже прочитал. Вместо этого Claude составляет отдельное сообщение с описанием задачи.
Для специальных ответвлений сессии, называемых forks, предусмотрено наследование родительского контекста.
При запуске многие субагенты получают инструкции из CLAUDE.md и сведения о состоянии Git. Explore и Plan по умолчанию пропускают эти данные, чтобы ускорить исследование проекта.
После завершения работы результат возвращается в основную сессию. Большие промежуточные выводы остаются у субагента.
Разбираю Claude Code и ИИ-агентов на практике: как применять их в реальных рабочих задачах, автоматизировать рутину, собирать собственных ИИ-ассистентов и зарабатывать с помощью новых технологий. Практические разборы, инструменты, кейсы и эксперименты: от первого ИИ-агента до полноценных рабочих систем. Подписывайтесь.
Explore, Plan и general-purpose решают разные задачи
Встроенные помощники Claude Code различаются назначением и правами.
Explore
• Ищет файлы и исследует кодовую базу.
• Использует инструменты только для чтения.
• Не имеет доступа к Write и Edit.
• Поддерживает уровни поиска quick, medium и very thorough.
По умолчанию модель Explore связана с моделью основного диалога. Для Fable предусмотрены особенности, зависящие от способа подключения.
Plan
• Собирает сведения о проекте в режиме планирования.
• Работает с инструментами чтения.
• Не изменяет файлы.
General-purpose
Предназначен для сложных задач, объединяющих исследование и выполнение действий. Может использовать все инструменты, доступные субагентам.
Дополнительно встроены claude, statusline-setup на Sonnet и claude-code-guide на Haiku. Последний используется для вопросов о функциях Claude Code.
Автоматическое делегирование зависит от description
Claude выбирает субагента на основе содержания запроса, текущего контекста и поля description в определении помощника.
Поэтому описание пользовательского субагента должно ясно указывать, какие задачи ему поручать.
При необходимости запуск можно запросить вручную.
Первый вариант предусматривает обычный текст:
text
Use the test-runner subagent to fix failing tests
Claude получает указание, но самостоятельно решает, делегировать ли задачу.
Второй вариант использует @-упоминание:
text
@"code-reviewer (agent)" look at the auth changes
Такой вызов гарантирует запуск указанного субагента для одной задачи.
Третий способ позволяет запустить всю сессию от имени выбранного агента:
bash
claude --agent code-reviewer
В этом случае действуют модель и ограничения инструментов выбранного помощника.
Модель субагента можно задать отдельно
Для определения модели предусмотрено поле model.
Поддерживаются псевдонимы sonnet, opus, haiku, fable, полный идентификатор модели и значение inherit, означающее наследование модели основной сессии.
Claude Code выбирает модель по определённому порядку:
1. Параметр конкретного запуска.
2. Поле model в определении субагента.
3. Переменная CLAUDE_CODE_SUBAGENT_MODEL.
4. Модель основного диалога.
Отдельные правила предусмотрены для встроенных Explore и Plan. Обычная установка CLAUDE_CODE_SUBAGENT_MODEL сама по себе не меняет их модель.
Для простых операций Anthropic рекомендует выбирать Haiku. При необходимости все субагенты могут работать на одной модели.
Узнать фактически используемую модель можно через /tasks. В списке показываются запущенные помощники и их модели.
Фоновые субагенты работают параллельно с основной сессией
Claude Code поддерживает foreground и background.
Foreground означает, что основной диалог ожидает завершения работы помощника.
Background позволяет продолжать собственную работу, пока субагент выполняет поручение.
По умолчанию субагенты, созданные Claude из основной беседы, запускаются в фоне.
Если фоновому помощнику нужно разрешение на действие, Claude Code выводит запрос в основной сессии с указанием имени агента.
Пользователь может подтвердить действие или нажать Esc. Отказ относится к конкретному вызову инструмента и не останавливает помощника.
Долгосрочное разрешение, выданное из такого запроса, применяется ко всей сессии.
Фоновые субагенты используют сокращённый набор встроенных инструментов. Исключения предусмотрены для ответвлений беседы и возобновлённых foreground-субагентов.
Fork mode управляет ожиданием результатов субагента
В интерактивных сессиях fork mode по умолчанию включён.
Для изменения поведения документация предлагает установить CLAUDE_CODE_FORK_SUBAGENT в 0.
Пример в settings.json:
json
{
"env": {
"CLAUDE_CODE_FORK_SUBAGENT": "0"
}
}
После изменения необходимо заново запустить Claude или открыть новую беседу VS Code.
Теперь можно попросить Claude выполнить задачу субагентом и дождаться отчёта.
Для переноса выполняющегося действия в фон в терминале предусмотрено Ctrl+B, а в VS Code действие Run in background.
Отдельная переменная CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 отключает фоновые задачи и заставляет Claude ожидать завершения субагентов.
Запросы всех помощников расходуют одну квоту
Каждый субагент отправляет самостоятельные запросы к модели. Они учитываются в лимите основной сессии.
Отдельный контекст означает изоляцию информации, но не отдельный лимит подписки.
Если несколько помощников выполняют исследования параллельно, каждый расходует доступный объём. Поэтому лимиты Claude необходимо оценивать с учётом основной беседы и делегированной работы.
Для анализа используется:
text
/usage
В разделе Attribution показано распределение недавнего использования между субагентами, Skills, плагинами и MCP-серверами.
Доли выводятся в процентах от общего использования. Они характеризуют расход, к которому относится категория, а не объём сэкономленных ресурсов.
Рекомендации по сокращению расхода также появляются в соответствующем разделе /usage.
Тесты, документацию и логи полезно изолировать
Один из рекомендованных сценариев связан с выполнением операций, возвращающих большие объёмы текста.
Например, субагент может запустить тесты и сообщить только о неудачных проверках с текстами ошибок:
text
Use a subagent to run the test suite and report only the failing tests with their error messages
Субагент обрабатывает подробный вывод самостоятельно. Основной диалог получает краткий отчёт.
Другой сценарий предусматривает параллельное исследование независимых частей проекта:
text
Research the authentication, database, and API modules in parallel using separate subagents
После завершения Claude объединяет результаты.
Если поручить многим помощникам возвращать подробные отчёты, основной контекст всё равно может быстро заполниться. Сами субагенты также расходуют токены во время работы.
Claude Code допускает 20 одновременных субагентов
По умолчанию ограничение составляет 20 одновременно работающих субагентов в одной сессии.
При достижении предела новая попытка запуска через Agent завершается сообщением:
text
Concurrent subagent limit reached
Ограничение можно настроить через:
text
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS
Переменная принимает положительное целое число. Для сессий с активным ultracode ограничение не применяется.
Учитываются и некоторые другие работающие ответвления, хотя для их запуска предусмотрены исключения.
Общего ограничения на количество последовательно завершённых субагентов за сессию нет.
Для коротких изменений отдельный субагент необязателен
Основной диалог лучше подходит для задач, где нужны постоянные уточнения, быстрая правка или последовательные этапы с общим контекстом.
Субагенту без наследования беседы требуется время на изучение исходной информации.
Поэтому разделение задачи оправдано прежде всего при самостоятельной работе с большим выводом, специализированными инструкциями или ограничениями инструментов.
Для повторно используемых инструкций, которые должны выполняться непосредственно в основной беседе, Anthropic рекомендует рассмотреть Skills.
Источник: документация Claude Code.