Évaluation: "5 Claude Code Worktree Tips from Creator" - Reddit/Twitter

Date d'évaluation: 2026-02-22 Évaluateur: Claude Code (auto) Ressource: Reddit r/ClaudeAI + Tweet Boris Cherny (@bcherny)

Métadonnées

📄 Résumé du contenu

• Annonce officielle: claude --worktree / -w flag désormais disponible en CLI (existait en Desktop, maintenant porté en CLI)
• Modèle concurrent natif: Chaque agent obtient son propre worktree isolé, pas d'interférence entre sessions parallèles
• Patterns communautaires validés: Per-worktree port management (scripts, docker-compose override, ports aléatoires), per-worktree .claude/settings.json tuning, "main worktree as integration branch"
• Ressource externe identifiée: claude-worktree-hooks — port isolation automatique pour claude --worktree
• Débat worktrees vs multi-clone: Worktrees partagent le même objet git (branches, commits, moins de disk), mais multi-clone reste valide pour équipes non-familières

🎯 Score de pertinence

Score: 4/5

Justification: Trois facteurs convergents :

1. Gap documenté: claude --worktree / -w est dans claude-code-releases.md (v2.1.49) mais absent du guide principal (section 13408) qui couvre encore uniquement le git worktree add manuel
2. Patterns actionnables manquants: port management, per-worktree settings.json tuning, integration branch pattern — rien de cela dans le guide
3. Source primo-autoritaire: Boris Cherny est le créateur de Claude Code → contenu directement pertinent, pas de filtre communautaire non vérifié

⚖️ Comparatif

📍 Recommandations d'intégration

Score ≥ 3 → Intégrer

Action unique recommandée

Fichier: guide/ultimate-guide.md Section: 13408 - "Git Worktrees for Parallel Development" Priorité: Haute (dans la semaine — le flag date du 2026-02-20)

Contenu à ajouter (~30-40 lignes) :

#### Using the `--worktree` CLI Flag (v2.1.49+)

Since v2.1.49, Claude Code includes built-in worktree support:

Create an isolated worktree automatically

claude --worktree # or -w (short form)

Equivalent manual setup

git worktree add ../myproject-feature feature-a && cd ../myproject-feature && claude

**What `--worktree` does**: Creates a temporary git worktree, launches Claude in it,
and cleans up on exit if no changes were made.

**Practical patterns:**

**Port isolation** (when services need to run per worktree):
- Use docker-compose override files auto-generated at worktree creation
- Assign random ports dynamically and inject via env variables
- See [claude-worktree-hooks](https://github.com/tfriedel/claude-worktree-hooks) for port automation

**Per-worktree behavior tuning:**

In each worktree, create a .claude/settings.json

Tighter permissions for refactoring worktrees, looser for exploration

**Integration branch pattern:**
Keep one 'main' worktree as your integration branch.
Only merge into it from parallel worktrees — never develop directly there.

Ne pas créer de section séparée pour claude-worktree-hooks — juste une note de bas de section.

🔥 Challenge (technical-writer agent)

Score 4/5 justifié, mais pour la mauvaise raison. L'argument "créateur = autorité" est biaisé — c'est la convergence (gap documenté + patterns actionnables vérifiables via release v2.1.49 + communauté) qui justifie le score.

Plan d'intégration initial trop dispersé (3 points d'entrée). Bonne simplification : une seule extension de la section 13408.

Risque de non-intégration : modéré. Le flag est dans les releases (trouvable), mais la section 13408 devient incohérente si elle n'inclut pas la commande native — elle enseigne encore uniquement le git manuel alors que la feature native existe depuis 2 jours.

• Score ajusté: 4/5 (confirmé)
• Points manqués: Source primaire = changelog v2.1.49, pas le tweet (le tweet disparaît, le changelog reste)
• Risques de non-intégration: Incohérence interne (section 13408 outdated vs releases.md à jour)

✅ Fact-Check

Corrections apportées: Aucune (aucune stat inventée)

Stats nécessitant vérification externe avant intégration: Les repos GitHub (claude-worktree-hooks, workmux) — vérifier existence + activité avant de les mentionner dans le guide.

🔗 Sources complémentaires

Clarification versions (Guillaume attribue tout à v2.1.50, incorrect) :

• --worktree CLI + isolation: "worktree" subagents → v2.1.49
• WorktreeCreate/WorktreeRemove hooks + déclaratif agent defs → v2.1.50

🎯 Décision finale

• Score final: 4/5
• Action: Intégrer
• Délai recommandé: Dans la semaine (feature sortie le 2026-02-20)
• Effort estimé: ~50-60 lignes dans la section 13408 + ~10 lignes section hooks
• Confiance: Haute (confirmé dans nos propres release notes v2.1.49 + v2.1.50)

Périmètre d'intégration complet (après les deux évals)

1. Section 13408 — ajouter :
   • claude --worktree / -w native flag avec exemple
   • isolation: worktree déclaratif dans agent defs (YAML)
   • Subagents + worktrees pour migrations parallèles
   • Port management patterns (docker-compose override, random ports)
   • Per-worktree .claude/settings.json tuning
   • Integration branch pattern
   • Note Desktop + IDE support
2. Section hooks — ajouter WorktreeCreate/WorktreeRemove (non-git SCM use case)
3. Références externes : claude-worktree-hooks + article Guillaume Moigneu (à vérifier avant publication)