Сабагенты
Сабагенты (subagents) в Claude Code — отдельные агенты под подзадачи со своим контекстом. Зачем делегировать и как они экономят контекст-окно.
Сабагент — это отдельный агент, которому основной агент делегирует подзадачу. У него свой контекст-окно: он делает работу у себя, а наверх возвращает только результат, а не весь мусор по пути.
Определяется Markdown-файлом в .claude/agents/ (проектный) или ~/.claude/agents/ (личный), с фронтматтером: description, какие tools разрешены, какая model.
Зачем делегировать
Две причины:
- Экономия контекста. Поиск по всему репо «где тут логика авторизации» захламляет окно десятками файлов. Сабагент перелопатит их у себя и вернёт один абзац-вывод. Основная сессия остаётся чистой — см. Контекст и откат.
- Параллелизм и специализация. Можно запустить несколько сабагентов разом — каждый копает свой кусок. Так устроен skill
/generate-test: четыре агента параллельно собирают контекст из Confluence, фронта, бэка и TMS.
Делегируй, когда задача широкая, но вывод узкий: перелопатить много, вернуть мало. Если результат сам по себе огромный — выигрыша в контексте не будет.
Как создать и вызвать
Сабагент — это .md-файл в .claude/agents/ (проектный) или ~/.claude/agents/ (личный). Создать можно командой /agents (интерактивный мастер) или руками. Обязательны name и description; model и tools — опциональны:
---
name: context-confluence
description: Ищет описание фичи в Confluence. Use when нужно собрать требования по фиче.
model: haiku
tools: mcp__mcp-atlassian
---
Найди в Confluence страницу с описанием фичи, верни обязательные
поля, бизнес-правила и статусы. Лишнего не тащи — только выжимку.description— по нему основной агент решает, когда делегировать сабагенту. Пиши конкретно, с фразами-триггерами.model— для простой работы (поиск, сбор контекста) ставь дешёвую, напримерhaiku; основной агент остаётся на мощной.tools— сужает доступ до нужного (mcp__<server>берёт весь MCP-сервер). Опустишь — сабагент наследует все инструменты.- Тело файла — системный промпт сабагента.
Вызвать можно тремя путями: основной агент сам подхватит сабагента по description; ты попросишь явно («собери контекст через context-confluence»); или из skill — там в инструкциях называешь сабагентов по имени, и оркестратор зовёт их через инструмент Task.
Сабагент vs skill
Их легко спутать, но это про разное:
- Skill — что делать (воркфлоу, рецепт).
- Сабагент — кто делает (исполнитель с отдельным контекстом).
Skill может внутри себя запускать сабагентов. Сабагент может пользоваться skills. Это ортогональные вещи.
Список и запуск — команда /agents. Полный набор полей фронтматтера и правила — в документации по сабагентам.
Проверь себя
1. Главная причина делегировать подзадачу сабагенту?
2. Когда делегирование НЕ даёт выигрыша в контексте?
3. Чем сабагент отличается от skill?
Skills
Skills в Claude Code — повторяемые воркфлоу одной командой. Что это, чем отличается от своей слэш-команды и где готовый туториал по созданию.
MCP-серверы
MCP-серверы в Claude Code — как подключить внешние инструменты: Jira, Confluence, браузер, TMS. Что такое Model Context Protocol простыми словами.