Что такое субагенты?
Субагенты — это предварительно настроенные ИИ-личности, которым Claude Code может делегировать задачи. Каждый субагент:- Имеет определенную цель и область экспертизы
- Использует собственное окно контекста, отдельное от основного разговора
- Может быть настроен с определенными инструментами, которые ему разрешено использовать
- Включает пользовательский системный промпт, который направляет его поведение
Ключевые преимущества
Сохранение контекста
Каждый субагент работает в собственном контексте, предотвращая загрязнение основного разговора и сохраняя его сосредоточенность на высокоуровневых целях.
Специализированная экспертиза
Субагенты могут быть точно настроены с подробными инструкциями для конкретных областей, что приводит к более высоким показателям успеха в назначенных задачах.
Переиспользуемость
После создания субагенты могут использоваться в разных проектах и делиться с вашей командой для согласованных рабочих процессов.
Гибкие разрешения
Каждый субагент может иметь разные уровни доступа к инструментам, позволяя вам ограничить мощные инструменты определенными типами субагентов.
Быстрый старт
Чтобы создать своего первого субагента:1
Откройте интерфейс субагентов
Выполните следующую команду:
2
Выберите 'Create New Agent'
Выберите, создать ли субагента уровня проекта или пользователя
3
Определите субагента
- Рекомендуется: Сначала сгенерируйте с Claude, затем настройте, чтобы сделать его своим
- Подробно опишите своего субагента и когда он должен использоваться
- Выберите инструменты, к которым хотите предоставить доступ (или оставьте пустым для наследования всех инструментов)
- Интерфейс показывает все доступные инструменты, упрощая выбор
- Если вы генерируете с Claude, вы также можете редактировать системный промпт в своем собственном редакторе, нажав
e
4
Сохраните и используйте
Ваш субагент теперь доступен! Claude будет использовать его автоматически при необходимости, или вы можете вызвать его явно:
Конфигурация субагентов
Расположение файлов
Субагенты хранятся как Markdown-файлы с YAML frontmatter в двух возможных местах:| Тип | Расположение | Область действия | Приоритет |
|---|---|---|---|
| Субагенты проекта | .claude/agents/ | Доступны в текущем проекте | Наивысший |
| Субагенты пользователя | ~/.claude/agents/ | Доступны во всех проектах | Ниже |
Агенты плагинов
Плагины могут предоставлять пользовательских субагентов, которые бесшовно интегрируются с Claude Code. Агенты плагинов работают идентично пользовательским агентам и появляются в интерфейсе/agents.
Расположение агентов плагинов: Плагины включают агентов в своей директории agents/ (или пользовательских путях, указанных в манифесте плагина).
Использование агентов плагинов:
- Агенты плагинов появляются в
/agentsрядом с вашими пользовательскими агентами - Могут быть вызваны явно: “Используй агента code-reviewer из security-plugin”
- Могут быть вызваны автоматически Claude при необходимости
- Могут управляться (просматриваться, инспектироваться) через интерфейс
/agents
Конфигурация на основе CLI
Вы также можете определить субагентов динамически, используя флаг CLI--agents, который принимает JSON-объект:
- Быстрого тестирования конфигураций субагентов
- Субагентов, специфичных для сессии, которые не нужно сохранять
- Скриптов автоматизации, которым нужны пользовательские субагенты
- Обмена определениями субагентов в документации или скриптах
Формат файла
Каждый субагент определяется в Markdown-файле с такой структурой:Поля конфигурации
| Поле | Обязательно | Описание |
|---|---|---|
name | Да | Уникальный идентификатор, использующий строчные буквы и дефисы |
description | Да | Описание цели субагента на естественном языке |
tools | Нет | Список конкретных инструментов через запятую. Если опущено, наследует все инструменты из основного потока |
model | Нет | Модель для использования этим субагентом. Может быть псевдонимом модели (sonnet, opus, haiku) или 'inherit' для использования модели основного разговора. Если опущено, по умолчанию используется настроенная модель субагента |
Выбор модели
Полеmodel позволяет контролировать, какую ИИ-модель использует субагент:
- Псевдоним модели: Используйте один из доступных псевдонимов:
sonnet,opusилиhaiku 'inherit': Используйте ту же модель, что и основной разговор (полезно для согласованности)- Опущено: Если не указано, использует модель по умолчанию, настроенную для субагентов (
sonnet)
Использование
'inherit' особенно полезно, когда вы хотите, чтобы ваши субагенты адаптировались к выбору модели основного разговора, обеспечивая согласованные возможности и стиль ответов на протяжении всей сессии.Доступные инструменты
Субагентам может быть предоставлен доступ к любым внутренним инструментам Claude Code. См. документацию по инструментам для полного списка доступных инструментов.Рекомендуется: Используйте команду
/agents для изменения доступа к инструментам - она предоставляет интерактивный интерфейс, который перечисляет все доступные инструменты, включая любые подключенные инструменты MCP-сервера, упрощая выбор нужных.- Опустить поле
toolsдля наследования всех инструментов из основного потока (по умолчанию), включая инструменты MCP - Указать отдельные инструменты как список через запятую для более детального контроля (может редактироваться вручную или через
/agents)
tools опущено, субагенты наследуют все инструменты MCP, доступные основному потоку.
Управление субагентами
Использование команды /agents (Рекомендуется)
Команда/agents предоставляет комплексный интерфейс для управления субагентами:
- Просматривать всех доступных субагентов (встроенных, пользовательских и проектных)
- Создавать новых субагентов с управляемой настройкой
- Редактировать существующих пользовательских субагентов, включая их доступ к инструментам
- Удалять пользовательских субагентов
- Видеть, какие субагенты активны при наличии дубликатов
- Легко управлять разрешениями инструментов с полным списком доступных инструментов
Прямое управление файлами
Вы также можете управлять субагентами, работая напрямую с их файлами:Эффективное использование субагентов
Автоматическое делегирование
Claude Code проактивно делегирует задачи на основе:- Описания задачи в вашем запросе
- Поля
descriptionв конфигурациях субагентов - Текущего контекста и доступных инструментов
Чтобы поощрить более проактивное использование субагентов, включите фразы типа “используй ПРОАКТИВНО” или “ДОЛЖЕН БЫТЬ ИСПОЛЬЗОВАН” в поле
description.Явный вызов
Запросите конкретного субагента, упомянув его в своей команде:Примеры субагентов
Рецензент кода
Отладчик
Специалист по данным
Лучшие практики
- Начинайте с агентов, сгенерированных Claude: Мы настоятельно рекомендуем генерировать вашего начального субагента с Claude, а затем итерировать над ним, чтобы сделать его лично вашим. Этот подход дает вам лучшие результаты - прочную основу, которую вы можете настроить под свои конкретные потребности.
- Проектируйте сфокусированных субагентов: Создавайте субагентов с единственными, четкими обязанностями, а не пытайтесь заставить одного субагента делать все. Это улучшает производительность и делает субагентов более предсказуемыми.
- Пишите подробные промпты: Включайте конкретные инструкции, примеры и ограничения в ваши системные промпты. Чем больше руководства вы предоставите, тем лучше будет работать субагент.
- Ограничивайте доступ к инструментам: Предоставляйте только те инструменты, которые необходимы для цели субагента. Это улучшает безопасность и помогает субагенту сосредоточиться на релевантных действиях.
- Контроль версий: Включайте субагентов проекта в контроль версий, чтобы ваша команда могла извлечь пользу и улучшить их совместно.
Продвинутое использование
Цепочка субагентов
Для сложных рабочих процессов вы можете связывать несколько субагентов:Динамический выбор субагентов
Claude Code интеллектуально выбирает субагентов на основе контекста. Делайте ваши поляdescription конкретными и ориентированными на действия для лучших результатов.
Соображения производительности
- Эффективность контекста: Агенты помогают сохранить основной контекст, обеспечивая более длинные общие сессии
- Задержка: Субагенты начинают с чистого листа каждый раз, когда они вызываются, и могут добавлять задержку, поскольку они собирают контекст, необходимый для эффективного выполнения своей работы.
Связанная документация
- Плагины - Расширьте Claude Code пользовательскими агентами через плагины
- Слэш-команды - Изучите другие встроенные команды
- Настройки - Настройте поведение Claude Code
- Хуки - Автоматизируйте рабочие процессы с обработчиками событий