Tâches parallèles de Claude Code

Claude Code propose plusieurs mécanismes d'exécution parallèle des tâches, vous permettant de gérer plusieurs éléments de travail simultanément et d'améliorer considérablement l'efficacité du développement. Ce chapitre présente trois approches principales de parallélisation : Subagents, Agent Teams et Git Worktree, pour vous aider à choisir la méthode la plus adaptée à différents scénarios d'utilisation.


Aperçu des tâches parallèles

Lorsque vous êtes confronté à des tâches complexes, une seule instance de Claude peut être insuffisante — le contexte devenant trop long, les réponses ralentissant et les tâches s'entrelaçant. Claude Code propose un mécanisme de parallélisation à trois niveaux pour répondre à différents besoins de complexité et de collaboration :

Mécanisme Scénarios applicables Méthode de collaboration Complexité
Sous-agents Tâches ciblées, il suffit de se préoccuper des résultats Rapport unidirectionnel (résultats renvoyés à l'agent principal) Faible
Agent Teams Travail complexe nécessitant discussion et collaboration Communication multidirectionnelle (les coéquipiers communiquent directement entre eux) Moyenne
Git Worktree Plusieurs tâches nécessitant des environnements de code isolés Entièrement indépendant (chacun avec son propre répertoire de travail) Moyenne

Suggestions de sélection :

  • Pour les sous-tâches indépendantes qui nécessitent simplement un traitement parallèle → utilisezSubagents
  • Pour plusieurs agents devant discuter et coordonner le travail → utilisezAgent Teams
  • Pour plusieurs tâches devant opérer sur différentes branches du même dépôt → utilisezGit Worktree

Sous-agents

Que sont les sous-agents

Un sous-agent est une instance Claude s'exécutant indépendamment, avec son propre contexte et sa propre focalisation sur la tâche. Le Claude principal peut créer plusieurs sous-agents, chacun responsable d'une sous-tâche spécifique :

┌─────────────────────────────────────────────────────────┐
│                    主 Claude                            │
│                    (协调者)                              │
└─────────────────────────────────────────────────────────┘
                        │
                        ▼
        ┌───────────────┼───────────────┐
        ▼               ▼               ▼
┌──────────┐    ┌──────────┐    ┌──────────┐
│ Agent A  │    │ Agent B  │    │ Agent C  │
│ 代码审查  │    │ 测试生成  │    │ 文档编写  │
└──────────┘    └──────────┘    └──────────┘
        │               │               │
        └───────────────┴───────────────┘
                        │
                        ▼
                 返回结果给主代理

Jusqu'à 49 sous-agents peuvent s'exécuter en parallèle, répondant pleinement à la plupart des besoins de traitement parallèle.

Sous-agents intégrés

Claude Code est fourni avec les sous-agents intégrés suivants :

Agent Modèle Outils Objectif
Explore Haiku (rapide, faible latence) Outils en lecture seule Découverte de fichiers, recherche de code, exploration de la base de code
Plan Hérite de la conversation principale Outils en lecture seule Recherche dans la base de code en mode planification
General-purpose Hérite de la conversation principale Tous les outils Recherche complexe, opérations en plusieurs étapes, modification de code
statusline-setup Sonnet — Exécutez/statuslineConfigurer la ligne d'état
Claude Code Guide Haiku — Répondre aux questions sur les fonctionnalités de Claude Code

Création d'un sous-agent

Méthode 1 : utilisez la commande /agents

Exécutez/agentscommande, puis suivez les instructions pour créer un nouveau sous-agent :

/agents

ChoisissezCréer un nouvel agent, puis choisissez un emplacement de sauvegarde, décrivez la fonctionnalité et laissez Claude générer la configuration.

Méthode 2 : créer manuellement un fichier de sous-agent

Les fichiers de sous-agent utilisent un frontmatter YAML pour la configuration, suivi du prompt système en Markdown :

Exemple

---
name
: code-reviewer
description
: Examine le code pour la qualité et les bonnes pratiques
tools
: Read, Glob, Grep
model
: sonnet
---

Vous êtes un relecteur de code. Lorsqu'il est invoqué, analysez le code et fournissez
des retours spécifiques et exploitables sur la qualité, la sécurité et les bonnes pratiques.

Champs de configuration du sous-agent

Champ Requis Description
name Oui Identifiant unique utilisant des lettres minuscules et des traits d'union
description Oui Décrit quand Claude doit déléguer à ce sous-agent
tools non Liste des outils que le sous-agent peut utiliser
disallowedTools non Outils à refuser
model non Modèle à utiliser : sonnet, opus, haiku ou inherit
permissionMode non Mode d'autorisation : default, acceptEdits, auto, dontAsk, bypassPermissions, plan
maxTurns non Nombre maximal de tours d'agent avant l'arrêt du sous-agent
skills non Compétences chargées au démarrage
mcpServers non Serveurs MCP disponibles pour ce sous-agent
memory non Portée de la mémoire persistante : user, project ou local
background non Indique s'il faut toujours s'exécuter en tâche d'arrière-plan
isolation non Défini sur worktree pour s'exécuter dans un worktree git temporaire

Contrôle des capacités du sous-agent

Restrictions d'outils

Exemple

# Autoriser uniquement des outils spécifiques
---
name
: safe-researcher
description
: Agent de recherche aux capacités restreintes
tools
: Read, Grep, Glob, Bash
---

# Exclure des outils spécifiques
---
name
: no-writes
description
: Hérite de tous les outils sauf les écritures de fichiers
disallowedTools
: Write, Edit
---

Sélection du modèle

Exemple

# Utiliser Haiku (rapide, économique)
---
name
: quick-searcher
description
: Recherche rapide de fichiers
model
: haiku
---

# Utiliser Opus (puissant, coûteux)
---
name
: deep-analyst
description
: Analyse approfondie de code
model
: opus
---

# Hériter du modèle de conversation principal
---
name
: general-purpose
model
: inherit
---

Appel de sous-agents

Méthode 1 : langage naturel

Use the test-runner subagent to fix failing tests

Méthode 2 : @-mention

@"code-reviewer (agent)" look at the auth changes

Méthode 3 : lancement en ligne de commande

claude --agent code-reviewer

Exécution au premier plan et en arrière-plan

  • Sous-agent au premier plan: bloque la conversation principale jusqu'à son achèvement
  • Sous-agent en arrière-plan: s'exécute simultanément, appuyez sur pourCtrl+Bswitch

Agent Teams

Que sont les équipes d'agents

Agent Teams vous permet de coordonner plusieurs instances de Claude Code afin qu'elles travaillent ensemble. Vous pouvez exécuter simultanément 4 sessions Claude (A, B, C, D), dont l'une agit comme chef d'équipe, chargée de coordonner le travail, d'attribuer les tâches et d'intégrer les résultats. Les trois autres membres travaillent indépendamment avec leurs propres fenêtres de contexte, tout en pouvant communiquer directement entre eux.

Subagents vs Agent Teams

Caractéristiques Sous-agents Agent Teams
Contexte Fenêtre de contexte propre ; résultats renvoyés à l'agent principal Fenêtre de contexte propre ; indépendant
Communication Rapporte uniquement les résultats à l'agent principal S'envoyer directement des messages entre coéquipiers
Coordination L'agent principal gère tout le travail Liste de tâches partagée, prend en charge l'auto-coordination
Idéal pour Tâches ciblées qui ne nécessitent qu'une attention aux résultats Travail complexe nécessitant discussion et collaboration
Coût en tokens Plus bas : les résultats sont résumés dans le contexte principal Plus haut : chaque coéquipier est une instance Claude indépendante

En termes simples :Un sous-agent est comme un employé qui rend compte au patron ; Agent Teams est un groupe de projet de pairs collaborant d'égal à égal.。

Activation d'Agent Teams

Agent Teams est désactivé par défaut. Vous devez l'ajouter danssettings.json:

Exemple

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Ou définissez la variable d'environnement :

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Prérequis: Claude Code v2.1.32 ou version ultérieure

Démarrage d'une Agent Team

Une fois activé, décrivez la tâche et la structure de l'équipe en langage naturel :

Exemple

Je conçois un outil CLI qui aide les développeurs à suivre les commentaires TODO à travers
leur base de code. Créez une équipe d'agents pour explorer cela sous différents angles : un
un coéquipier sur l'UX, un sur l'architecture technique, un jouant l'avocat du diable.

Contrôler une équipe d'agents

Mode d'affichage

  • In-process: Tous les coéquipiers s'exécutent dans le terminal principal, utilisezShift+Downpour passer d'un coéquipier à l'autre
  • Panneaux divisés: Chaque coéquipier dispose de son propre panneau tmux/iTerm2

Exemple

{
  "teammateMode": "in-process"
}

Spécifier le nombre de coéquipiers et de modèles

Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.

Attribution des tâches

  • Le chef d'équipe peut attribuer explicitement des tâches
  • Les coéquipiers peuvent s'attribuer des tâches non attribuées et non bloquées
  • Les tâches ont trois états : en attente, en cours et terminées

Interaction avec les coéquipiers

  • Intra-processus:Shift+DownParcourir en boucle → saisir un message →EnterAffichage →EscapeInterrompre
  • Volet fractionné: Cliquez sur le volet d'un coéquipier pour interagir directement

Fermeture des coéquipiers

Ask the researcher teammate to shut down

Architecture des équipes d'agents

Composants Rôles
Chef d'équipe La session principale de Claude Code qui crée l'équipe, lance les coéquipiers et coordonne le travail
Coéquipiers Instances indépendantes de Claude Code, chacune gérant les tâches assignées
Liste de tâches Une liste partagée d'éléments de travail que les coéquipiers prennent en charge et terminent
Boîte aux lettres Un système de messagerie pour la communication entre agents

Emplacement de stockage :

  • Configuration d'équipe : ~/.claude/teams/{team-name}/config.json
  • Liste de tâches : ~/.claude/tasks/{team-name}/

Prise en charge de Git Worktree

Contexte du problème

Lorsque plusieurs agents travaillent en même temps, ils peuvent « se battre » entre eux. Imaginez ce scénario : vous demandez à l'agent A de refactoriser le module de base de données et à l'agent B de corriger un bug sur la page de connexion. Les deux tâches semblent sans rapport, mais elles travaillent toutes les deux dans le même dépôt de code et sur la même branche. L'agent A modifieutils.py, et l'agent B modifie égalementutils.py. L'un enregistre une version, l'autre l'écrase avec une version différente, ce qui conduit finalement à des conflits, des erreurs, et même à une perte de données.

Ce n'est pas un problème d'IA ; c'est une limitation de la structure du dépôt Git sous-jacent.

Qu'est-ce que Git Worktree

Git Worktree est une fonctionnalité Git qui vous permet de monter plusieurs répertoires de travail indépendants sur le même dépôt. Chaque répertoire de travail a sa propre branche, son propre HEAD et sa propre zone de préparation, mais ils partagent tous la même.gitbase de données (historique, stockage d'objets).

Analogie

Analogie de la vie quotidienne : « La même entreprise (dépôt principal) possède plusieurs bureaux (worktrees),
chaque bureau a une équipe différente (Agent), chacune travaillant sur un projet différent (branche),
mais ils partagent tous la base de données (.git) et l'historique de l'entreprise. »

Utilisation de Git Worktree

Démarrage depuis la ligne de commande

# 创建 feature-auth 分支的工作树
claude -w feature-auth

# 同时创建 tmux 会话
claude -w feature-auth --tmux

# 使用传统 tmux
claude -w feature-auth --tmux=classic

Paramètres CLI

Paramètre Description Exemple
--worktree, -w Démarrer Claude dans un worktree git isolé claude -w feature-auth
--tmux Créer une session tmux pour le worktree claude -w feature-auth --tmux

Emplacement de création du worktree :<repo>/.claude/worktrees/<name>

Prise en charge du bureau

Dans l'application de bureau Claude, accédez à l'onglet Code et cochez simplement le mode worktree pour activer le mode espace de travail.

Sous-agent + isolation worktree

Vous pouvez faire en sorte que les sous-agents personnalisés s'exécutent toujours dans leur propre worktree :

Exemple

---
name
: background-refactorer
description
: Agent de refactorisation en arrière-plan
isolation
: worktree
---

Exemples d'utilisation

Exemple 1 : Revue de code parallèle

Utilisation des sous-agents

# Faire en sorte que plusieurs sous-agents examinent simultanément différents aspects du code
Utilisez le sous-agent security-reviewer pour vérifier les problèmes de sécurité
Utilisez le sous-agent performance-reviewer pour analyser l'impact sur les performances
Utilisez le sous-agent test-coverage pour valider la couverture de tests

Utilisation des équipes d'agents

Créez une équipe d'agents pour examiner la PR #142. Lancez trois relecteurs :
- Un centré sur les implications de sécurité
- Un vérifiant l'impact sur les performances
- Un validant la couverture de tests
Demandez à chacun de faire une revue et de rapporter ses conclusions.

Exemple 2 : Recherche parallèle

Research the authentication, database, and API modules in parallel using separate subagents

Exemple 3 : Investigation avec des hypothèses concurrentes

Exemple

Les utilisateurs signalent que l'application se ferme après un message au lieu de rester connectée.
Lancez 5 coéquipiers agents pour étudier différentes hypothèses. Demandez-leur de parler à
les uns les autres pour tenter de réfuter les théories des autres, comme un
débat scientifique. Mettez à jour le document des conclusions avec tout consensus qui émerge.

Exemple 4 : Développement multi-branches

# 终端 1:重构用户模块
claude -w feature/user-refactor

# 终端 2:修复登录 bug
claude -w bugfix/login-issue

# 终端 3:开发新功能
claude -w feature/new-dashboard

Exemple 5 : Chaînage de sous-agents

Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them

Bonnes pratiques

Bonnes pratiques pour les sous-agents

  1. Restez concentré: Chaque sous-agent doit avoir une responsabilité claire et unique
  2. Limitez les outils: Restreignez l'accès aux outils des sous-agents en fonction des exigences de la tâche
  3. Choisissez un modèle approprié: Utilisez Haiku pour les tâches simples, Sonnet ou Opus pour les tâches complexes
  4. Utilisez l'exécution en arrière-plan: Utilisez des sous-agents en arrière-plan pour les tâches de longue durée afin d'éviter de bloquer la conversation principale
  5. Reprendre un sous-agent: Lorsque vous devez poursuivre le travail, demandez à Claude de reprendre le sous-agent

Bonnes pratiques pour les équipes d'agents

  1. Donnez suffisamment de contexte aux coéquipiers: Incluez des détails spécifiques à la tâche dans les prompts générés
  2. Choisir une taille d'équipe appropriée: La plupart des workflows commencent avec 3-5 coéquipiers
  3. Dimensionner correctement les tâches: 5-6 tâches par coéquipier maintiennent une productivité élevée
  4. Attendre que les coéquipiers aient terminé: Dites au lead d'attendre que les coéquipiers aient terminé avant de continuer
  5. Commencer par la recherche et la revue: Commencez par les tâches qui ne nécessitent pas d'écrire du code
  6. Éviter les conflits de fichiers: Répartissez le travail pour que chaque coéquipier possède un ensemble différent de fichiers
  7. Surveiller et guider: Vérifiez la progression, réorientez les approches qui ne fonctionnent pas

Bonnes pratiques Git Worktree

  1. Un worktree par tâche: Évitez de travailler sur plusieurs tâches sans lien dans le même worktree
  2. Utiliser tmux pour la gestion: Lorsque vous exécutez plusieurs sessions Claude simultanément, utilisez tmux pour basculer facilement
  3. Nettoyer les worktrees inutiles: Supprimez rapidement les worktrees après la fin d'une tâche

Dépannage

FAQ sur les équipes d'agents

Problème Solution
Un coéquipier n'apparaît pas Vérifier si la tâche est suffisamment complexe et si tmux est installé
Trop de demandes d'autorisation Pré-approuver les opérations courantes dans les paramètres d'autorisation
Un coéquipier s'arrête après une erreur Vérifier la sortie et donner des instructions supplémentaires ou lancer un coéquipier de remplacement
Le lead s'arrête prématurément Dire au lead de continuer ou d'attendre que les coéquipiers terminent
Sessions tmux orphelines Utilisertmux lsettmux kill-session -t <session-name>Nettoyer

Exemples pratiques de sous-agents

Relecteur de code

Exemple

---
name
: code-reviewer
description
: Spécialiste expert en revue de code. Examine proactivement le code pour la qualité, la sécurité et la maintenabilité.
tools
: Read, Grep, Glob, Bash
model
: inherit
---

Vous êtes un relecteur de code senior garantissant des normes élevées de qualité et de sécurité du code.

Lorsqu'il est invoqué
:
1. Exécutez git diff pour voir les modifications récentes
2. Concentrez-vous sur les fichiers modifiés
3. Commencez la revue immédiatement

Liste de contrôle de la revue
:
- Le code est clair et lisible
- Les fonctions et les variables sont bien nommées
- Aucun code dupliqué
- Gestion appropriée des erreurs
- Aucun secret ni clé d'API exposés
- Validation des entrées implémentée
- Bonne couverture de tests
- Considérations de performance

Fournissez des retours organisés par priorité
:
- Problèmes critiques (doivent être corrigés)
- Avertissements (devraient être corrigés)
- Suggestions (à envisager d'améliorer)

Débogueur

Exemple

---
name
: debugger
description
: Spécialiste du débogage pour les erreurs, les échecs de tests et les comportements inattendus.
tools
: Read, Edit, Bash, Grep, Glob
---

Vous êtes un débogueur expert spécialisé dans l'analyse des causes racines.

Lorsqu'il est invoqué
:
1. Capturez le message d'erreur et la trace de pile
2. Identifier les étapes de reproduction
3. Isoler l'emplacement de la défaillance
4. Implémenter un correctif minimal
5. Vérifier que la solution fonctionne

Processus de débogage
:
- Analyser les messages d'erreur et les journaux
- Vérifier les modifications récentes du code
- Formuler et tester des hypothèses
- Ajouter une journalisation de débogage stratégique
- Inspecter les états des variables

Outil de requête de base de données en lecture seule

Exemple

---
nom
: db-reader
description
: Exécuter des requêtes de base de données en lecture seule. À utiliser lors de l'analyse de données ou de la génération de rapports.
tools
: Bash
hooks
:
  PreToolUse
:
    - matcher
: "Bash"
      hooks
:
        - type
: command
          command
: "./scripts/validate-readonly-query.sh"
---

Vous êtes un analyste de base de données avec un accès en lecture seule. Exécutez des requêtes SELECT pour répondre aux questions sur les données.
Autres extensions