Sessions Claude Code en parallèle : isolation et handoff

Le parallélisme ne convient qu’aux tâches séparées. Si deux changements exigent le même fichier, un responsable unique le possède et le travail devient séquentiel. Pour un flux API séparé, le guide BetterToken pour Claude Code utilise votre propre API Key; BetterToken n’est ni un abonnement Claude.ai ni un compte partagé.

Cartographier les tâches

Tâche	Fichiers autorisés	Terminé quand
amount vide	parser/, tests/import/	test de validation réussi
--dry-run	cmd/, tests/cli/	plan affiché, aucune écriture

Un fichier commun impose l’arrêt ou un owner, jamais une extension silencieuse du périmètre.

Créer les worktrees

Vérifiez d’abord les modifications inconnues, sans les masquer ni les supprimer :

git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-run

Lancez Claude Code dans chaque dossier. Le worktree sépare fichiers et branches; la session sépare le contexte; aucun ne résout un conflit de fichier.

Donner un prompt borné

Indiquez dossiers autorisés, interdits et test : « travaille seulement dans parser/ et tests/import/, ne modifie pas le format CSV, reproduis puis vérifie la correction ». Si un chemin commun devient nécessaire, la session s’arrête et note le blocage.

Écrire le contrat de handoff

Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before merge

Transmettez l’état et la commande reproductible, pas le transcript.

Vérifier et revenir en arrière

git status --short
git diff --check
npm test -- tests/import/empty-amount.test.ts

La session suivante entre dans le worktree, compare les fichiers et relance la commande. Sans preuve verte, la modification reste non vérifiée : annulez-la ou rendez-la à son owner.

Conflits et secrets

Un owner lit les deux diffs en cas de chevauchement, porte le comportement voulu dans une branche et lance les deux tests. Ne donnez pas une permission générale d’écrire hors périmètre. API keys, cookies, .env, données personnelles et logs sensibles complets n’entrent ni dans le handoff ni dans le commit.

CTA et sources

Pour l’API, configurez seulement votre clé avec le guide BetterToken actuel et transmettez les secrets par le mécanisme prévu.

• Claude Code documentation
• Git worktree documentation