Пример создания субагента в Claude Code

Работа с субагентами в Claude Code

Давайте посмотрим практическую часть работы с субагентами в Claude Code. Прежде чем начать, важно понимать, что агенты Claude Code могут находиться на двух уровнях:

• на уровне проекта (доступны только в текущем проекте)
• на глобальном уровне пользователя (доступны для всех проектов в системе)

Папка, в которой хранятся агенты — это .claude/agents либо в домашней директории пользователя, либо в директории проекта. В ней создаются субагенты Claude Code, которые мы можем использовать.

Основная команда для работы с агентами — это команда /agents. С её помощью можно создавать новых агентов и просматривать существующих в системе.

Создание и настройка агента

При создании нового агента нужно указать, где он будет доступен. Есть два варианта:

• на уровне основного проекта, в котором вы находитесь
• на уровне глобального пользователя (Personal)

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

Существует два способа создания агента:

• автоматическая генерация
• ручная конфигурация

При ручной конфигурации необходимо:

1. Придумать уникальный идентификатор для агента (например, analyzer)
2. Написать системный промпт для агента
3. Описать условия вызова агента (вручную, при событии или при работе с определёнными файлами)
4. Указать возможности и инструменты агента
5. Выбрать модель (например, Sonnet)
6. Выбрать цвет для визуального отличия

После создания агента необходимо перезапустить Claude Code, чтобы изменения применились. Затем можно вызвать агента командой, например: "Используй агент analyzer и проанализируй проект".

При создании агента в проекте появляется папка .claude/agents с файлом конфигурации агента. Этот файл содержит все настройки: цвет, модель, описание и условия вызова.

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

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