Paralléliser Claude Code

Exécuter plusieurs instances de Claude Code en parallèle est l’un des plus grands gains de productivité possibles avec l’outil. Claude étant léger, vous pouvez lancer plusieurs copies, assigner à chacune une tâche différente, et les faire travailler simultanément — une équipe virtuelle d’ingénieurs, où votre rôle glisse de codeur à chef d’orchestre : distribuer les tâches, relire les résultats, arbitrer.

Le défi : les conflits de fichiers

Le principal obstacle aux instances parallèles est évident dès qu’on y pense : elles pourraient tenter de modifier les mêmes fichiers simultanément, générant du code conflictuel ou invalide, puisque chaque instance ignore ce que font les autres. Deux agents qui éditent le même module en même temps, c’est la corruption assurée.

La solution est un principe, avant d’être un outil : donner à chaque instance son propre espace de travail isolé. Chaque instance travaille sur sa propre copie du projet, effectue ses modifications en isolation, puis fusionne ses changements dans le projet principal. Reste à obtenir ces copies proprement — et Git a exactement ce qu’il faut.

Git Worktrees

Les worktrees Git sont parfaits pour ce workflow — si votre projet est déjà géré par Git, vous pouvez les utiliser immédiatement. Ce sont des extensions du système de branches qui permettent de créer des copies complètes de votre projet dans des répertoires séparés, chaque worktree correspondant à une branche : un dossier pour la fonctionnalité A, un autre pour la fonctionnalité B, chacun contenant une copie complète de la codebase.

Vous lancez ensuite des instances Claude Code séparées dans chaque worktree, travaillant en isolation totale — mêmes fichiers de départ, aucun risque de collision. Une fois le travail terminé, vous commitez et fusionnez dans la branche principale, comme n’importe quelle branche Git classique : l’outillage de merge que votre équipe connaît déjà fait office de point de synchronisation.

Automatiser la création de worktrees

Créer un worktree, recâbler les dépendances, ouvrir l’éditeur : le rituel peut sembler lourd — alors autant le déléguer à Claude Code lui-même, avec un prompt qui demande de :

• Créer un nouveau worktree git dans un dossier spécifique
• Créer des liens symboliques pour les dépendances non suivies par Git
• Lancer une nouvelle instance VS Code dans ce répertoire

Le deuxième point est le piège classique que l’automatisation évite : les node_modules et autres dépendances installées ne sont pas suivis par Git, donc absents du worktree neuf — les lier symboliquement épargne une réinstallation complète par espace de travail.

Commandes personnalisées

Plutôt que de copier-coller ce long prompt à chaque fois, transformez-le en commande : ajoutez un fichier .md dans .claude/commands, et son contenu devient une commande slash personnalisée. La commande peut utiliser $ARGUMENTS, remplacé par les arguments passés à l’appel :

• /project:create_worktree feature_a crée un worktree nommé « feature_a »
• /project:create_worktree develop crée un worktree nommé « develop »

Votre rituel d’orchestration tient désormais en une ligne par agent — c’est le même esprit que les prompts MCP : l’ingénierie de prompt investie une fois, réutilisée à chaque session.

Fusionner les changements

Quand les fonctionnalités sont terminées, l’autre moitié du cycle s’automatise de la même façon. Créez une seconde commande personnalisée qui demande à Claude de :

1. Naviguer dans le répertoire du worktree
2. Examiner le dernier commit
3. Revenir au répertoire racine
4. Fusionner la branche du worktree
5. Gérer automatiquement les éventuels conflits de merge

Même la résolution de conflits — l’étape que tout le monde redoute — devient une tâche que Claude traite : il lit les deux versions, comprend l’intention de chacune, et propose la fusion.

Résultats

Cette approche passe à l’échelle avec autant d’instances parallèles que vous pouvez superviser. Au lieu de travailler séquentiellement sur les fonctionnalités, plusieurs instances Claude développent différentes parties de votre projet simultanément, chacune dans son environnement isolé avant de réunir le travail. La limite n’est plus la vitesse de frappe — c’est votre capacité de revue : les agents produisent en parallèle, vous restez le point de convergence qui valide.

Points clés à retenir

• Plusieurs Claude Code en parallèle = équipe virtuelle ; votre rôle devient l’orchestration et la revue
• Le danger : les conflits de fichiers — la parade : un espace de travail isolé par instance
• Git worktrees : une copie complète du projet par branche, fusion par l’outillage Git standard
• Automatisez création (worktree + liens symboliques + éditeur) et merge via des commandes .claude/commands avec $ARGUMENTS
• La limite d’échelle est votre capacité de revue, plus la vitesse d’écriture du code