Subagents no Claude Code: como delegar reviews e testes para agentes separados
Claude Code rapidamente atinge limites de contexto — quanto mais longa a sessão, pior o desempenho do agente. Subagents resolvem isso: reviews, testes…
Processado por IA de Habr AI; editado por Hamidun News
Subagents в Claude Code позволяют делегировать ресурсоёмкие задачи — ревью, тесты, аудит, исследование кода — отдельным агентам с независимым контекстом, инструментами и правилами, обходя главное ограничение инструмента: исчерпание контекстного окна.
Почему контекст — главный враг
Claude Code Большинство разработчиков, начавших работать с Claude Code, замечают одну закономерность: инструмент работает блестяще в начале сессии и заметно хуже — к её середине и концу. Причина не в возможностях модели — Anthropic регулярно улучшает Claude. Причина в архитектуре работы с контекстом.
Каждое взаимодействие в рамках сессии накапливается в контекстном окне: прочитанные файлы, написанные планы, история правок, вывод инструментов, результаты команд. Чем длиннее сессия, тем больше «мусора» в контексте. Модель начинает терять нить рассуждения, плодить противоречия с ранними инструкциями, иногда возвращаться к уже отклонённым решениям.
Стандартный выход — дробить работу на короткие сессии. Но это неудобно: каждый раз приходится восстанавливать контекст вручную, копировать промежуточные результаты и заново объяснять агенту, что уже было сделано. Subagents предлагают системный ответ на эту проблему.
Что такое subagents и как они устроены
Subagents — это отдельные экземпляры агента, которые основная сессия Claude Code запускает для конкретных подзадач. Ключевое отличие от ручного «начни новый чат»: делегирование происходит программно, а результат возвращается в основную сессию в структурированном виде. Каждый subagent работает в изолированной среде: Собственное контекстное окно — независимое от родительской сессии, начинается чистым Набор инструментов под задачу — только чтение файлов для аудита, или выполнение тестов для QA * Отдельные правила и инструкции — роль конфигурируется через системный промпт или файл CLAUDE.
md * Изолированный рабочий каталог — при необходимости subagent работает в отдельном git-worktree Схема взаимодействия проста: основной агент ставит задачу, передаёт нужные файлы и контекст, запускает subagent. Тот работает в изолированной сессии и возвращает только итог — отчёт о ревью, список проблем, готовые тесты — без промежуточных рассуждений. Параллельность — дополнительный бонус.
Несколько subagents можно запускать одновременно: пока один делает ревью, другой пишет тесты для того же модуля. Основная сессия координирует работу, не выполняя её сама.
Какие задачи лучше всего делегировать
Не любую задачу имеет смысл выносить в subagent — у делегирования есть накладные расходы на инициализацию и передачу контекста. Но для ряда сценариев выигрыш очевиден. Code review — анализ PR или конкретного файла требует глубокого погружения, но результат компактен: список замечаний с приоритетами.
Subagent читает код, выдаёт отчёт и не загрязняет основной контекст тысячами строк. Написание тестов — subagent получает описание функции или исходный файл, пишет тесты, запускает их и сообщает результат. Основная сессия при этом продолжает работу над другими частями проекта.
Security-аудит — проверка уязвимостей с чеклистом OWASP и изолированными правилами безопасности возвращает короткий список находок с приоритетами, не засоряя основной контекст. Исследование кодовой базы — поиск всех вхождений паттерна или изучение незнакомой части проекта: subagent возвращает структурированную карту зависимостей, не занимая место в основном окне.
Что это значит
Subagents меняют подход к работе с AI-ассистентом в разработке: вместо одной большой сессии, которая деградирует с ростом контекста, разработчик получает оркестрацию специализированных агентов — каждый работает с чистым контекстным окном в своей зоне ответственности. Один ревьюит, другой тестирует, третий ищет уязвимости. Это ближе к управлению небольшой командой, чем к разговору с единственным помощником, — и именно такой подход позволяет Claude Code стабильно справляться с крупными, многодневными задачами без потери качества.
Quer parar de ler sobre IA e começar a usar?
AI News é um feed curado de notícias de IA. A Hamidun Academy ensina você a usar IA no trabalho.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.