Chargement

Paralléliser Claude Code

Leçon 613 min
Chargement

Exécuter plusieurs instances de Claude Code en parallèle est l'un des plus grands gains de productivité que vous puissiez réaliser. Comme Claude est léger, vous pouvez facilement lancer plusieurs copies, attribuer à chacune une tâche différente, et les faire travailler simultanément. Cela vous donne en pratique une équipe d'ingénieurs logiciels virtuels travaillant sur votre projet.

Le défi : les conflits de fichiers

Le principal problème avec les instances parallèles est qu'elles peuvent essayer de modifier les mêmes fichiers en même temps. Cela peut entraîner du code conflictuel ou invalide, car chaque instance n'a pas connaissance de ce que font les autres.

Trois instances de Claude Code travaillant sur un même projet : « Add logging », « Support .pptx files », « Investigate failing test ».

La solution consiste à donner à chaque instance de Claude son propre espace de travail distinct. Chaque instance travaille avec sa propre copie de votre projet, effectue des modifications de manière isolée, puis fusionne ces modifications dans votre projet principal.

Quatre instances de Claude Code, chacune avec sa propre copie de votre projet, pour des tâches telles que « Define a resource » et « Add logging ».

Git Worktrees

Les worktrees Git sont parfaitement adaptés à ce flux de travail. Si votre projet est déjà géré par Git, vous pouvez utiliser les worktrees immédiatement. Ils constituent en quelque sorte une extension des fonctionnalités de branchement de Git, vous permettant de créer des copies complètes de votre projet dans des répertoires distincts sur votre machine.

Branche feature_a dans le dossier Un et feature_b dans le dossier Deux, chacune avec les mêmes main.py, tools/document.py et tools/math.py.

Chaque worktree correspond à une branche distincte. Vous pouvez avoir un dossier pour la fonctionnalité A et un autre pour la fonctionnalité B, chacun contenant une copie complète de votre base de code. Vous exécutez ensuite des instances distinctes de Claude Code dans chaque worktree, travaillant en isolation totale.

Diagramme des branches worktree feature_a et feature_b, chacune avec un commit, se fusionnant dans la branche principale.

Une fois que chaque instance de Claude a terminé sa fonctionnalité, vous validez le travail et le fusionnez dans votre branche principale, exactement comme vous le feriez pour fusionner n'importe quelle branche Git normale.

Requête pour créer un worktree nommé feature_a dans le dossier .trees, s'arrêter s'il existe, créer un lien symbolique vers .venv, et lancer VS Code.

Automatiser la création de worktrees

Cela peut sembler compliqué à gérer, mais vous pouvez déléguer l'ensemble du flux de travail à Claude Code lui-même. Vous pouvez rédiger une requête demandant à Claude de :

  1. Créer un nouveau worktree Git dans un dossier spécifique
  2. Créer des liens symboliques pour les dépendances qui ne sont pas suivies par Git
  3. Lancer une nouvelle instance de VS Code dans ce répertoire

Requête pour créer un worktree nommé feature_a dans .trees : s'arrêter s'il existe, créer un lien symbolique vers .venv, lancer VS Code avec « code ».

Commandes personnalisées

Plutôt que de copier-coller de longues requêtes à chaque fois, vous pouvez créer des commandes slash personnalisées dans Claude Code. Ajoutez un fichier .md à .claude/commands pour créer une commande personnalisée.

Une seconde fenêtre VS Code nommée feature_a, exécutant Claude Code dans la copie worktree des fichiers du projet.

La commande personnalisée peut référencer $ARGUMENTS, qui est remplacé par les arguments que vous transmettez à votre commande. Par exemple :

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

Le développement parallèle en action

Voici à quoi ressemble le flux de travail complet en pratique. Vous pouvez créer plusieurs worktrees pour différentes fonctionnalités :

Quatre fenêtres VS Code avec les mêmes fichiers de projet, intitulées « Document tests », « Add Logging », « Add notes tool », « Add math tool ».

Chaque instance de Claude travaille sur la tâche qui lui est assignée :

  • Mettre à jour les tests de documentation
  • Ajouter la journalisation
  • Ajouter des outils de prise de notes
  • Ajouter un outil de soustraction

Requête pour fusionner le worktree $ARGUMENTS dans .trees/$ARGUMENTS, en utilisant des commandes telles que « git status » pour lister les conflits de fusion.

Fusionner les modifications

Une fois les fonctionnalités terminées, vous pouvez également automatiser le processus de fusion. Créez une autre commande personnalisée qui demande à Claude de :

  1. Se déplacer 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 conflits de fusion

VS Code avec create_worktree.md et merge_worktree.md dans .claude/commands, et Claude Code exécuté dans le terminal.

Claude peut même résoudre les conflits de fusion automatiquement, en se basant sur sa compréhension des modifications effectuées dans chaque branche.

Résultats

Cette approche s'adapte à autant d'instances parallèles que vous pouvez en gérer. Plutôt que de travailler sur les fonctionnalités de manière séquentielle, vous pouvez avoir plusieurs instances de Claude développant différentes parties de votre projet simultanément. C'est comme avoir votre propre équipe de développeurs, chacun travaillant dans son propre environnement isolé avant de réunir leur travail.

Les gains de productivité sont considérables : vous multipliez essentiellement votre capacité de développement par le nombre d'instances parallèles que vous exécutez.