Багодельня
Справочник Claude Code

Сабагенты

Сабагенты (subagents) в Claude Code — отдельные агенты под подзадачи со своим контекстом. Зачем делегировать и как они экономят контекст-окно.

Сабагент — это отдельный агент, которому основной агент делегирует подзадачу. У него свой контекст-окно: он делает работу у себя, а наверх возвращает только результат, а не весь мусор по пути.

Определяется Markdown-файлом в .claude/agents/ (проектный) или ~/.claude/agents/ (личный), с фронтматтером: description, какие tools разрешены, какая model.

Зачем делегировать

Две причины:

  1. Экономия контекста. Поиск по всему репо «где тут логика авторизации» захламляет окно десятками файлов. Сабагент перелопатит их у себя и вернёт один абзац-вывод. Основная сессия остаётся чистой — см. Контекст и откат.
  2. Параллелизм и специализация. Можно запустить несколько сабагентов разом — каждый копает свой кусок. Так устроен skill /generate-test: четыре агента параллельно собирают контекст из Confluence, фронта, бэка и TMS.

Делегируй, когда задача широкая, но вывод узкий: перелопатить много, вернуть мало. Если результат сам по себе огромный — выигрыша в контексте не будет.

Как создать и вызвать

Сабагент — это .md-файл в .claude/agents/ (проектный) или ~/.claude/agents/ (личный). Создать можно командой /agents (интерактивный мастер) или руками. Обязательны name и description; model и tools — опциональны:

.claude/agents/context-confluence.md
---
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. 1. Главная причина делегировать подзадачу сабагенту?

  2. 2. Когда делегирование НЕ даёт выигрыша в контексте?

  3. 3. Чем сабагент отличается от skill?

On this page