Подагенты в Claude Code AI запускают сотни изолированных агентов, сохраняя контекст чистым

Механизм подагентов (subagents) решает проблему, знакомую каждому, кто работал с Claude Code AI в длинных сессиях: через час контекстное окно (объём текста, который модель держит «в голове» одновременно) забито на 70%, ответы замедляются, качество падает. Anthropic сначала выпустила базовый механизм делегирования, а в мае 2026 года докрутила его до Dynamic Workflows с параллельным запуском сотен агентов и автоматической оценкой результата через Performance Outcomes. Информация основана на публикации с Хабра.

Что умеет подагент и как он устроен?

• Изолированный контекст. Подагент получает собственное контекстное окно, собственный системный промпт (главная инструкция для модели), собственный список разрешённых инструментов и при необходимости отдельную модель (Sonnet, Opus, Haiku). Родительский агент видит только финальное резюме.
• Файл вместо кода. Подагент создаётся как обычный Markdown-файл с YAML-заголовком. Файл кладётся в папку .claude/agents/<имя>.md для проекта или ~/.claude/agents/<имя>.md для глобального доступа. Никакого SDK, компиляции или регистрации: положили файл, перезапустили сессию, агент доступен.
• Автоматический роутинг по описанию. Claude Code читает поле description каждого зарегистрированного подагента и сам решает, кому делегировать задачу. Логика та же, что при выборе инструмента: модель сопоставляет намерение пользователя с описаниями доступных подагентов.
• Три встроенных подагента из коробки. Explore (быстрый поиск по коду, только чтение, модель Haiku), Plan (сбор контекста перед планированием) и general-purpose (сложные многошаговые задачи, для которых нет специализированного агента).
• Три паттерна запуска. Последовательный (каждый следующий агент получает результат предыдущего), параллельный (несколько агентов одновременно на независимых задачах) и веерный (fan-out, массовый параллельный запуск сотен агентов).

Как правильно писать description для модели, а не для человека?

Это самый практичный момент для тех, кто будет настраивать Claude Code AI под свои задачи. Поле description определяет, получит ли подагент задачу автоматически. Описание пишется не для коллеги, а для модели.

Конкретный пример из источника: фраза «Use immediately after writing or modifying code» работает для роутинга лучше, чем «Reviews code quality». Фраза «Use when the user asks about database performance issues» лучше, чем «Database expert». Активная форма с триггером на действие, а не абстрактная роль.

Если автоматическое делегирование не сработало, подагент вызывается вручную: директива @code-reviewer в чате или флаг claude --agent code-reviewer в терминале. Это же способ тестировать подагент изолированно.

Зачем ограничивать инструменты и как это делается?

Каждый подагент может унаследовать все инструменты родительской сессии, но в рабочих проектах это опасно. Источник описывает случай, когда подагент-рефакторщик с полным доступом к терминалу выполнил git reset и стёр 40 минут несохранённой работы.

Поле tools задаёт список разрешённых инструментов (allowlist). Поле disallowedTools задаёт список запрещённых (denylist). Если указаны оба, сначала применяется запрет, затем разрешение проверяется по оставшемуся.

Примеры комбинаций из источника:

• Аудитор (только чтение): Read, Grep, Glob
• Баг-фиксер: Read, Edit, Bash, Grep, Glob
• Генератор документации: Read, Write, WebFetch, WebSearch

Дополнительная защита настраивается в файле .claude/settings.json, где задаются паттерны разрешённых и запрещённых команд терминала на уровне всей сессии.

Как попробовать?

1. Создайте файл подагента в формате Markdown с YAML-заголовком (поля name, description, tools, опционально model) и телом-промптом. Пример структуры приведён в документации Anthropic.
2. Положите файл в .claude/agents/ внутри проекта или в ~/.claude/agents/ для глобального доступа.
3. Перезапустите сессию Claude Code. Агент обнаружится автоматически.
4. Проверьте работу изолированно: вызовите агент вручную через @имя-агента в чате или claude --agent имя-агента в терминале, прежде чем полагаться на автоматический роутинг.

Есть ли аналог в России?

В российских инструментах для работы с кодом через ИИ (YandexGPT, GigaChat) на момент публикации источника механизма подагентов с изолированным контекстом, автоматическим роутингом и YAML-конфигурацией нет. Это не означает, что аналоги хуже по всем параметрам: у них свои сильные стороны в задачах на русском языке. Но конкретно функция делегирования задач от одного ИИ-агента (программа, которая сама выбирает, что делать дальше) другому с раздельными контекстами пока доступна только в Claude Code AI.

Частые вопросы

Подагент видит всю историю родительской сессии?

Нет. Подагент запускается с чистым контекстным окном и получает только ту задачу, которую делегировал родительский агент. Обратно возвращается только итоговое резюме. Промежуточные шаги рассуждений в контекст родителя не попадают.

Можно ли запускать подагент на другой модели?

Да. В YAML-заголовке файла подагента есть поле model, где указывается конкретная модель: Sonnet, Opus или Haiku. Например, встроенный подагент Explore использует Haiku для быстрого поиска по коду, потому что задача не требует тяжёлой модели.

Что будет, если description написан невнятно?

Родительский агент может не делегировать задачу подагенту, потому что не распознает совпадение. Описание нужно писать в активной форме с явным триггером: не «Database expert», а «Use when the user asks about database performance issues». Если автоматика не срабатывает, всегда остаётся ручной вызов через @имя-агента.