Субагенты превращают Claude Code из одного помощника в маленькую команду: каждому помощнику — своя роль, свой контекст и свои инструменты. Разберём, что это, как создать через /agents и кому поручать задачи.
Когда задача большая, один чат с Claude быстро превращается в кашу: в контексте намешаны и правки кода, и логи тестов, и куски документации, и предыдущие ошибки. Модель начинает путаться, а ты — тратить токены на лишнее. Субагенты решают это просто: тяжёлую или узкую подзадачу ты отдаёшь отдельному помощнику, который работает в своём пространстве и возвращает только результат.
Что узнаешь из гайда
/agents — по шагамЧасть 1 · Понятие
Главное
Субагент — это отдельный помощник внутри Claude Code со своей ролью, своим набором инструментов и собственным контекстом. Главный агент поручает ему узкую задачу, тот делает её отдельно и возвращает итог.
Представь, что Claude Code — это ты как руководитель. Ты можешь делать всё сам в одном чате, а можешь нанять узких специалистов и раздавать им поручения. Субагент — и есть такой специалист. Например, агент-ревьюер проверяет код, агент-отладчик ищет причину ошибки, агент-исследователь читает большой участок проекта и пересказывает суть.
У каждого субагента три важных свойства: описание (кто он и когда его звать), набор инструментов (что ему разрешено: только читать или ещё и править) и свой контекст (отдельное окно памяти, не пересекающееся с основным диалогом). Именно отдельный контекст и делает субагентов мощными.
Часть 2 · Смысл
Контекст — это рабочая память модели, всё, что она «держит в голове» в текущем диалоге. Память не бесконечная: чем больше туда напихано, тем дороже каждый запрос и тем выше шанс, что модель что-то упустит или перепутает. Тяжёлая подзадача (прочитать двадцать файлов ради одного бага) забивает основной контекст мусором, который потом мешает.
Субагент уходит, копается в деталях у себя и возвращает только выжимку. Главный диалог остаётся чистым.
В этом вся ценность. Агент-исследователь может прочитать сотни строк, но в основной чат вернёт три предложения сути. Агент-ревьюер прогонит весь diff, но отдаст только список замечаний. Главный агент не тонет в подробностях и держит фокус на твоей реальной задаче. Это прямое применение идей из контекст-инжиниринга — управления тем, что лежит в памяти модели.
Бонус — безопасность. Субагенту можно выдать только нужные инструменты. Например, агенту-исследователю — только чтение и поиск, без права править файлы или запускать команды. Так помощник физически не сломает проект, даже если ошибётся.
Часть 3 · Создание
Главное
Самый простой путь — команда /agents прямо в чате: она открывает интерфейс, где субагента можно создать и настроить по шагам, не правя файлы руками.
Запускаешь в Claude Code:
# Открыть интерфейс субагентов: создать, посмотреть, отредактировать
/agentsИнтерфейс проведёт через создание: имя, описание, выбор инструментов и модель. Можно даже попросить Claude сгенерировать первого субагента под твою задачу, а потом подправить. Под капотом всё это сохраняется как обычный markdown-файл — и его легко открыть и поправить вручную.
Где лежат файлы
Личные субагенты (доступны во всех проектах) — в ~/.claude/agents/. Проектные (едут в гит вместе с кодом, вся команда получает) — в .claude/agents/ внутри репозитория. Логика та же, что у скилов и CLAUDE.md: личное в домашней папке, командное — в проекте.
Часть 4 · Внутри
Субагент — это markdown-файл из двух частей: YAML-заголовок между --- с настройками и тело с системным промтом (инструкцией, как этому помощнику работать). Вот рабочий пример ревьюера кода:
---
name: code-reviewer
description: Reviews code for correctness, security, and maintainability
tools: Read, Grep, Glob
---
You are a senior code reviewer. Review for:
1. Correctness: logic errors, edge cases, null handling
2. Security: injection, auth bypass, data exposure
3. Maintainability: naming, complexity, duplicationРазберём поля заголовка:
| Поле | Что задаёт |
|---|---|
| name | Имя субагента — по нему его зовут в промте |
| description | Когда применять — по этому тексту Claude решает делегировать |
| tools | Разрешённые инструменты (если не указать — наследует все) |
| model | Модель под задачу (необязательно): попроще на рутину |
Поле tools здесь работает как белый список: в примере ревьюеру разрешены только Read, Grep и Glob — он может читать и искать, но не править файлы. Описание в заголовке пиши на английском: модель точнее матчит триггеры. Сами инструкции в теле можно держать как удобно.
Часть 5 · Делегирование
Главное
Зови субагента словами в обычном промте — по имени. Claude сам решит делегировать задачу нужному помощнику по его описанию.
Никакой особой команды запуска не нужно. Достаточно упомянуть субагента в задаче:
# Прямо называешь субагента в промте:
Используй субагента code-reviewer для свежих правок
# Или мягче — Claude сам подберёт по описанию:
Проверь мой последний коммит на безопасность и багиВ первом случае ты указываешь помощника явно. Во втором — Claude видит, что задача про ревью, и сам зовёт подходящего субагента по его description. Поэтому описание так важно: чем оно точнее, тем чаще делегирование срабатывает там, где надо.
Коротко
/agents или markdown-файлом в .claude/agents/.name, description, tools, опционально model.Часть 6 · Граница
Субагенты — мощный инструмент, но не для каждой мелочи. Заводить помощника стоит, когда роль повторяется или подзадача тяжёлая. Хорошие кандидаты:
Пример набора
Рабочий минимум для вайбкодера — два-три субагента: ревьюер кода, отладчик и исследователь. Этого хватает, чтобы крупные задачи не забивали основной диалог, а ты держал фокус на результате. Большая мультиагентная система из этого и собирается — про неё подробнее в гайде про ИИ-команду в терминале.
Когда субагент не нужен
Если задача разовая и простая — решай её в основном чате, субагент только добавит лишний шаг. Не плоди помощников «на всякий случай»: чем их больше, тем хуже Claude выбирает нужного, и тем больше путаницы. Заводи субагента, только когда роль реально повторяется или подзадача тяжёлая.
Коротко
/agents, зовёшь словами в промте.Вопросы
Субагент — это отдельный ИИ-помощник внутри Claude Code со своим описанием, своим набором инструментов и собственным окном контекста. Главный агент делегирует ему узкую задачу (например, ревью кода или поиск бага), субагент делает её в своём контексте и возвращает результат. Это способ разгрузить основной диалог и поручить рутину специализированному помощнику.
Самый простой способ — команда /agents прямо в чате Claude Code: она открывает интерфейс создания и управления субагентами. Под капотом субагент — это markdown-файл с YAML-заголовком (поля name, description, tools, model) в папке .claude/agents/ проекта или ~/.claude/agents/ для личных. В заголовке описываешь, кто это и когда применять, в теле — системный промт-инструкцию.
Субагент работает в отдельном окне контекста и не засоряет основной диалог. Обычный чат держит всю историю в одном контексте, и тяжёлая подзадача забивает его лишними деталями. Субагент уходит, делает работу в своём пространстве и возвращает только итог. Про управление контекстом подробно — в гайде про контекст-инжиниринг.
Субагенты нужны под узкие повторяющиеся роли и объёмные подзадачи, которые засоряют основной контекст. Хорошие кандидаты: ревью кода, прогон и починка тестов, исследование большого участка проекта, отладка. Если задача разовая и простая — субагент не нужен, проще решить её в основном чате.
Читать дальше
Субагенты задают роли, а скилы — навыки внутри них. В маркетплейсе ИИ-офиса собраны готовые навыки для Claude Code: разработка, дизайн, контент, автоматизация. Ставь готовый или собирай свой набор.
Открыть маркетплейс скиловА разборы, эфиры и живое сообщество вайбкодеров — в Telegram ИИ-офиса.