Comment orchestrer plusieurs agents Claude Code en parallèle ? (Agent Teams + worktrees, 2026)

TL;DR — Ce que vous allez apprendre

• Orchestrer plusieurs agents Claude Code = lancer 2 à 8 instances qui travaillent en parallèle sur le même projet, sans collision de fichiers
• Deux briques le rendent possible : les git worktrees (isolation des fichiers) et les Agent Teams (coordination via une todo-list partagée)
• Le point d'équilibre mesuré en 2026 : 2 à 4 sous-agents par tâche pour la plupart des projets ; au-delà, la coordination coûte plus qu'elle ne rapporte
• Un système multi-agents (lead Opus + sous-agents Sonnet) a dépassé un agent unique de 90,2 % sur l'évaluation interne de recherche d'Anthropic
• Règle d'or : un agent = une responsabilité isolable. Découpez par fichier/module, jamais par « moitié de la même fonction »

---

Pourquoi orchestrer plusieurs agents Claude Code plutôt qu'un seul ?

Vous lancez Claude Code sur une tâche lourde — un refactor multi-modules, une migration, un audit complet — et vous attendez. L'agent travaille bien, mais séquentiellement : il lit un fichier, le modifie, passe au suivant. Pendant ce temps, votre terminal est bloqué et vous regardez la barre de progression.

Le problème n'est pas la qualité de Claude. C'est que une seule tâche occupe une seule fenêtre de contexte. Dès qu'un projet a des sous-parties indépendantes — le backend d'un côté, le frontend de l'autre, les tests encore ailleurs — les faire traiter par un seul agent revient à mettre un seul développeur sur un projet qui en mériterait quatre.

Orchestrer plusieurs agents Claude Code, c'est répartir le travail entre plusieurs instances qui tournent en même temps. Chacune a son propre contexte, ses propres fichiers, son propre rapport final. La session principale ne récupère que les conclusions — pas le bruit intermédiaire.

« Token usage by itself explains 80% of the variance in performance. » Autrement dit : plus vous parallélisez le travail cognitif sur plusieurs agents, plus vous augmentez la capacité totale de raisonnement appliquée à votre tâche. — *Anthropic, How we built our multi-agent research system, 2026*

Selon les mesures publiées par Anthropic en 2026, un système multi-agents avec un agent lead Claude Opus 4 et des sous-agents Claude Sonnet 4 a surpassé de 90,2 % un agent unique Opus 4 sur leur évaluation interne de recherche. Le revers : un système multi-agents consomme environ 15× plus de tokens qu'une conversation simple. La parallélisation se mérite — elle est rentable sur les tâches lourdes et isolables, pas sur un one-shot trivial.

Quelle est la différence entre subagents, worktrees et Agent Teams ?

Trois notions reviennent en boucle et sont souvent confondues. Voici la grille de lecture claire.

La logique d'assemblage est simple. Les worktrees résolvent l'isolation (deux sessions n'écrasent jamais les mêmes fichiers). Les Agent Teams résolvent la coordination (les sessions savent qui traite quoi). Et les subagents sont l'unité de base : un agent, une responsabilité, un rapport.

Si vous débutez sur la délégation, lisez d'abord notre guide complet des subagents Claude Code avant de passer à l'orchestration parallèle décrite ici.

Comment isoler les agents avec les git worktrees ?

Un git worktree, c'est un second répertoire de travail rattaché au même dépôt git, sur une branche différente. Vous pouvez en créer plusieurs : chacun est un dossier indépendant où un agent travaille sans toucher aux fichiers des autres.

Le principe en trois commandes :

@@@

git worktree add ../projet-auth feature/auth

git worktree add ../projet-api feature/api

git worktree add ../projet-tests feature/tests

@@@

Vous lancez ensuite une instance Claude Code dans chaque dossier :

@@@

cd ../projet-auth && claude

cd ../projet-api && claude

cd ../projet-tests && claude

@@@

Résultat : trois agents, trois branches, zéro collision. Quand chacun a terminé, vous mergez les branches une à une. Claude Code peut même créer les worktrees pour vous : les sous-agents peuvent s'exécuter dans leur propre worktree, nettoyé automatiquement si rien n'a changé.

« Exécuter chaque session Claude Code dans son propre worktree signifie que les modifications dans une session ne touchent jamais les fichiers dans une autre. » — *Claude Code Docs, Run parallel sessions with worktrees, 2026*

Astuce 2026 : dès la mi-2026, des équipes font tourner de façon fiable 4 à 8 worktrees concurrents par développeur. Mais commencez petit : deux worktrees suffisent à doubler votre débit sans noyer votre charge mentale.

Comment coordonner les agents avec Agent Teams (la todo-list partagée) ?

Isoler ne suffit pas : il faut que les agents sachent qui fait quoi. C'est le rôle des Agent Teams. Plusieurs instances Claude se coordonnent via une todo-list partagée : chaque agent prend une tâche, la marque « en cours », la termine, puis en prend une autre. Pas de double traitement, pas de tâche oubliée.

Le pattern d'orchestration recommandé est le suivant :

1. L'agent lead (souvent Opus, pour le raisonnement) découpe la mission en sous-tâches indépendantes et les écrit dans la todo-list partagée.
2. Chaque sous-agent (souvent Sonnet, plus rapide et économique) prend une sous-tâche, travaille dans son worktree, rend son rapport.
3. L'agent lead agrège les rapports, vérifie la cohérence, lance le merge.

C'est exactement l'architecture de l'équipe de recherche multi-agents d'Anthropic : un lead qui orchestre, des sous-agents qui exécutent en parallèle, chacun ne remontant que sa conclusion. Pour aller plus loin sur le choix lead/sous-agent, voir notre comparatif Claude Sonnet vs Opus : quel modèle choisir.

Combien d'agents lancer en parallèle ?

En pratique, 2 à 4 sous-agents sont le point optimal pour la plupart des projets : au-delà, la surcharge de coordination et la gestion des worktrees git parallèles dépassent les gains du parallélisme. Inutile de lancer huit agents pour un projet de trois modules.

Quels pièges éviter quand on orchestre plusieurs agents ?

L'orchestration parallèle est puissante, mais elle a ses chausse-trappes. Les quatre les plus fréquentes :

• Découper mal les tâches. Un agent = une responsabilité *isolable*. Si deux agents doivent éditer la même fonction, vous aurez des conflits de merge. Découpez par fichier ou par module, jamais par « moitié de la même logique ».
• Sur-paralléliser. Lancer 10 agents sur un petit projet multiplie les tokens (15× sur un système multi-agents) sans gain réel. Restez sur 2-4 sauf monorepo massif.
• Oublier la phase de merge. Trois branches qui avancent en parallèle, c'est trois merges à faire. Prévoyez une étape de réconciliation et de tests d'intégration à la fin.
• Négliger les garde-fous. Plusieurs agents qui écrivent en parallèle = plus de surface de risque. Posez des hooks Claude Code (PreToolUse pour bloquer les commandes destructrices, PostToolUse pour formater) sur chaque worktree.

La discipline d'orchestration s'apprend vite, mais elle s'apprend. C'est précisément ce qu'on travaille en exercices pratiques dans la formation MaîtriseLIA : découpage des tâches, worktrees, coordination lead/sous-agents, et merge propre.

FAQ

Combien d'agents Claude Code puis-je lancer en parallèle ?

Techniquement, autant que votre machine et votre quota le permettent. En pratique, 2 à 4 sous-agents sont le point d'équilibre pour la plupart des projets en 2026. Les équipes avancées montent à 4-8 worktrees concurrents par développeur sur de gros monorepos, mais au-delà la surcharge de coordination (merges, conflits) dépasse les gains.

Quelle différence entre un subagent et un git worktree ?

Un subagent est une instance Claude isolée qui exécute une tâche et rend un rapport — il résout le problème du contexte pollué. Un git worktree est un répertoire de travail séparé qui résout le problème de la collision de fichiers. Les deux se combinent : un subagent travaille dans son propre worktree pour ne jamais écraser les fichiers d'un autre.

Faut-il un plan Max pour orchestrer plusieurs agents ?

Recommandé, oui. Un système multi-agents consomme environ 15× plus de tokens qu'une conversation simple (mesure Anthropic 2026). Le plan Pro suffit pour tester avec 2 agents, mais pour un usage régulier en parallèle, un plan Max 5× ou 20× évite de buter sur les limites. Voir notre guide pour choisir son modèle Sonnet vs Opus.

Comment éviter les conflits de merge entre agents ?

Découpez les tâches par fichier ou par module pour que deux agents ne touchent jamais le même code. Chaque agent travaille sur sa propre branche via un worktree. À la fin, mergez les branches une à une et lancez les tests d'intégration. Posez aussi des hooks de garde-fou — voir notre guide pratique des hooks Claude Code.

L'orchestration multi-agents est-elle toujours plus rapide ?

Non. Elle est rentable sur les tâches lourdes et isolables (refactor multi-modules, migration, audit). Sur une tâche simple ou non parallélisable, un agent unique est plus rapide et bien moins coûteux en tokens. La règle : parallélisez quand le travail se découpe naturellement, sinon restez sur un agent.

---

Vous voulez maîtriser l'orchestration multi-agents Claude Code en pratique ? La formation MaîtriseLIA couvre les worktrees, les Agent Teams, le découpage des tâches et le merge propre, avec des exercices concrets sur de vrais projets.

Commencer la formation →