Accueil / Plusieurs agents et vérification adverse

Isoler et exécuter en tâche de fond : worktrees et boucle à sec

Un worktree git par agent évite que les fichiers de plusieurs agents parallèles entrent en collision, une boucle à sec répète jusqu'à ce qu'un cycle ne renvoie plus rien de nouveau en s'appuyant sur un ensemble déjà vu, et depuis le 13 août 2026 un agent non coéquipier lancé en session interactive tourne par défaut en arrière-plan avec notification à la fin plutôt que de bloquer la session.

Un agent qui écrit dans le même dépôt qu'un autre agent, au même moment, risque d'écraser ce que l'autre vient de produire. La parade documentée par Claude Code consiste à donner à chaque agent parallèle sa propre copie temporaire du dépôt, un worktree git, en ajoutant isolation: worktree dans son en-tête de configuration. Chaque agent travaille alors dans sa propre copie, et cette copie se nettoie automatiquement d'elle même quand l'agent n'a rien modifié.

Une boucle qui sait s'arrêter

Un second geste répond à un problème différent, une recherche qui ne sait pas quand elle a fini de trouver. La documentation officielle décrit ce motif pour repérer des tests instables : relancer la suite plusieurs fois, noter quels tests échouent de façon intermittente, et s'arrêter dès que deux passages consécutifs ne signalent plus rien de nouveau. Le même principe s'applique à toute recherche exhaustive, un audit de dépendances, un inventaire de fichiers orphelins : chaque cycle compare son résultat à l'ensemble déjà connu, et seul un élément absent de cet ensemble compte comme une nouveauté pour ce tour.

Cycle 1 : 4 elements trouves, 4 nouveaux, ensemble connu = 4
Cycle 2 : 5 elements trouves, 1 nouveau, ensemble connu = 5
Cycle 3 : 5 elements trouves, 0 nouveau
Cycle 4 : 5 elements trouves, 0 nouveau, deux tours sans nouveaute, la boucle s'arrete

Le changement du 13 août 2026

La bascule vers l'arrière-plan n'est pas un réglage qu'on active, c'est devenu le comportement par défaut. Depuis la version 2.1.232 de Claude Code, publiée le 13 août 2026, un agent qui n'est pas coéquipier de la session et qui démarre pendant une session interactive tourne en arrière-plan au lieu de bloquer la conversation en cours ; le journal des versions ne précise pas s'il prévient par une notification à la fin, ce point reste à vérifier soi même. Le même journal place ce changement dans la même entrée que l'activation par défaut du mode qui fait hériter un sous-agent du cache et de la conversation complète, reliés par un simple et : il n'établit aucun lien de cause à effet entre les deux, ce sont deux changements simultanés de la même version, pas un mécanisme qui en déclenche un autre.

Isolation par worktree et exécution en arrière-plan se combinent naturellement : plusieurs agents lancés en parallèle, chacun dans sa propre copie du dépôt, tournent désormais sans bloquer la session pendant qu'ils travaillent. La leçon précédente sur le choix de l'architecture détermine s'il faut lancer ces agents en parallèle, celle-ci détermine comment les faire cohabiter sans collision. La leçon suivante traite ce qui se passe quand leur nombre dépasse une poignée.

Un détail change la fiabilité de la boucle à sec : le compte de nouveautés se calcule contre l'ensemble cumulé depuis le premier cycle, jamais contre le seul cycle précédent. Un élément qui disparaît puis réapparaît au cycle suivant ne doit pas être recompté comme nouveau, sous peine de faire tourner la boucle indéfiniment sur un résultat instable plutôt que sur une recherche réellement incomplète.