День 21: Что такое субагент

Почему это важно именно вам

Представьте такую сцену: вы просите одного человека одновременно проанализировать договор с подрядчиком, подготовить сводку по звонкам колл-центра за месяц и написать письмо партнёру по итогам встречи. Технически — один человек, три задачи. На практике — качество пострадает, потому что каждая задача требует разного фокуса, разного стиля мышления и разных источников информации. Опытный директор не поступает так: он распределяет задачи между людьми, каждый из которых заточен под своё.

С Claude происходит ровно то же самое, когда вы в одном запросе смешиваете аналитику, редактуру и коммуникацию. Модель справляется — но это другой уровень, чем когда одна задача выполняется с полным фокусом, правильными инструментами и чётко ограниченным контекстом. Субагенты — это ответ на эту проблему. Вместо одного универсального Claude, который делает всё подряд, вы выстраиваете команду специализированных агентов, каждый из которых знает своё дело.

Фаза 3 курса, которую вы начинаете сегодня, целиком посвящена этой теме. За десять дней вы пройдёте от концепции до работающей системы: создадите собственных агентов, настроите их параметры, свяжете их между собой через оркестратор. Сегодня — фундамент. Без понимания того, что такое субагент и как он устроен, дальнейшее просто не сложится.

Что это такое

Субагент — это отдельный экземпляр Claude с собственной ролью, собственным набором инструментов и собственным контекстом. Он получает задачу, выполняет её и возвращает результат. Всё. Он не знает, что происходит за пределами его задачи. Он не участвует в общем разговоре. Он — специалист, нанятый под конкретное дело.

Лучшая аналогия из управленческой практики — не «попросить кого-то», а «нанять специалиста». Когда вам нужна юридическая экспертиза договора, вы не просите офис-менеджера «взглянуть на него между делом». Вы зовёте юриста. Когда нужна аналитика по продажам — аналитика, не маркетолога. Субагент в Claude работает по той же логике: каждый заточен под свою область, работает с нужными данными и возвращает результат в нужном формате.

Технически субагент — это Claude, которому передаётся системный промпт (роль и правила), набор разрешённых инструментов (что он может делать) и конкретная задача. Он выполняет задачу и возвращает результат вызвавшему его агенту или напрямую вам. После этого субагент отдаёт результат и закрывается — его контекст в вашу сессию не переносится. Если субагенту дали имя, к нему можно вернуться: дослать вопрос или возобновить работу.

Важно: субагенты не работают в обычном чате Claude.ai — это механизм Claude Code. Но сам Claude Code живёт не только в терминале: те же файлы агентов работают в расширении для VS Code, в приложении и в браузерной версии claude.ai/code. Сам Claude Code — тот самый терминальный инструмент, с которым вы работаете с первого дня курса, — просто живёт теперь на нескольких поверхностях. Если вы дошли до двадцать первого урока, значит, вы уже в нужном месте.

Как работает на практике

Разберём, как именно Claude создаёт и использует субагентов — пошагово, с конкретными примерами.

Шаг 1. Встроенные режимы: три типа, которые вы уже использовали

Claude Code несёт несколько встроенных субагентов; три основных — Explore, Plan и General-purpose. Важная деталь: Explore и Plan намеренно не читают ваш CLAUDE.md, чтобы разведка была быстрее и дешевле, а все остальные — читают:

Explore — режим только на чтение. Claude просматривает файлы, анализирует структуру, отвечает на вопросы — но ничего не меняет. Полезен, когда вам нужно разобраться в ситуации без риска что-то сломать. Например: «посмотри на всю переписку с этим подрядчиком и скажи, какие ключевые договорённости были достигнуты».

Plan — разведчик для режима планирования. Пока вы в plan-режиме, Claude отправляет ему сбор контекста, чтобы результаты разведки остались в отдельном окне, а основная сессия оставалась только читающей. План по итогам собирает и показывает вам основной Claude. Полезен для сложных многошаговых задач, где ошибка в начале тянет за собой цепочку последствий.

General-purpose — стандартный режим. Читает, думает, пишет, выполняет команды, редактирует файлы. То, что вы использовали всё это время.

Шаг 2. Когда Claude создаёт субагентов сам

В Claude Code есть механизм автоматического делегирования. Когда задача сложная или многосоставная, Claude может самостоятельно решить разбить её на части и запустить несколько субагентов параллельно.

Представьте такой запрос:

Подготовь аналитический пакет по прошлому кварталу:
- сводка по звонкам колл-центра
- анализ трафика на портале
- список задач, которые не были закрыты вовремя

При достаточных правах и настройках Claude может запустить три параллельных субагента: один работает с данными КЦ, второй — с данными по трафику, третий — с реестром задач. Каждый сосредоточен на своём. Потом результаты объединяются. Это быстрее и точнее, чем если бы один Claude делал всё последовательно в одном контексте.

Ключевое слово — «при достаточных правах». Это контролируется настройками, которые вы разбирали в фазе 1. Автоматическое создание субагентов — мощный инструмент, но он требует понимания.

Шаг 3. Папка .claude/agents/ — где живут субагенты

Когда вы создаёте собственного субагента вручную (что мы будем делать начиная со следующего урока), он описывается в файле внутри папки .claude/agents/. Структура простая:

ваша-рабочая-папка/
└── .claude/
    └── agents/
        ├── analyst.md       ← агент-аналитик
        ├── editor.md        ← агент-редактор
        └── researcher.md    ← агент-исследователь

Каждый файл — это описание одного субагента: его роль, правила, разрешённые инструменты и другие параметры. Claude читает эти файлы и знает, каких специалистов он может «нанять» для задач.

Шаг 4. Как Claude решает, кому делегировать

Когда вы задаёте задачу, Claude смотрит на описания доступных субагентов (поле description в каждом файле) и решает: есть ли здесь кто-то, кто справится с этим лучше, чем если делать самому?

Пример описания агента-аналитика (упрощённо):

description: Анализирует числовые данные, CSV-файлы и таблицы.
Готовит структурированные отчёты с выводами и рекомендациями.
Вызывать при задачах с данными, цифрами, сравнением показателей.

Если ваш запрос содержит «проанализируй данные по звонкам», Claude автоматически делегирует задачу этому агенту. Ключевое — качество описания. Именно оно определяет, правильно ли будет выбран субагент. Подробнее об этом — в День 22.

Шаг 5. Изолированный контекст — почему это важно

Каждый субагент работает в изолированном контексте. Это означает несколько важных вещей.

Во-первых, субагент видит только то, что ему передали — задачу и описание роли. Он не видит вашу переписку, не знает о других задачах, которые выполняются параллельно. Это хорошо: он сосредоточен и не отвлекается на лишнее.

Во-вторых, ошибка одного субагента не ломает всю систему. Если агент-аналитик сделал неточный вывод, это не влияет на работу агента-редактора, который в это время правит ваше письмо партнёру.

В-третьих, после завершения задачи контекст субагента исчезает. Он не «помнит» прошлые разговоры с вами (если только вы специально не настроите память — об этом в День 27).

Частые ошибки

Ошибка 1: Думать, что субагент — это просто другое имя для запроса

Это принципиально разные вещи. Запрос — это вы разговариваете с Claude, он отвечает в рамках одного контекста. Субагент — это изолированный процесс с отдельным промптом, отдельными инструментами и отдельным контекстом. Он не видит ваш разговор. Он получает задачу, выполняет её, возвращает результат. Путаница здесь приводит к тому, что люди пытаются «подсказать» субагенту что-то, сказанное раньше в чате — и удивляются, почему он этого не учёл.

Ошибка 2: Создавать субагента для каждой мелкой задачи

Субагент оправдан, когда задача повторяется, имеет специфические требования к формату или требует изолированного контекста. Если вы раз в год пишете письмо поздравительного характера — не нужно создавать под это агента. Субагент — это инвестиция: вы тратите время на его настройку, чтобы потом сэкономить на регулярных задачах. Разовые задачи дешевле делать напрямую.

Ошибка 3: Не задавать явные правила формата вывода

Субагент работает изолированно. Если вы не сказали ему, в каком формате должен быть результат, он выберет сам — и не обязательно так, как вам нужно. Агент-аналитик может вернуть текстовый разбор, когда вам нужна таблица. Агент-редактор может прокомментировать текст, когда вам нужна исправленная версия. Всегда явно указывайте: что именно должен вернуть субагент, в каком формате и с какой степенью детализации.

Ошибка 4: Игнорировать разрешения

Субагент может иметь право читать файлы, выполнять команды в терминале, обращаться к интернету — или ничего из этого. Если вы создаёте агента-аналитика, которому нужно читать CSV-файлы, но не даёте ему права на чтение файлов — он не сработает. И наоборот: если вы даёте агенту, который только пишет письма, право выполнять команды в терминале — это избыточно и создаёт риск. Принцип минимальных прав работает и здесь. Подробнее — в День 24.

Когда нужно / когда нет

Субагенты оправданы, если:

Задача повторяется регулярно. Раз в неделю вы готовите сводку по данным — это идеальный кандидат. Агент-аналитик настраивается один раз и работает по одному и тому же шаблону.

Задача требует специфического стиля или формата, который сложно каждый раз объяснять заново. Агент-редактор, который знает ваши требования к деловым письмам, справится точнее и быстрее, чем общий Claude с объяснением «правил» в каждом запросе.

Несколько задач можно выполнять параллельно. Пока один агент анализирует данные по трафику, другой готовит сводку по звонкам. Экономия времени — реальная.

Нужна изоляция контекста. Агент для работы с персональными данными клиентов не должен «видеть» внутренние финансовые документы. Изоляция — это не только про безопасность, но и про чистоту работы.

Субагенты не нужны, если:

Задача разовая и нетипичная. Объяснить контекст прямо в запросе быстрее, чем создавать агента.

Вы только начинаете работать с определённым типом задач и ещё не понимаете, какими должны быть правила. Сначала поработайте напрямую, накопите понимание — потом оформляйте в агента.

Задача требует постоянного обмена информацией в рамках одного разговора. Субагент изолирован. Если вам нужно несколько итераций «посмотри на это, теперь посмотри на то в свете этого» — лучше работать напрямую.

Отдельный случай — сложные многошаговые проекты. Если вам нужно подготовить квартальный отчёт для руководства, включающий аналитику, письмо с выводами и презентационный план — это может быть одна задача для оркестратора, который запускает трёх специализированных субагентов. Оркестратор — тема Дня 28.

Связь с другими уроками

День 12 разбирал четыре уровня CLAUDE.md — проектный, папочный, глобальный и локальный. Файлы субагентов бывают двух уровней: проектные в .claude/agents/ и личные в ~/.claude/agents/, которые работают во всех папках, — та же логика, что у CLAUDE.md. Контекст для главного Claude и описания субагентов — части одной иерархической системы конфигурации.

День 8 касался разрешений — что Claude может и не может делать без вашего подтверждения. Для субагентов режим разрешений задаётся полем permissionMode во frontmatter. Но по умолчанию субагент наследует режим родительской сессии, а если родитель работает в авторежиме, acceptEdits или bypassPermissions — наследование перебивает frontmatter. Единственное ограничение, которое не переопределяет никто, — список tools. Это важно: каждый агент получает ровно те права, которые ему нужны.

День 28 — оркестратор. Когда у вас будет несколько субагентов, появится задача их координировать. Оркестратор — это агент, у которого есть право вызывать других агентов (инструмент Agent; старое имя Task работает как псевдоним). Сегодня вы понимаете, что такое субагент; к Дню 28 вы построите систему, где агенты работают вместе.

Задание на сегодня

Откройте терминал и запустите claude в вашей рабочей директории. Напишите следующий запрос:

Какие субагенты у тебя доступны прямо сейчас?
Есть ли папка .claude/agents/ в этой директории?

Посмотрите на ответ. Если папки нет — это нормально, вы её создадите начиная со следующего урока. Если есть какие-то агенты — посмотрите их описания. Главное сейчас: убедиться, что вы понимаете разницу между «разговором с Claude» и «Claude, который запускает субагента для задачи».

Критерий выполнения: вы задали вопрос и получили ответ. Не важно, что именно ответил Claude — важно, что вы начали работать в логике «что у меня есть в системе», а не «что я могу спросить».

Резюме

• Субагент — изолированный экземпляр Claude с отдельной ролью, инструментами и контекстом; работает как специалист под конкретную задачу, а не универсал
• Claude имеет три встроенных режима: Explore (только читать), Plan (планировать), General-purpose (всё); они показывают принцип конфигурации, который вы применяете к собственным субагентам
• Субагенты живут в файлах папки .claude/agents/; поле description определяет, когда Claude автоматически делегирует задачу конкретному агенту
• Изолированный контекст — и преимущество (фокус, независимость, безопасность), и ограничение (передавать нужный контекст явно в каждой задаче)
• Субагенты оправданы для регулярных задач с чёткими правилами; разовые нетипичные задачи быстрее решать напрямую