Subagents in Claude Code: how to delegate reviews and tests to separate agents

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 стабильно справляться с крупными, многодневными задачами без потери качества.