Создание субагента

⏱️ Примерное время: ~12 минут · 🎯 Урок 2 курса «Введение в субагентов» · 🎬 видео

Кастомные субагенты специализируются на конкретных задачах — например, на ревью кода, написании тестов или проверке документации. По сути это markdown-файлы с YAML-frontmatter, который указывает Claude, когда использовать субагента и как тот себя ведёт.

Создание субагента

Самый простой способ — слэш-команда /agents → Create new agent. Сначала выберите область видимости: уровень проекта (Project-level — только в текущем проекте) или уровень пользователя (User-level — во всех проектах на вашей машине). Затем выберите способ создания: написать конфигурацию вручную или (рекомендуется) поручить генерацию Claude — опишите, что вам нужно, и Claude сам сформирует имя, описание и системный промпт.

Настройка инструментов

В процессе создания настройте, к каким инструментам субагент будет иметь доступ: только чтение (Read-only), редактирование (Edit), выполнение (Execution), MCP и прочие инструменты (Other tools). Подумайте, что именно ему нужно: например, ревьюеру кода, скорее всего, не нужны инструменты редактирования (он читает и анализирует, а не меняет), но при этом ему могут пригодиться инструменты выполнения, чтобы выявить незакоммиченные изменения.

Выбор модели и цвета

Выберите модель: Haiku (быстрая и лёгкая), Sonnet (золотая середина), Opus (для сложного анализа) или Inherit (та же модель, что и в основном диалоге). Выберите цвет, который будет отображаться в интерфейсе, чтобы понимать, какой субагент сейчас активен.

Файл конфигурации

Файл сохраняется в .claude/agents/имя-вашего-агента.md. Примеры полей frontmatter:

name — уникальный идентификатор (ссылаться на него можно через @имя агента);
description — управляет тем, когда Claude использует субагента (одна строка, может включать примеры диалогов);
tools — к каким инструментам у него есть доступ;
model — sonnet / opus / haiku / inherit;
color — цвет в интерфейсе.

Ниже frontmatter располагается системный промпт — инструкции субагента: на чём ему сосредоточиться, как анализировать и как сообщать о находках.

Как заставить Claude использовать субагента автоматически

Добавьте в описание слово «proactively» («проактивно»), чтобы Claude делегировал задачи без отдельной просьбы. Включите в описание примеры диалогов, чтобы задать конкретные сценарии.

Тестирование

Внесите изменения в код и попросите Claude сделать ревью. Если субагент не задействуется тогда, когда вы этого ожидаете, проверьте описание — добавьте конкретные примеры и сценарии-триггеры.