Ваше взаимодействие с Claude Code всё ещё ограничивается простой схемой «ввод команды -> ожидание выполнения -> проверка результата»? Если это так, то вы, вероятно, упускаете его истинный потенциал. С сегодняшнего дня я запускаю серию уроков «Визуальное руководство по продвинутым методам работы с Claude Code», которая поможет вам исследовать те расширенные функции Claude Code, которые требуют первоначальных усилий для освоения, но после овладения ими значительно повышают эффективность работы.

По сравнению с официальными руководствами, данная серия ставит перед собой цели:

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

2. Более наглядно: Ключевые концепции и процессы представлены в виде визуальных схем, которые легко понять с первого взгляда.

3. Более практично: Мы рассмотрим только проверенные функции, имеющие реальную практическую ценность.

4. Более избегающе ошибок: Я укажу на подводные камни, через которые пришлось пройти, чтобы вы могли избежать их и использовать функции более гладко.

5. Более взаимосвязанно: Покажу взаимосвязи с другими функциями и научу вас использовать мощные комбинации приемов.

Сегодня мы разблокируем первую продвинутую функцию — Подагенты (Subagents).

Что такое подагенты?

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

Каждый подагент обладает следующими характеристиками:

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

2. Независимый контекст: Каждый подагент имеет собственное независимое контекстное окно, что предотвращает вмешательство информации из основного диалога и позволяет сохранять фокус на ключевых целях.

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

4. Индивидуальные инструкции: Каждый подагент обладает уникальным системным промптом, который определяет его модель поведения и стратегию мышления.

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

Приведем практический пример для иллюстрации.

Предположим, вы дали Claude Code следующую инструкцию:

«Пожалуйста, проверьте этот Python-скрипт, найдите ошибки и проанализируйте выходные данные.»

Основной агент Claude Code выполнит следующие действия:

1. Декомпозиция задачи: Главный агент идентифицирует три различных типа задач в запросе.

2. Делегирование экспертам: Он распределит эти три задачи между специализированными подагентами: «ревьюером кода», «отладчиком» и «аналитиком данных».

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

4. Интеграция результатов: В заключение главный агент объединит результаты работы всех трех подагентов и сформирует comprehensive ответ для пользователя.

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

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

Теория закончена, давайте перейдем к практической части. Ниже мы шаг за шагом создадим подагента с названием «Оптимизатор промптов».

Способ 1: Использование помощника Claude для генерации

Шаг 1: Выполните команду /agent

Шаг 2: Выберите «Создать нового агента»

Шаг 3: Определите местоположение хранения агента

• Проектный уровень: Доступен только в текущем проекте

• Пользовательский уровень: Доступен во всех ваших проектах

Подсказка:
При командной работе рекомендуется выбирать «Проектный уровень». Это позволяет включить конфигурационные файлы подагентов в систему контроля версий (например, Git), что удобно для совместного использования, collaboration и итераций среди членов команды.
При конфликте имен приоритет имеют агенты проектного уровня над агентами пользовательского уровня.

Шаг 4: Выберите способ создания

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

Шаг 5: Опишите обязанности подагента

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

Секрет хорошего описания: детали, детали и еще раз детали! Постарайтесь включить конкретные инструкции, четкие примеры и явные ограничения. Четче ваши указания — тем эффективнее будет работа подагента.

Шаг 6: Назначьте соответствующие инструменты

Вы можете оставить это поле пустым, позволив агенту унаследовать все инструменты главного агента. Однако лучшей практикой является соблюдение «принципа минимальных привилегий». Предоставляйте подагенту только те инструменты, которые strictly необходимы для выполнения его основных задач. Это не только безопаснее, но и помогает агенту сфокусироваться на relevant операциях, избегая ошибочных действий.

Полный список доступных инструментов:

Помимо этих встроенных инструментов Claude Code, подагенты могут получать доступ к MCP-инструментам от настроенных MCP-серверов.

Шаг 7: Выбор драйверной модели

Разные модели определяют способности к reasoning и скорость работы агента:

• Opus: Наиболее мощный вариант, подходит для сложных задач, требующих глубокого анализа

• Sonnet: Сбалансированная производительность, подходит для большинства сценариев

• Haiku: Максимальная скорость, идеален для простых и частых задач

• Inherit: Использует ту же модель, что и основной агент

Шаг 8: Выберите выразительный фоновый цвет

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

Шаг 9: Подтверждение и сохранение

После нажатия кнопки подтверждения Claude создаст для вас файл .md, содержащий все определения этого подагента.

Формат выглядит следующим образом:

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
---

Your subagent's system prompt goes here. This can be multiple paragraphs
and should clearly define the subagent's role, capabilities, and approach
to solving problems.

Include specific instructions, best practices, and any constraints
the subagent should follow.
 https://vocus.cc/article/68b582f5fd89780001f9ae79

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

Вот пример конфигурации подагента «Оптимизатор промптов»:

---
name: prompt-optimizer
description: Use this agent when you need to transform vague or complex user requirements into precise, structured prompts that can be effectively executed by LLMs. This agent should be invoked whenever a user provides unclear instructions, when prompts need to be adapted to specific project contexts, or when additional technical details from the codebase are required to clarify requirements. Examples: - User says '帮我优化一下这个提示词' → Use prompt-optimizer to refine and structure it - User provides a feature request like '添加用户登录功能' → Use prompt-optimizer to extract technical requirements and incorporate relevant code context - User asks '如何改进这个API调用提示' → Use prompt-optimizer to enhance clarity and add implementation details from existing codebase
model: inherit
color: orange
---

You are an expert prompt optimization specialist with deep understanding of software engineering practices and LLM behavior. Your role is to transform user inputs into highly effective, structured prompts that maximize clarity and execution success.

You will:

1. **Analyze User Intent**: Carefully dissect the user's original prompt to identify core objectives, implicit requirements, and potential ambiguities. Look for technical terms, domain-specific concepts, and implementation details that need clarification.

2. **Structure the Prompt**: Transform the input into a clear, hierarchical structure with:
   - Context section: Background and constraints
   - Objective section: Specific goals and success criteria
   - Implementation section: Technical requirements and approach
   - Output section: Expected format and quality standards

3. **Incorporate Project Context**: 
   - Identify files mentioned or implied in the prompt
   - Extract relevant code snippets, configurations, or documentation
   - Summarize key architectural patterns and conventions from the codebase
   - Ensure alignment with project-specific standards (Flutter/Dart conventions, state management patterns, etc.)

4. **Resolve Ambiguities**: 
   - For unfamiliar technical concepts, perform targeted searches to gather authoritative information
   - Clarify domain-specific terminology
   - Provide concrete examples where helpful
   - Ask clarifying questions when critical information is missing

5. **Apply Engineering Best Practices**:
   - Follow SOLID principles and clean architecture patterns
   - Ensure compatibility with existing codebase structure
   - Consider performance, scalability, and maintainability
   - Adhere to Flutter/Dart conventions and the project's established patterns

6. **Quality Assurance**:
   - Verify the optimized prompt is unambiguous and actionable
   - Ensure all technical requirements are specified with appropriate detail
   - Check that output expectations are clearly defined
   - Validate alignment with project constraints and standards

Шаг 10: Управление вашими агентами

После успешного создания снова выполните команду /agent, и вы увидите только что созданного подагента. Вы сможете просматривать, редактировать или удалять его.

Способ 2: Ручная настройка подагента

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

Шаги аналогичны созданию с помощью помощника, с следующими отличиями:

Необходимо самостоятельно описать тип агента (имя);

Требование использовать уникальный идентификатор в нижнем регистре с дефисами;

Требуется самостоятельно описать содержание системного промпта;

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

Требуется самостоятельно описать условия вызова агента.

Использование подагентов

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

Способ 1: Автоматическое делегирование (главный агент самостоятельно принимает решение)
Это самый интеллектуальный и удобный способ. Claude Code будет автоматически определять необходимость и выбор «эксперта» на основе цели вашей инструкции.

Он принимает решение на основе следующей информации:

• Описание задачи в вашем запросе

• Содержание поля description в конфигурации подагента

• Контекст текущего диалога и доступные инструменты

Как сделать вызов более активным?
Добавьте в поле description подагента управляющие фразы типа «активное использование» или «обязательное использование», чтобы побудить главного агента вызывать его чаще.

Способ 2: Явный вызов (прямое указание имени)

Это аналогично тому, как вы упоминаете (@) коллегу в корпоративном мессенджере — вы можете прямо указать имя нужного подагента в своей инструкции.

Например, мы можем напрямую вызвать созданного ранее «Оптимизатора промптов»:

Однако важно отметить, что по умолчанию Claude Code скрывает детальный процесс выполнения подагентов.

Если вы хотите наблюдать за каждым шагом его рассуждений и операций (что очень полезно при отладке), вы можете использовать команду claude --verbose для активации режима подробного логирования.

Комбинированный прием: Пользовательские слэш-команды для вызова одним нажатием

Явный вызов с длинными инструкциями каждый раз может быть cumbersome. Мы можем создать пользовательскую слэш-команду, которая инкапсулирует часто используемые операции для вызова одним нажатием.

Слэш-команды по сути являются Markdown-файлами, содержащими预设ленные промпты. Они также разделяются на проектные и пользовательские.

Например, мы можем создать команду /prompt-optimize, специально предназначенную для вызова нашего «Оптимизатора промптов». Всего два шага:

Создание файла команды:

bash

# Создаем директорию для персональных команд (если не существует)
mkdir -p ~/.claude/commands

# Создаем файл команды и записываем содержимое
echo 'Используй @prompt-optimizer для оптимизации следующего промпта. Не выполняй сразу, сначала покажи оптимизированную версию для подтверждения. Промпт для оптимизации: $ARGUMENTS' > 
~/.claude/commands/prompt-optimize.md

Использование команды:
Теперь вам достаточно ввести: /prompt-optimize [здесь ваш промпт для оптимизации]

Заполнитель $ARGUMENTS в команде автоматически захватит весь текст, следующий после команды, и передаст его подагенту. Таким образом вызов сложных инструкций становится предельно простым.

Резюме

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

P. S. Поддержать меня можно подпиской на канал «KoiCode» — там я ежедневно делюсь гайдами по использованию ClaudeCode и полезными советами для повышения эффективности.