Параллельные задачи Claude Code
Claude Code предоставляет несколько механизмов параллельного выполнения задач, позволяя одновременно обрабатывать несколько рабочих элементов и значительно повышать эффективность разработки. В этой главе представлены три основных подхода к распараллеливанию: Subagents, Agent Teams и Git Worktree, которые помогут вам выбрать наиболее подходящий метод для разных сценариев использования.
Обзор параллельных задач
При работе со сложными задачами одного экземпляра Claude может быть недостаточно — контекст становится слишком длинным, ответы замедляются, а задачи перемешиваются. Claude Code предоставляет трёхуровневый механизм распараллеливания, чтобы соответствовать разным уровням сложности и потребностям:
| Механизм | Применимые сценарии | Способ взаимодействия | Сложность |
|---|---|---|---|
| Субагенты | Сфокусированные задачи, важен только результат | Односторонняя отчётность (результаты возвращаются главному агенту) | Низкая |
| Agent Teams | Сложная работа, требующая обсуждения и сотрудничества | Многосторонняя коммуникация (участники команды пишут друг другу напрямую) | Средняя |
| Git Worktree | Несколько задач, требующих изолированных сред для кода | Полностью независимые (каждая со своим рабочим каталогом) | Средняя |
Рекомендации по выбору:
- Для независимых подзадач, которым просто нужно параллельное выполнение → используйтеSubagents
- Для нескольких агентов, которым нужно обсуждать и координировать работу → используйтеAgent Teams
- Для нескольких задач, которым нужно работать с разными ветками одного и того же репозитория → используйтеGit Worktree
Субагенты
Что такое субагенты
Субагент — это независимо работающий экземпляр Claude с собственным контекстом и фокусом на задаче. Основной Claude может создавать несколько субагентов, каждый из которых отвечает за конкретную подзадачу:
┌─────────────────────────────────────────────────────────┐
│ 主 Claude │
│ (协调者) │
└─────────────────────────────────────────────────────────┘
│
▼
┌───────────────┼───────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Agent A │ │ Agent B │ │ Agent C │
│ 代码审查 │ │ 测试生成 │ │ 文档编写 │
└──────────┘ └──────────┘ └──────────┘
│ │ │
└───────────────┴───────────────┘
│
▼
返回结果给主代理
До 49 субагентов могут работать параллельно, полностью удовлетворяя большинство потребностей в параллельной обработке.
Встроенные субагенты
Claude Code включает следующие встроенные субагенты:
| Агент | Модель | Инструменты | Назначение |
|---|---|---|---|
Explore |
Haiku (быстрый, с низкой задержкой) | Инструменты только для чтения | Поиск файлов, поиск по коду, исследование кодовой базы |
Plan |
Наследует основной диалог | Инструменты только для чтения | Исследование кодовой базы в режиме планирования |
General-purpose |
Наследует основной диалог | Все инструменты | Сложные исследования, многошаговые операции, модификация кода |
statusline-setup |
Sonnet | — | Запустите/statuslineНастроить строку состояния |
Claude Code Guide |
Haiku | — | Отвечать на вопросы о функциях Claude Code |
Создание субагента
Метод 1: Использовать команду /agents
Запустите/agentsкоманду и следовать подсказкам, чтобы создать нового субагента:
/agents
ВыберитеСоздать нового агента, затем выберите место сохранения, опишите функциональность и позвольте Claude сгенерировать конфигурацию.
Метод 2: Создать файл субагента вручную
Файлы субагента используют YAML frontmatter для конфигурации, после чего следует системный промпт в Markdown:
Пример
name: code-reviewer
description: Проверяет код на качество и соответствие лучшим практикам
tools: Read, Glob, Grep
model: sonnet
---
Вы — рецензент кода. При вызове анализируйте код и предоставляйте
конкретную, действенную обратную связь по качеству, безопасности и лучшим практикам.
Поля конфигурации субагента
| Поле | Обязательный | Описание |
|---|---|---|
name |
Да | Уникальный идентификатор из строчных букв и дефисов |
description |
Да | Описывает, когда Claude должен делегировать этому субагенту |
tools |
нет | Список инструментов, которые может использовать субагент |
disallowedTools |
нет | Инструменты для запрета |
model |
нет | Используемая модель: sonnet, opus, haiku или inherit |
permissionMode |
нет | Режим разрешений: default, acceptEdits, auto, dontAsk, bypassPermissions, plan |
maxTurns |
нет | Максимальное количество ходов агента до остановки субагента |
skills |
нет | Навыки, загружаемые при запуске |
mcpServers |
нет | MCP-серверы, доступные этому субагенту |
memory |
нет | Область постоянной памяти: user, project или local |
background |
нет | Запускать ли всегда как фоновую задачу |
isolation |
нет | Установите значение worktree, чтобы запускать во временном git worktree |
Управление возможностями субагента
Ограничения инструментов
Пример
---
name: safe-researcher
description: Исследовательский агент с ограниченными возможностями
tools: Read, Grep, Glob, Bash
---
# Исключить конкретные инструменты
---
name: no-writes
description: Наследует все инструменты, кроме записи файлов
disallowedTools: Write, Edit
---
Выбор модели
Пример
---
name: quick-searcher
description: Быстрый поиск файлов
model: haiku
---
# Использовать Opus (мощный, дорогой)
---
name: deep-analyst
description: Глубокий анализ кода
model: opus
---
# Наследовать модель основного диалога
---
name: general-purpose
model: inherit
---
Вызов субагентов
Метод 1: Естественный язык
Use the test-runner subagent to fix failing tests
Метод 2: @-упоминание
@"code-reviewer (agent)" look at the auth changes
Метод 3: Запуск из командной строки
claude --agent code-reviewer
Выполнение на переднем и заднем плане
- Субагент переднего плана: блокирует основной диалог до завершения
- Субагент заднего плана: выполняется параллельно, нажмите, чтобы
Ctrl+Bswitch
Agent Teams
Что такое Agent Teams
Команды агентов позволяют координировать работу нескольких экземпляров Claude Code. Представьте, что одновременно запущены 4 сеанса Claude (A, B, C, D), где один выступает в роли лидера команды, отвечает за координацию работы, распределение задач и интеграцию результатов. Остальные три участника работают независимо, каждый со своим контекстным окном, но при этом могут напрямую общаться друг с другом.
Субагенты против команд агентов
| Характеристики | Субагенты | Agent Teams |
|---|---|---|
| Контекст | Собственное контекстное окно; результаты возвращаются вызывающей стороне | Собственное контекстное окно; полностью независимы |
| Связь | Только сообщает результаты главному агенту | Отправляют сообщения напрямую друг другу между участниками команды |
| Координация | Главный агент управляет всей работой | Общий список задач, поддерживает самокоординацию |
| Лучше всего подходит для | Сфокусированные задачи, требующие внимания только к результатам | Сложная работа, требующая обсуждения и сотрудничества |
| Затраты токенов | Ниже: результаты в обобщённом виде возвращаются в основной контекст | Выше: каждый участник команды — независимый экземпляр Claude |
Простыми словами:Субагент похож на сотрудника, отчитывающегося перед руководителем; Agent Teams — это проектная группа равноправных коллег, совместно работающих.。
Включение Agent Teams
Agent Teams отключён по умолчанию. Вам нужно добавить его вsettings.json:
Пример
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Или задайте переменную окружения:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Требования: Claude Code v2.1.32 или выше
Запуск Agent Team
После включения опишите задачу и структуру команды на естественном языке:
Пример
их кодовой базе. Создайте команду агентов, чтобы исследовать это с разных сторон: один
участник команды по UX, один по технической архитектуре, один играет роль адвоката дьявола.
Управление командой агентов
Режим отображения
- Внутрипроцессный режим: все участники команды работают в основном терминале, используйте
Shift+Downдля переключения между участниками команды - Разделенные панели: каждый участник команды получает свою собственную панель tmux/iTerm2
Пример
"teammateMode": "in-process"
}
Указание количества участников команды и моделей
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
Назначение задач
- Ведущий может явно назначать задачи
- Участники команды могут самостоятельно назначать себе неназначенные и незаблокированные задачи
- Задачи имеют три состояния: ожидание, выполнение и завершение
Взаимодействие с участниками команды
- Внутрипроцессный:
Shift+DownЦиклически переключаться → ввести сообщение →EnterПросмотр →EscapeПрервать - Разделённая панель: Нажмите на панель участника команды, чтобы взаимодействовать напрямую
Закрытие участников команды
Ask the researcher teammate to shut down
Архитектура команд агентов
| Компоненты | Роли |
|---|---|
| Тимлид | Основной сеанс Claude Code, который создаёт команду, порождает участников команды и координирует работу |
| Участники команды | Независимые экземпляры Claude Code, каждый из которых выполняет назначенные задачи |
| Список задач | Общий список рабочих элементов, которые участники команды берут в работу и выполняют |
| Почтовый ящик | Система обмена сообщениями между агентами |
Расположение хранилища:
- Конфигурация команды:
~/.claude/teams/{team-name}/config.json - Список задач:
~/.claude/tasks/{team-name}/
Поддержка Git Worktree
Предыстория проблемы
Когда несколько агентов работают одновременно, они могут «сражаться» друг с другом. Представьте такой сценарий: вы просите Агента A отрефакторить модуль базы данных, а Агента B — исправить ошибку на странице входа. Эти две задачи кажутся несвязанными, но оба работают в одном репозитории кода и в одной ветке. Агент A изменяетutils.py, а Агент B также изменяетutils.py. Один сохраняет одну версию, другой перезаписывает её другой версией, что в конечном итоге приводит к конфликтам, ошибкам и даже потере данных.
Это не проблема ИИ; это ограничение базовой структуры репозитория Git.
Что такое Git Worktree
Git Worktree — это функция Git, которая позволяет подключить несколько независимых рабочих каталогов к одному репозиторию. У каждого рабочего каталога есть своя ветка, свой HEAD и своя область подготовки (staging area), но все они используют одну и ту же.gitбазу данных (историю, хранилище объектов).
Аналогия
в каждом офисе своя команда (Agent), каждая работает над своим проектом (веткой),
но все они используют одну и ту же базу данных компании (.git) и историю."
Использование Git Worktree
Запуск из командной строки
# 创建 feature-auth 分支的工作树 claude -w feature-auth # 同时创建 tmux 会话 claude -w feature-auth --tmux # 使用传统 tmux claude -w feature-auth --tmux=classic
Параметры CLI
| Параметр | Описание | Пример |
|---|---|---|
--worktree, -w |
Запустить Claude в изолированном рабочем дереве Git | claude -w feature-auth |
--tmux |
Создать сессию tmux для рабочего дерева | claude -w feature-auth --tmux |
Расположение создания worktree:<repo>/.claude/worktrees/<name>
Поддержка настольных приложений
В настольном приложении Claude перейдите на вкладку Code и просто установите флажок режима worktree, чтобы включить режим рабочего пространства.
Субагент + изоляция worktree
Вы можете настроить пользовательские субагенты так, чтобы они всегда запускались в собственном worktree:
Пример
name: background-refactorer
description: Агент фонового рефакторинга
isolation: worktree
---
Примеры использования
Пример 1: параллельный обзор кода
Использование субагентов
Используйте субагент security-reviewer для проверки проблем безопасности
Используйте субагент performance-reviewer для анализа влияния на производительность
Используйте субагент test-coverage для проверки покрытия тестами
Использование Agent Teams
- Один сосредоточен на последствиях для безопасности
- Один проверяет влияние на производительность
- Один проверяет покрытие тестами
Попросите каждого из них провести проверку и сообщить о результатах.
Пример 2: Параллельное исследование
Research the authentication, database, and API modules in parallel using separate subagents
Пример 3: Исследование с конкурирующими гипотезами
Пример
Запустите 5 участников команды агентов для исследования разных гипотез. Попросите их поговорить с
друг друга, чтобы попытаться опровергнуть теории друг друга, как в научном
споре. Обновите документ с выводами, включив в него любой достигнутый консенсус.
Пример 4: Разработка с несколькими ветками
# 终端 1:重构用户模块 claude -w feature/user-refactor # 终端 2:修复登录 bug claude -w bugfix/login-issue # 终端 3:开发新功能 claude -w feature/new-dashboard
Пример 5: Связывание субагентов
Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them
Лучшие практики
Лучшие практики работы с субагентами
- Будьте сосредоточены: у каждого субагента должна быть четкая, единственная ответственность
- Ограничьте инструменты: ограничивайте доступ субагента к инструментам в зависимости от требований задачи
- Выбирайте подходящую модель: используйте Haiku для простых задач, Sonnet или Opus для сложных задач
- Используйте фоновое выполнение: используйте фоновых субагентов для длительных задач, чтобы не блокировать основной диалог
- Возобновление субагента: когда нужно продолжить работу, попросите Claude возобновить субагента
Лучшие практики команд агентов
- Дайте товарищам по команде достаточно контекста: включайте детали, относящиеся к задаче, в сгенерированные промпты
- Выберите подходящий размер команды: Большинство рабочих процессов начинаются с 3-5 участников команды
- Оптимальный размер задач: 5-6 задач на участника команды поддерживают высокую производительность
- Дождитесь завершения работы участников команды: Скажите руководителю подождать, пока участники команды закончат, прежде чем продолжать
- Начните с исследований и проверки: Начните с задач, не требующих написания кода
- Избегайте конфликтов файлов: Разделите работу так, чтобы каждый участник команды отвечал за свой набор файлов
- Отслеживайте и направляйте: Проверяйте прогресс, перенаправляйте подходы, которые не работают
Лучшие практики Git Worktree
- Один worktree на задачу: Избегайте работы над несколькими несвязанными задачами в одном worktree
- Используйте управление tmux: При одновременном запуске нескольких сессий Claude используйте tmux для удобного переключения
- Очищайте ненужные worktree: Удаляйте worktree сразу после завершения задачи
Устранение неполадок
FAQ по командам агентов
| Проблема | Решение |
|---|---|
| Участник команды не появляется | Проверьте, достаточно ли сложна задача и установлен ли tmux |
| Слишком много запросов на разрешение | Предварительно одобрите типовые операции в настройках разрешений |
| Участник команды останавливается после ошибки | Проверьте вывод и дайте дополнительные инструкции или создайте участника команды на замену |
| Ведущий завершает работу досрочно | Скажите ведущему продолжить или подождать завершения участников команды |
| Осиротевшие сеансы tmux | Используйтеtmux lsиtmux kill-session -t <session-name>Очистите |
Практические примеры субагентов
Ревьюер кода
Пример
name: code-reviewer
description: Эксперт по ревью кода. Проактивно проверяет код на качество, безопасность и удобство сопровождения.
tools: Read, Grep, Glob, Bash
model: inherit
---
Вы старший рецензент кода, обеспечивающий высокие стандарты качества кода и безопасности.
При вызове:
1. Запустите git diff, чтобы увидеть последние изменения
2. Сосредоточьтесь на изменённых файлах
3. Немедленно начните проверку
Контрольный список проверки:
- Код понятен и удобочитаем
- Функции и переменные хорошо названы
- Нет дублированного кода
- Надлежащая обработка ошибок
- Нет раскрытых секретов или ключей API
- Реализована проверка входных данных
- Хорошее покрытие тестами
- Рассмотрены вопросы производительности
Предоставляйте обратную связь, упорядоченную по приоритету:
- Критические проблемы (необходимо исправить)
- Предупреждения (следует исправить)
- Предложения (рассмотрите возможность улучшения)
Отладчик
Пример
name: debugger
description: Специалист по отладке ошибок, сбоев тестов и неожиданного поведения.
tools: Read, Edit, Bash, Grep, Glob
---
Вы — эксперт по отладке, специализирующийся на анализе первопричин.
При вызове:
1. Зафиксируйте сообщение об ошибке и трассировку стека
2. Определите шаги воспроизведения
3. Изолируйте место сбоя
4. Реализуйте минимальное исправление
5. Убедитесь, что решение работает
Процесс отладки:
- Анализируйте сообщения об ошибках и логи
- Проверьте последние изменения кода
- Формулируйте и проверяйте гипотезы
- Добавьте стратегическое отладочное логирование
- Изучите состояния переменных
Инструмент запросов к базе данных только для чтения
Пример
имя: db-reader
description: Выполняйте запросы к базе данных только для чтения. Используйте при анализе данных или создании отчётов.
tools: Bash
hooks:
PreToolUse:
- matcher: "Bash"
hooks:
- type: command
command: "./scripts/validate-readonly-query.sh"
---
Вы аналитик баз данных с доступом только для чтения. Выполняйте запросы SELECT, чтобы отвечать на вопросы о данных.