Aller au contenu
Mastering Claude

Accueil / Gestes courants

Gestes courants10 minApplication

Paralléliser : worktrees, modèle et mode rapide

Un git worktree isole une session parallèle sur sa propre branche, et le drapeau --worktree l'automatise désormais entièrement, là où seul le geste manuel git worktree add existait auparavant.

Un git worktree ouvre un second checkout du même dépôt, sur sa propre branche, dans un dossier séparé. Deux sessions Claude Code peuvent ainsi travailler en parallèle sans que l'une n'écrive dans les fichiers que l'autre a en cours de modification.

Le geste intégré nativement

Ce geste est aujourd'hui intégré nativement à Claude Code, sans qu'il faille appeler git worktree soi même pour le cas courant. La commande claude --worktree feature-auth (ou son alias court -w) crée automatiquement un worktree isolé sous .claude/worktrees/feature-auth/, sur une nouvelle branche nommée worktree-feature-auth, et démarre la session directement dedans.

claude --worktree feature-auth
# cree .claude/worktrees/feature-auth/ sur la branche worktree-feature-auth
# et demarre la session dans ce dossier

Le geste manuel, git worktree add, reste valide et nécessaire dans deux cas que le raccourci ne couvre pas : partir d'une branche existante précise, ou placer le worktree en dehors du dépôt. La reprise d'une session dans son worktree est automatique avec --continue, --resume et en mode interactif, et Claude peut lui même créer ou changer de worktree via un outil dédié, avec une confirmation demandée dès qu'il sort du dossier .claude/worktrees/.

Le modèle se choisit sur la difficulté, le mode rapide sur le coût

Dans chaque worktree, le choix du modèle reste indépendant : une tâche mécanique et répétitive va à un modèle léger, une tâche de jugement ou de vérification adverse va au modèle le plus capable. Le mode rapide, activé par /fast, est une préversion de recherche disponible seulement sur Opus 5 et Opus 4.8, absente de Sonnet, de Haiku, et désormais aussi d'Opus 4.7, où le support a été retiré après une période de dépréciation. Il accélère la vitesse de sortie jusqu'à 2,5 fois, à un tarif facturé séparément en crédits d'usage, dix dollars par million de jetons en entrée et cinquante en sortie, exactement le double du tarif standard d'Opus 5 et Opus 4.8, cinq dollars en entrée et vingt cinq en sortie sur la page de tarification Claude. Le mode reste hors de portée sur Bedrock, Vertex, Foundry et Claude Platform on AWS, et il exige des crédits d'usage activés sur le compte ; pour un forfait Team ou Enterprise, il reste désactivé par défaut tant qu'un titulaire du rôle Owner ne l'active pas pour l'organisation. Activer ce mode facture une fois le coût plein du contexte de conversation déjà accumulé, en jetons non mis en cache : ce coût est plus faible quand le mode rapide est activé dès le début d'une session, mais le désactiver puis le réactiver plus tard ne répète pas cette charge. Multiplier les sessions en worktrees multiplie donc aussi ce coût potentiel autant de fois qu'il y a de sessions où le mode rapide tourne en parallèle. La reprise d'une commande longue dans l'un de ces worktrees suit la même logique de tâche de fond que le mode headless et les tâches de fond.

Figure 1

Session unique contre session en worktree isolé

Isolement et coût d'une session parallèleIsolement du codeRisque de collision entre sessionsMise en place
Session unique dans le dépôt principalUne seule copie du code, tous les changements se mélangentDeux sessions sur le même dépôt écrivent dans les mêmes fichiersAucune commande supplémentaire
Session lancée avec claude --worktreeUn checkout isolé sous .claude/worktrees, sur sa propre brancheChaque session écrit dans son propre dossier, rien ne se croiseUne seule commande, la création de la branche et du dossier est automatique
La comparaison croise trois critères, isolement du code, risque de collision entre sessions et mise en place, entre une session unique dans le dépôt principal et une session lancée avec claude --worktree.
Calibrez vous-même

Une développeuse lance claude --worktree rapport-mensuel dans son dépôt, puis lance claude --worktree tableau-bord depuis une seconde fenêtre de terminal ouverte sur le même dépôt.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • claude --worktree (ou -w) crée et isole désormais automatiquement un checkout sur sa propre branche, là où seul le geste manuel git worktree add existait auparavant.
  • Le geste manuel git worktree add reste nécessaire pour partir d'une branche existante précise ou placer le worktree hors du dépôt.
  • --continue, --resume et le mode interactif reprennent automatiquement une session dans son propre worktree, sans commande supplémentaire.
  • Le mode rapide, activé par /fast, n'existe que sur Opus 5 et Opus 4.8, plus sur Opus 4.7 auparavant dont le support est désormais retiré, et facture le double du tarif standard, dix dollars en entrée et cinquante en sortie, sous condition de crédits d'usage activés et hors Bedrock, Vertex, Foundry et Claude Platform on AWS.
  • Activer le mode rapide dès le début d'une session facture un coût de contexte plus faible que l'activer en cours de route, mais le désactiver puis le réactiver plus tard ne répète pas cette charge.
À faire maintenant

Depuis un dépôt git existant sur votre poste, lancez claude --worktree essai-parallele dans un terminal, vérifiez que le dossier .claude/worktrees/essai-parallele/ est apparu sur sa propre branche, puis fermez cette session sans rien fusionner.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.