Это четвёртый пост серии про Claude Code. Позади установка, рабочий цикл и хуки. Сегодня — про субагентов.
Во второй части мы говорили про «гниение контекста»: чем больше всего накопилось в рабочей памяти, тем хуже работает инструмент. Субагенты — один из главных способов с этим бороться. Разберёмся.
Что такое субагент
Субагент — это отдельный помощник внутри Claude Code, заточенный под конкретный тип задач. У него своя, отдельная рабочая память, свои инструкции, свой набор разрешённых инструментов.
Работает это так. Основной Claude Code (назовём его руководителем) встречает задачу, которую можно поручить специалисту. Он передаёт её субагенту. Субагент выполняет работу в своей отдельной памяти и возвращает руководителю только итог — короткую выжимку.
Ключевое здесь — «в своей отдельной памяти». Вся возня субагента (прочитанные файлы, длинные логи, поиск по проекту) остаётся у него и не засоряет память основной сессии. Руководитель получает чистый результат, а не гору промежуточного мусора.
Зачем они нужны: экономия контекста
Вернёмся к проблеме из второй части. Некоторые задачи очень «шумные»: исследовать структуру большого проекта, перерыть длинный лог в поисках ошибки, проверить десяток файлов. Если делать это в основной сессии, вся эта гора текста оседает в контексте. Память забивается, качество падает.
Субагент впитывает этот шум в себя. Поисковая работа идёт в его отдельной памяти, а в основную сессию возвращается только вывод: «нашёл, проблема в таком-то файле, вот суть». Основная сессия остаётся чистой и сосредоточенной.
Если совсем коротко: субагенты нужны, чтобы шумная побочная работа не пожирала рабочую память основной задачи.
Встроенные субагенты
Хорошая новость: базовыми субагентами вы, скорее всего, уже пользуетесь, сами того не замечая. В Claude Code есть несколько встроенных помощников, в том числе для исследования проекта и для планирования. Когда вы включаете режим планирования из прошлого поста, за кулисами работает как раз такой механизм.
То есть субагенты — это не что-то, что надо обязательно настраивать. Часть из них работает за вас сразу.
Свой субагент: команда /agents
Когда есть смысл сделать своего субагента? Когда вы замечаете, что раз за разом поручаете один и тот же тип работы с одними и теми же инструкциями. Например, у вас постоянно появляется задача «проверь этот код на ошибки по таким-то правилам». Логично оформить это отдельным специалистом.
Самый простой способ — команда /agents прямо в окне Claude Code. Откроется интерфейс управления субагентами. Можно создать нового, описав своими словами, чем он должен заниматься, а Claude Code сам оформит его, опираясь на контекст вашего проекта.
Технически субагент — это текстовый файл в формате Markdown с небольшим блоком настроек в начале. В этом блоке указывают имя субагента, описание (для чего он), список доступных ему инструментов и модель. Файлы субагентов лежат в папке .claude/agents/ внутри проекта (тогда субагент привязан к этому проекту) или в ~/.claude/agents/ (тогда он доступен во всех ваших проектах). Но всё это удобнее делать через /agents, чем руками.
Один важный нюанс: описание субагента — это не формальность. Именно по описанию Claude Code решает, когда передать задачу этому субагенту. Описание расплывчатое — субагент не подхватится, когда нужно. Описание чёткое — всё работает само.
И ещё: новые субагенты подхватываются при старте сессии. Если создали субагента файлом во время работы, перезапустите Claude Code, чтобы он его увидел.
Когда субагент не нужен
Субагенты — не бесплатное волшебство. У передачи задачи туда-сюда есть своя цена: это занимает время и расходует ресурсы. Для мелкой задачи проще сделать всё в основной сессии, чем городить помощника.
И ещё одно ограничение: субагент не может создавать собственных субагентов. Цепочку «помощник нанимает помощника» построить не получится, и это нормально.
Правило простое: субагенты — для шумной, объёмной или повторяющейся побочной работы. Для всего остального — обычная работа в основной сессии.
Что дальше
Соберём картину серии воедино. Вы умеете устанавливать и запускать Claude Code, вести рабочий цикл с управлением контекстом, автоматизировать рутину хуками и поручать побочные задачи субагентам. Этого набора хватает, чтобы собрать полноценный продукт.
Остался последний шаг — выложить готовый продукт в интернет, чтобы им могли пользоваться другие люди. Этим займёмся в финальном посте серии.
Следующий пост серии: «Claude Code на русском. Часть 5: деплой продукта».
