Worktrees et développement en parallèle
Travailler sur plusieurs fonctionnalités en même temps sans conflit
⏱ Estim. ~5 min
01 · Lire
Et si tu pouvais bosser sur deux fonctionnalités en même temps sans qu'elles se marchent dessus ? D'habitude ton projet a une seule branche et un seul jeu de fichiers. Tu es en plein milieu d'implémenter l'auth quand un gros bug arrive — il faut stash le travail, changer de branche, et tu perds ton rythme.
Les git worktrees règlent ça. Un worktree est un working directory séparé qui partage le même historique git que ton projet principal. Chaque worktree a sa propre branch et ses propres fichiers. Claude Code supporte les worktrees nativement — un seul flag suffit à lancer un espace de travail isolé.
💡 Imagine çaImagine un bureau avec deux tables au lieu d'une. Chaque table a sa propre copie des documents sur lesquels tu travailles, mais les deux sont reliées au même classeur (l'historique git). Tu peux bosser sur une fonctionnalité à la table 1 et fixer un bug à la table 2, sans jamais déplacer une feuille de papier entre les deux.
Points clés
- Un worktree est un working directory séparé qui partage le même repo git
- Chaque worktree a sa propre branch et ses propres fichiers
- Plus besoin de stash, de changer de branch et de perdre le rythme
- Claude Code crée le worktree automatiquement avec --worktree
02 · Exemple de code
Crée un worktree avec le flag --worktree. Chacun a sa propre branch et son propre répertoire.
Créer un worktree
# Start a Claude session in an isolated worktree
claude --worktree feature-auth
# Start another session for a bug fix
claude --worktree bugfix-login
# Auto-generate a random worktree name
claude --worktree
Ce qui se passe en coulisses
Worktree location: .claude/worktrees/feature-auth/
Branch created: worktree-feature-auth
Files: Full copy of your project
Git history: Shared with main repo
Chaque worktree a son propre répertoire dans .claude/worktrees/ et sa propre branch git. Deux sessions Claude peuvent éditer des fichiers en même temps sans conflit. À la fin, les worktrees sans modification sont nettoyés automatiquement.
03 · Lire
Les worktrees sont particulièrement puissants pour les sessions Claude en parallèle. Voici un flow typique :
1. Tu implémentes une fonctionnalité dans le répertoire principal 2. Un bug est signalé — claude --worktree bugfix-123 3. La session bugfix bosse dans sa propre copie en toute indépendance 4. Une fois fixé, tu merges la branch bugfix dans main 5. Tu continues ta fonctionnalité sans rater un seul battement
Tu peux aussi utiliser les worktrees à l'intérieur des subagents. Ajoute isolation: worktree au frontmatter du SKILL.md du subagent pour qu'il bosse automatiquement dans son propre worktree — parfait pour les tâches qui ont besoin d'éditer des fichiers sans toucher à ton working directory principal.
Points clés
- Lance plusieurs sessions Claude en parallèle, chacune dans son worktree
- Merge la branch du worktree à la fin
- Les subagents peuvent utiliser un worktree avec isolation: worktree
- Ajoute .claude/worktrees/ au .gitignore
04 · Lire
Pour les très gros changements — renommer une function dans 100 fichiers, ou migrer une API — Claude Code propose la commande /batch. Elle découpe ta tâche en unités indépendantes, génère un subagent pour chaque, et chacun bosse dans son propre worktree.
Chaque subagent crée une draft pull request pour sa portion. Tu reviews, tu merges les bonnes, tu itères sur les autres. C'est comme ça que les pros gèrent les gros refactors — découper en blocs indépendants et reviewables.
Points clés
- /batch découpe les grosses tâches en unités indépendantes
- Chaque unité dans son propre worktree avec son propre subagent
- Chacune crée une draft PR pour la review
- Parfait pour les gros refactors et migrations
05 · Quiz
Que se passe-t-il quand une session worktree Claude se termine sans modifications non commitées ?
- Le worktree est nettoyé automatiquement
- Le worktree reste là jusqu'à ce que tu le supprimes manuellement
- Claude te demande de commit avant de fermer
- Le worktree est déplacé dans un répertoire de backup
06 · Glisser pour trier
Mets ces étapes du flow worktree en parallèle dans le bon ordre.
(Cette section est interactive — active JavaScript pour l'utiliser.)
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.