Paralléliser Claude Code

Un agent qui code multiplie votre effort ; plusieurs en même temps forment une équipe. Lancer plusieurs sessions de Claude Code en parallèle, chacune sur sa tâche, est l’un des gains les plus nets qu’offre l’outil : une fonctionnalité ici, un refactoring là, des tests ailleurs. Votre rôle change : moins de frappe, plus de découpage et de relecture.

Le problème : deux sessions, un même dossier

Deux sessions qui travaillent dans le même dossier finissent par modifier les mêmes fichiers, chacune sans savoir ce que fait l’autre. La solution est l’isolation : chaque session travaille sur sa propre copie du projet, et les travaux se rejoignent à la fin, par une fusion contrôlée.

Les worktrees Git

Git fournit exactement cela : un worktree est une copie de travail séparée du dépôt, sur sa propre branche. Claude Code les crée lui-même :

# Terminal 1
claude --worktree feature-auth

# Terminal 2
claude --worktree bugfix-123

Chaque session démarre dans <dépôt>/.claude/worktrees/<nom>, sur une branche dédiée. Les deux sessions ne peuvent pas se marcher dessus, et chaque branche se fusionne ensuite avec les outils habituels de l’équipe : commit, revue, fusion. Le dépôt doit avoir au moins un commit.

Deux précautions :

• un worktree est une copie neuve : les dépendances (node_modules, environnement Python) et les fichiers ignorés par Git, comme un .env, n’y sont pas. Faites installer les dépendances par Claude, ou listez les fichiers à recopier dans un fichier .worktreeinclude ;
• en quittant une session, Claude vérifie s’il reste du travail non commité ; si oui, il vous demande de garder ou de supprimer le worktree.

Le cours officiel créait ces worktrees à la main, dans un dossier .trees/, avec des commandes personnalisées. L’option --worktree fait aujourd’hui le même travail, en une commande.

Automatiser un rituel : les skills

Ce qui se répète gagne à devenir une commande. Un fichier .claude/skills/<nom>/SKILL.md crée une commande /<nom> ; l’ancien format, un fichier .claude/commands/<nom>.md, fonctionne encore, et la documentation l’a fusionné avec les skills. Le texte du fichier est le prompt de l’opération, et $ARGUMENTS y reçoit ce que vous tapez après la commande :

---
description: Fusionne la branche d'un worktree dans main après vérification des tests
---
Fusionne la branche $ARGUMENTS dans main. Lance d'abord les tests sur la branche ;
s'ils échouent, arrête-toi et résume les échecs. En cas de conflit, explique
l'intention de chaque version avant de proposer une résolution.

On l’appelle ensuite par /merge-worktree feature-auth. Le prompt est écrit et soigné une fois, puis rejoué en une ligne.

Le cycle de développement parallèle

1. Découper le travail en tâches indépendantes.
2. Lancer une session par tâche, chacune dans son worktree.
3. Laisser les sessions travailler, en répondant à leurs demandes d’autorisation.
4. Relire et commiter chaque branche.
5. Fusionner dans la branche principale ; Claude peut aider à résoudre les conflits en lisant les deux versions.

La limite n’est plus la vitesse d’écriture du code : c’est la clarté de vos découpages et votre capacité à relire. Les agents produisent en parallèle ; vous restez le point de convergence qui découpe, arbitre et valide.

À vous de jouer

Deux sessions en parallèle. Dans un dépôt qui a au moins un commit, lancez deux sessions avec claude --worktree, l’une pour une petite fonctionnalité, l’autre pour des tests manquants. Une fois les deux terminées, relisez chaque branche, fusionnez-les, puis écrivez un skill qui automatise la vérification avant fusion.

Sources officielles : Worktrees (documentation Claude Code : --worktree, .worktreeinclude, nettoyage) · Common workflows (documentation Claude Code : sessions parallèles) · Skills (documentation Claude Code : commandes personnalisées fusionnées dans les skills)

Points clés à retenir

• Plusieurs sessions en parallèle forment une équipe ; votre rôle devient le découpage et la relecture.
• Une session par worktree : claude --worktree <nom> crée la copie et la branche dans .claude/worktrees/.
• Un worktree est une copie neuve : dépendances à installer, fichiers ignorés à recopier par .worktreeinclude.
• Les skills, ou les anciens fichiers de .claude/commands/, transforment un rituel en commande, avec $ARGUMENTS.
• La limite d’échelle : la clarté des tâches et la capacité de relecture.