Агенты Claude Code: как работают субагенты и расходуется лимит
Агенты Claude Code могут выполнять задачи самостоятельно или передавать часть работы другим помощникам, которых называют субагентами. Они исследуют проект, запускают проверки и возвращают результаты в основной диалог. Однако каждый такой помощник отправляет собственные запросы к модели, которые учитываются в общем лимите использования Claude Code.
В официальной документации Anthropic объясняет, как устроены субагенты, когда их стоит использовать и каким образом контролировать расход. Разница особенно заметна при длительной работе с большими проектами, где поиск по файлам или результаты тестирования занимают значительную часть контекста.
Субагент работает в отдельном контексте и возвращает результат
Субагент — это специализированный ИИ-помощник внутри текущей сессии Claude Code, которому поручают отдельную задачу.
У него собственное контекстное окно, то есть объём информации, который модель учитывает во время работы. Также субагент получает свои инструкции, доступные инструменты и разрешения на действия.
Например, основному агенту необходимо разобраться в устройстве проекта. Вместо того чтобы загружать в основной диалог многочисленные результаты поиска и содержимое файлов, Claude может поручить исследование субагенту.
Тот изучит проект в собственном контексте и вернёт только выводы.
Иными словами, черновая работа остаётся у отдельного помощника, а в основном диалоге сохраняется результат, необходимый для продолжения задачи.
Разбираю Claude Code и ИИ-агентов на практике: как применять их в реальных рабочих задачах, автоматизировать рутину, собирать собственных ИИ-ассистентов и зарабатывать с помощью новых технологий. Практические разборы, инструменты, кейсы и эксперименты: от первого ИИ-агента до полноценных рабочих систем. Подписывайтесь.
Субагенты помогают разграничивать задачи и управлять расходом
Anthropic выделяет несколько причин использовать субагентов.
• Сохранение контекста. Большие результаты поиска, логи и содержимое файлов остаются за пределами основной переписки.
• Ограничение инструментов. Отдельному помощнику можно разрешить только определённые действия.
• Повторное использование настроек. Пользовательские субагенты позволяют применять одинаковые инструкции в разных проектах.
• Специализация. Для проверки кода или исследования проекта можно задать отдельное поведение через системные инструкции.
• Управление расходом. Простые задачи можно поручать более быстрой и менее дорогой модели, например Haiku.
Субагенты особенно полезны, когда результат можно представить кратким отчётом. Изоляция контекста сама по себе не означает сокращения расхода подписки.
Explore и Plan выполняют поиск без изменения файлов
Claude Code включает несколько встроенных субагентов.
Explore предназначен для быстрого изучения проекта. Он ищет файлы, анализирует код и помогает разобраться в структуре программы. Ему доступны инструменты только для чтения. Изменять файлы через Write и Edit он не может.
Для Explore предусмотрены уровни исследования: quick, medium и very thorough. Claude выбирает глубину поиска в зависимости от задачи.
Plan используется при подготовке плана работы. Он собирает информацию о кодовой базе, прежде чем Claude предложит последовательность действий. Инструменты записи и редактирования ему также недоступны.
General-purpose выполняет сложные многоэтапные задачи. В отличие от Explore и Plan, он может исследовать проект и вносить изменения с помощью доступных ему инструментов.
Есть и другие встроенные помощники: claude для задач, которым не подходит более специализированный агент, statusline-setup для настройки строки состояния и claude-code-guide для вопросов о возможностях Claude Code.
Большинство таких помощников Claude вызывает автоматически.
Claude выбирает субагента по описанию задачи
Решение о передаче работы зависит от запроса пользователя, текущего контекста и описаний доступных субагентов.
Например, если задача требует изучить кодовую базу без изменений, Claude может использовать Explore. Для сложной работы с несколькими последовательными действиями подходит general-purpose.
Пользователь также может попросить вызвать конкретного помощника.
В запросе достаточно указать его название. Claude решит, следует ли передавать ему задачу.
Другой способ предусматривает упоминание через @. Такой вызов гарантирует запуск выбранного субагента для конкретной задачи.
Можно также запустить целую сессию с определённым агентом, используя параметр --agent. В этом случае на основную сессию распространяются ограничения инструментов и выбор модели данного агента.
Для повторяющихся задач Anthropic предлагает создавать собственных субагентов с заданными инструкциями.
Фоновые субагенты выполняют работу параллельно
Субагенты могут работать в двух режимах.
При работе на переднем плане основной диалог ожидает завершения порученной задачи.
Фоновый субагент выполняет её параллельно, пока пользователь продолжает работать с Claude.
По умолчанию субагенты, которых Claude запускает из основной беседы, начинают работу в фоне.
Если такому помощнику требуется разрешение на использование инструмента, запрос появляется в основной сессии. Claude Code указывает название субагента, который запрашивает доступ.
Пользователь может разрешить действие или нажать Esc, чтобы отклонить конкретный вызов инструмента. Сам субагент после такого отказа не останавливается автоматически.
У фоновых помощников меньше встроенных инструментов, чем у работающих на переднем плане. В документации предусмотрены отдельные исключения для некоторых типов сессий.
Результат фоновой работы поступает в основную беседу после завершения задачи.
Каждый субагент использует общий лимит подписки
Отдельное контекстное окно не означает отдельную квоту запросов.
Субагент самостоятельно обращается к модели. Все такие обращения учитываются в том же лимите, что и работа основного диалога.
Если одновременно запущено несколько помощников, каждый расходует доступный объём использования.
Поэтому лимиты Claude зависят не только от запросов в основной сессии, но и от действий запущенных субагентов.
Посмотреть распределение расхода можно через команду /usage.
В разделе Attribution отображается доля недавнего использования, связанная с субагентами, навыками Skills, плагинами и MCP-серверами. MCP-серверы подключают внешние инструменты и данные к Claude Code.
Доли показываются в процентах от общего использования. Их не следует принимать за процент экономии.
Anthropic рекомендует отдавать субагентам объёмные операции
В документации Manage costs effectively приведены способы контролировать расход.
Первый связан с выбором модели. Для простых задач субагенту можно назначить Haiku вместо более дорогой модели.
Другой вариант позволяет использовать одну выбранную модель для всех субагентов.
Отдельная рекомендация касается операций с большим объёмом вывода: запуска тестов, получения документации и обработки журналов.
Если такую работу выполняет субагент, длинные результаты остаются в его контекстном окне. Основной диалог получает только необходимые сведения.
Но сами запросы субагента продолжают расходовать общий лимит.
При выборе модели необходимо учитывать, что некоторые встроенные помощники, включая Explore и Plan, по умолчанию наследуют модель основной сессии и имеют специальные правила настройки.
Одновременно могут работать 20 субагентов
По умолчанию Claude Code допускает до 20 одновременно работающих субагентов в сессии.
Если этот предел достигнут, попытка запустить следующего через инструмент Agent завершается ошибкой Concurrent subagent limit reached.
После завершения одного из выполняющихся помощников запуск снова становится возможным.
Ограничение можно изменять через CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Для сессий с активным ultracode предусмотрено исключение.
Общее число субагентов, которые могут последовательно запускаться за всю сессию, не ограничено этим значением.
Небольшие изменения удобнее выполнять в основном диалоге
Anthropic рекомендует не создавать субагента для каждой операции.
Основная беседа подходит, когда задача требует постоянных уточнений, несколько этапов используют общий контекст или необходимо быстро внести небольшое изменение.
Отдельному помощнику требуется время на получение собственного контекста. Поэтому передача простой операции может оказаться лишним этапом.
Субагенты полезнее для самостоятельных задач с большим объёмом промежуточных данных или специальными ограничениями доступа.
Если же требуется повторно использовать инструкции внутри основного диалога, документация предлагает рассмотреть Skills вместо изолированного субагента.
Источник: документация Claude Code.