Comment exécuter plusieurs agents de codage IA en parallèle avec les git worktrees

L'un des plus grands changements du développement assisté par IA tout au long de 2026 est que vous ne pointez plus un seul agent vers une seule tâche. Des outils comme Claude Code et Cursor encouragent désormais à exécuter plusieurs agents en parallèle — l'un corrigeant un bug, un autre écrivant des tests, un troisième esquissant une fonctionnalité. Le hic : s'ils modifient tous le même répertoire de travail, ils écrasent mutuellement leurs changements et corrompent la compilation.

La solution propre est une vieille fonctionnalité de Git qui s'avère être la primitive parfaite pour cela : les worktrees.

Ce qu'est réellement un worktree

Normalement, un dépôt Git a un seul répertoire de travail — le dossier dans lequel vous modifiez les fichiers. git worktree permet à un même dépôt d'avoir plusieurs répertoires de travail à la fois, chacun avec une branche différente extraite, tous partageant le même historique .git sous-jacent. Chaque worktree est un vrai dossier sur le disque avec ses propres fichiers, donc un agent travaillant dans l'un ne peut pas toucher aux fichiers d'un autre.

Voyez-le comme donner à chaque agent son propre bureau dans le même open space, au lieu de trois personnes se disputant un seul clavier.

Le workflow de base

Depuis l'intérieur de votre dépôt, créez un worktree pour chaque tâche sur sa propre branche :

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

Vous avez maintenant deux dossiers frères à côté de votre dépôt principal : myapp-auth-fix et myapp-search. Ouvrez une session d'agent séparée dans chacun — cd ../myapp-auth-fix et lancez Claude Code là-bas, puis faites de même dans ../myapp-search dans un autre onglet de terminal. Chaque agent dispose d'une extraction complète et indépendante. Ils s'exécutent en même temps, commitent sur leurs propres branches, et n'entrent jamais en collision.

Lorsqu'une tâche est terminée, fusionnez sa branche et supprimez le worktree pour garder les choses propres :

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

Un exemple concret

Disons que vous construisez une petite application web et que vous avez trois tâches indépendantes : corriger une redirection de connexion instable, ajouter la pagination à une liste, et mettre à jour une dépendance lente. Au lieu de les faire une par une :

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

Lancez un agent dans chaque dossier avec un prompt ciblé. Pendant que l'agent de connexion retrace la logique de redirection, l'agent de pagination écrit déjà des composants, et l'agent de dépendances exécute la mise à jour et la suite de tests. Vingt minutes plus tard, vous relisez trois branches distinctes et propres et fusionnez celles qui passent.

Des conseils pour rester sain d'esprit

• Gardez les tâches indépendantes. Les worktrees empêchent les conflits de fichiers, mais si deux agents modifient les mêmes fichiers sur des branches différentes, vous heurterez tout de même des conflits de fusion à la fin. Découpez le travail selon des coutures naturelles.
• Donnez à chaque worktree le même contexte. Un CLAUDE.md (ou fichier de règles équivalent) commité dans votre dépôt voyage automatiquement dans chaque worktree, donc chaque agent hérite de vos conventions.
• Surveillez les dossiers de dépendances. node_modules, les environnements virtuels et les caches de compilation ne sont pas partagés entre worktrees. Vous devrez peut-être exécuter npm install une fois par worktree, ou utiliser un gestionnaire de paquets doté d'un magasin global (pnpm, uv) pour éviter de tout retélécharger.
• Ne sur-parallélisez pas. En pratique, trois à cinq agents simultanés sont le point idéal. Au-delà, le temps passé à relire et coordonner l'emporte sur la vitesse gagnée.

Des intégrations natives des worktrees arrivent dans les principaux outils depuis fin 2025, et des lanceurs dédiés existent désormais pour démarrer les sessions à votre place. Mais vous n'avez besoin d'aucun d'eux pour commencer — git worktree add est intégré à Git, fonctionne dès aujourd'hui, et reste la manière la plus fiable de laisser plusieurs agents IA construire pour vous à la fois sans qu'ils ne se gênent.