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

Создание подагента

Самый простой способ создать подагента — использовать команду `/agents`. Это откроет основной интерфейс для управления подагентами. Затем выберите «Создать нового агента».

Сначала вам предложат выбрать область действия подагента:

• На уровне проекта — доступен только в текущем проекте
• На уровне пользователя — общий для всех проектов на вашем устройстве

Далее вы можете выбрать способ его создания. Вы можете вручную написать конфигурацию, но рекомендуемый подход — поручить создание Claude. Просто опишите, что должен делать подагент, и Claude сгенерирует имя, описание и системный промт на основе вашего запроса.

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

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

• Инструменты только для чтения
• Инструменты редактирования
• Инструменты выполнения
• MCP-инструменты
• Другие инструменты

Подумайте, что именно нужно вашему подагенту. Например, агенту для проверки кода, скорее всего, не нужны инструменты редактирования — он должен только читать и анализировать код, а не изменять его. Однако вы можете оставить включёнными инструменты выполнения, чтобы он мог легче выявлять ожидаемые изменения.

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

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

• Haiku — лучше всего подходит для быстрых и лёгких задач
• Sonnet — хороший баланс между скоростью и глубиной анализа
• Opus — лучше всего подходит для сложного анализа
• Inherit — использует ту же модель, что и основной чат

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

Конфигурационный файл

После завершения создания файл конфигурации подагента сохраняется в вашем проекте (обычно в `.claude/agents/your-agent-name.md`). Вот пример типичной конфигурации подагента:

```markdown

name: code-quality-reviewer

description: Use this agent when you need to review recently written or modified code for quality, security, and best practice compliance.

tools: Bash, Glob, Grep, Read, WebFetch, WebSearch

model: sonnet

color: purple

```

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

Разберём каждое поле:

• name — уникальный идентификатор подагента. Это то, как вы ссылаетесь на него, либо напрямую обращаясь к Claude, либо вводя `@agent code-quality-reviewer` в своём сообщении.
• description — определяет, когда Claude решит использовать подагента. Это поле должно быть однострочным (используйте экранированные символы новой строки ` `, если вам нужны разрывы). Вы можете включить примеры диалогов, чтобы помочь Claude понять, в каких случаях следует делегировать задачу.
• tools — перечисляет инструменты, к которым подагент может получить доступ. Это соответствует тому, что вы выбрали при генерации, но вы можете редактировать список здесь в любое время.
• model — указывает, какая модель Claude будет использоваться: sonnet, opus, haiku или inherit.
• color — цвет интерфейса для идентификации подагента.

Системные промты

Тело markdown-файла (всё, что ниже YAML-заголовка) — это системный промт. Здесь вы даёте подагенту инструкции: на чём он должен сосредоточиться, как анализировать данные и как передавать результаты основному агенту.

Хорошо написанный системный промт — это разница между полезным подагентом и тем, который не справляется с задачей. Будьте конкретны в том, что подагент должен искать и как структурировать вывод.

Автоматическое использование подагента Claude

Если вы хотите, чтобы Claude автоматически делегировал задачи подагенту без явного запроса с вашей стороны, включите слово «proactively» (проактивно) в поле description. Например:

```markdown

description: Proactively suggest running this agent after major code changes...

```

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

Тестирование подагента

После создания подагента протестируйте его, внеся изменения в код и попросив Claude проверить их.

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