Субагенты

Пользовательские субагенты в Claude Code — это специализированные ИИ-помощники, которые могут быть вызваны для выполнения определенных типов задач. Они обеспечивают более эффективное решение проблем, предоставляя задачно-ориентированные конфигурации с настраиваемыми системными промптами, инструментами и отдельным окном контекста.

​

Что такое субагенты?

Субагенты — это предварительно настроенные ИИ-личности, которым Claude Code может делегировать задачи. Каждый субагент:

• Имеет определенную цель и область экспертизы
• Использует собственное окно контекста, отдельное от основного разговора
• Может быть настроен с определенными инструментами, которые ему разрешено использовать
• Включает пользовательский системный промпт, который направляет его поведение

Когда Claude Code сталкивается с задачей, которая соответствует экспертизе субагента, он может делегировать эту задачу специализированному субагенту, который работает независимо и возвращает результаты.

​

Ключевые преимущества

​

Быстрый старт

Чтобы создать своего первого субагента:

/agents

> Используй субагента code-reviewer для проверки моих недавних изменений

​

Конфигурация субагентов

​

Расположение файлов

Субагенты хранятся как Markdown-файлы с YAML frontmatter в двух возможных местах:

Когда имена субагентов конфликтуют, субагенты уровня проекта имеют приоритет над субагентами уровня пользователя.

​

Формат файла

Каждый субагент определяется в Markdown-файле с такой структурой:

---
name: your-sub-agent-name
description: Описание того, когда этот субагент должен быть вызван
tools: tool1, tool2, tool3  # Необязательно - наследует все инструменты, если опущено
---

Системный промпт вашего субагента идет здесь. Это может быть несколько абзацев
и должно четко определять роль субагента, возможности и подход
к решению проблем.

Включите конкретные инструкции, лучшие практики и любые ограничения,
которым должен следовать субагент.

​

Поля конфигурации

​

Доступные инструменты

Субагентам может быть предоставлен доступ к любому из внутренних инструментов Claude Code. См. документацию по инструментам для полного списка доступных инструментов.

У вас есть два варианта для настройки инструментов:

• Опустить поле tools для наследования всех инструментов из основного потока (по умолчанию), включая инструменты MCP
• Указать отдельные инструменты как список через запятую для более детального контроля (может редактироваться вручную или через /agents)

Инструменты MCP: Субагенты могут получать доступ к инструментам MCP из настроенных MCP-серверов. Когда поле tools опущено, субагенты наследуют все инструменты MCP, доступные основному потоку.

​

Управление субагентами

​

Использование команды /agents (Рекомендуется)

Команда /agents предоставляет комплексный интерфейс для управления субагентами:

/agents

Это открывает интерактивное меню, где вы можете:

• Просматривать всех доступных субагентов (встроенных, пользовательских и проектных)
• Создавать новых субагентов с управляемой настройкой
• Редактировать существующих пользовательских субагентов, включая их доступ к инструментам
• Удалять пользовательских субагентов
• Видеть, какие субагенты активны при наличии дубликатов
• Легко управлять разрешениями инструментов с полным списком доступных инструментов

​

Прямое управление файлами

Вы также можете управлять субагентами, работая напрямую с их файлами:

# Создать субагента проекта
mkdir -p .claude/agents
echo '---
name: test-runner
description: Используй проактивно для запуска тестов и исправления сбоев
---

Ты эксперт по автоматизации тестирования. Когда видишь изменения в коде, проактивно запускай соответствующие тесты. Если тесты не проходят, анализируй сбои и исправляй их, сохраняя первоначальное намерение теста.' > .claude/agents/test-runner.md

# Создать субагента пользователя
mkdir -p ~/.claude/agents
# ... создать файл субагента

​

Эффективное использование субагентов

​

Автоматическое делегирование

Claude Code проактивно делегирует задачи на основе:

• Описания задачи в вашем запросе
• Поля description в конфигурациях субагентов
• Текущего контекста и доступных инструментов

​

Явный вызов

Запросите конкретного субагента, упомянув его в своей команде:

> Используй субагента test-runner для исправления неудачных тестов
> Пусть субагент code-reviewer посмотрит на мои недавние изменения
> Попроси субагента debugger исследовать эту ошибку

​

Примеры субагентов

​

Рецензент кода

---
name: code-reviewer
description: Специалист-эксперт по рецензированию кода. Проактивно рецензирует код на качество, безопасность и поддерживаемость. Используй немедленно после написания или изменения кода.
tools: Read, Grep, Glob, Bash
---

Ты старший рецензент кода, обеспечивающий высокие стандарты качества и безопасности кода.

При вызове:
1. Запусти git diff для просмотра недавних изменений
2. Сосредоточься на измененных файлах
3. Начни рецензирование немедленно

Контрольный список рецензирования:
- Код простой и читаемый
- Функции и переменные хорошо названы
- Нет дублированного кода
- Правильная обработка ошибок
- Нет открытых секретов или API-ключей
- Реализована валидация входных данных
- Хорошее покрытие тестами
- Рассмотрены вопросы производительности

Предоставляй обратную связь, организованную по приоритету:
- Критические проблемы (должны быть исправлены)
- Предупреждения (следует исправить)
- Предложения (стоит рассмотреть улучшение)

Включай конкретные примеры того, как исправить проблемы.

​

Отладчик

---
name: debugger
description: Специалист по отладке ошибок, сбоев тестов и неожиданного поведения. Используй проактивно при столкновении с любыми проблемами.
tools: Read, Edit, Bash, Grep, Glob
---

Ты эксперт-отладчик, специализирующийся на анализе первопричин.

При вызове:
1. Захвати сообщение об ошибке и трассировку стека
2. Определи шаги воспроизведения
3. Изолируй место сбоя
4. Реализуй минимальное исправление
5. Проверь, что решение работает

Процесс отладки:
- Анализируй сообщения об ошибках и логи
- Проверяй недавние изменения в коде
- Формируй и тестируй гипотезы
- Добавляй стратегическое логирование отладки
- Проверяй состояния переменных

Для каждой проблемы предоставляй:
- Объяснение первопричины
- Доказательства, подтверждающие диагноз
- Конкретное исправление кода
- Подход к тестированию
- Рекомендации по предотвращению

Сосредоточься на исправлении основной проблемы, а не только симптомов.

​

Специалист по данным

---
name: data-scientist
description: Эксперт по анализу данных для SQL-запросов, операций BigQuery и инсайтов данных. Используй проактивно для задач анализа данных и запросов.
tools: Bash, Read, Write
---

Ты специалист по данным, специализирующийся на SQL и анализе BigQuery.

При вызове:
1. Пойми требование к анализу данных
2. Напиши эффективные SQL-запросы
3. Используй инструменты командной строки BigQuery (bq) при необходимости
4. Анализируй и суммируй результаты
5. Представляй находки четко

Ключевые практики:
- Пиши оптимизированные SQL-запросы с правильными фильтрами
- Используй соответствующие агрегации и соединения
- Включай комментарии, объясняющие сложную логику
- Форматируй результаты для читаемости
- Предоставляй рекомендации, основанные на данных

Для каждого анализа:
- Объясняй подход к запросу
- Документируй любые предположения
- Выделяй ключевые находки
- Предлагай следующие шаги на основе данных

Всегда обеспечивай эффективность и экономичность запросов.

​

Лучшие практики

• Начинай с агентов, сгенерированных Claude: Мы настоятельно рекомендуем генерировать вашего начального субагента с Claude, а затем итерировать над ним, чтобы сделать его лично вашим. Этот подход дает вам лучшие результаты - прочную основу, которую вы можете настроить под свои конкретные потребности.

• Проектируй сфокусированных субагентов: Создавай субагентов с единственными, четкими обязанностями, а не пытайся заставить одного субагента делать все. Это улучшает производительность и делает субагентов более предсказуемыми.

• Пиши подробные промпты: Включай конкретные инструкции, примеры и ограничения в свои системные промпты. Чем больше руководства ты предоставишь, тем лучше будет работать субагент.

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

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

​

Продвинутое использование

​

Цепочка субагентов

Для сложных рабочих процессов ты можешь связывать несколько субагентов в цепочку:

> Сначала используй субагента code-analyzer для поиска проблем производительности, затем используй субагента optimizer для их исправления

​

Динамический выбор субагентов

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

​

Соображения производительности

• Эффективность контекста: Агенты помогают сохранить основной контекст, обеспечивая более длительные общие сессии
• Задержка: Субагенты начинают с чистого листа каждый раз, когда они вызываются, и могут добавлять задержку, поскольку они собирают контекст, необходимый для эффективного выполнения своей работы.

​

Связанная документация

• Слэш-команды - Изучи другие встроенные команды
• Настройки - Настрой поведение Claude Code
• Хуки - Автоматизируй рабочие процессы с обработчиками событий