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
---
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
---
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 pour
Ctrl+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
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, utilisez
Shift+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
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
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
- 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
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
- Restez concentré: Chaque sous-agent doit avoir une responsabilité claire et unique
- Limitez les outils: Restreignez l'accès aux outils des sous-agents en fonction des exigences de la tâche
- Choisissez un modèle approprié: Utilisez Haiku pour les tâches simples, Sonnet ou Opus pour les tâches complexes
- 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
- Reprendre un sous-agent: Lorsque vous devez poursuivre le travail, demandez à Claude de reprendre le sous-agent
Bonnes pratiques pour les équipes d'agents
- Donnez suffisamment de contexte aux coéquipiers: Incluez des détails spécifiques à la tâche dans les prompts générés
- Choisir une taille d'équipe appropriée: La plupart des workflows commencent avec 3-5 coéquipiers
- Dimensionner correctement les tâches: 5-6 tâches par coéquipier maintiennent une productivité élevée
- Attendre que les coéquipiers aient terminé: Dites au lead d'attendre que les coéquipiers aient terminé avant de continuer
- Commencer par la recherche et la revue: Commencez par les tâches qui ne nécessitent pas d'écrire du code
- Éviter les conflits de fichiers: Répartissez le travail pour que chaque coéquipier possède un ensemble différent de fichiers
- Surveiller et guider: Vérifiez la progression, réorientez les approches qui ne fonctionnent pas
Bonnes pratiques Git Worktree
- Un worktree par tâche: Évitez de travailler sur plusieurs tâches sans lien dans le même worktree
- Utiliser tmux pour la gestion: Lorsque vous exécutez plusieurs sessions Claude simultanément, utilisez tmux pour basculer facilement
- 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.