Параллельные задачи 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
---

Выбор модели

Пример

# Использовать Haiku (быстрый, дешевый)
---
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

После включения опишите задачу и структуру команды на естественном языке:

Пример

Я проектирую инструмент CLI, который помогает разработчикам отслеживать комментарии TODO по всей
их кодовой базе. Создайте команду агентов, чтобы исследовать это с разных сторон: один
участник команды по 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

Создайте команду агентов для проверки PR #142. Запустите трёх проверяющих:
- Один сосредоточен на последствиях для безопасности
- Один проверяет влияние на производительность
- Один проверяет покрытие тестами
Попросите каждого из них провести проверку и сообщить о результатах.

Пример 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

Лучшие практики

Лучшие практики работы с субагентами

  1. Будьте сосредоточены: у каждого субагента должна быть четкая, единственная ответственность
  2. Ограничьте инструменты: ограничивайте доступ субагента к инструментам в зависимости от требований задачи
  3. Выбирайте подходящую модель: используйте Haiku для простых задач, Sonnet или Opus для сложных задач
  4. Используйте фоновое выполнение: используйте фоновых субагентов для длительных задач, чтобы не блокировать основной диалог
  5. Возобновление субагента: когда нужно продолжить работу, попросите Claude возобновить субагента

Лучшие практики команд агентов

  1. Дайте товарищам по команде достаточно контекста: включайте детали, относящиеся к задаче, в сгенерированные промпты
  2. Выберите подходящий размер команды: Большинство рабочих процессов начинаются с 3-5 участников команды
  3. Оптимальный размер задач: 5-6 задач на участника команды поддерживают высокую производительность
  4. Дождитесь завершения работы участников команды: Скажите руководителю подождать, пока участники команды закончат, прежде чем продолжать
  5. Начните с исследований и проверки: Начните с задач, не требующих написания кода
  6. Избегайте конфликтов файлов: Разделите работу так, чтобы каждый участник команды отвечал за свой набор файлов
  7. Отслеживайте и направляйте: Проверяйте прогресс, перенаправляйте подходы, которые не работают

Лучшие практики Git Worktree

  1. Один worktree на задачу: Избегайте работы над несколькими несвязанными задачами в одном worktree
  2. Используйте управление tmux: При одновременном запуске нескольких сессий Claude используйте tmux для удобного переключения
  3. Очищайте ненужные 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, чтобы отвечать на вопросы о данных.
Другие расширения