Faire travailler plusieurs agents Claude Code en même temps

Quand plusieurs agents valent la peine

Plusieurs agents aident quand le travail se découpe en morceaux indépendants. Ils compliquent tout quand chaque étape dépend de la précédente.

1. Une tâche claire par agent

Donne à chaque agent un objectif qu’il peut terminer seul, avec une fin que tu peux vérifier : « les tests du dossier paiement passent », « la page Tarifs affiche le nouveau prix ». Nomme les dossiers qu’il peut modifier et ceux qu’il ne doit pas toucher.

Un objectif flou produit des agents qui se marchent dessus. Un objectif précis se relit en 2 minutes.

2. Un dossier de travail par agent : les worktrees git

Deux agents dans le même dossier modifient les mêmes fichiers en même temps : l’un écrase le travail de l’autre, ou lit un fichier à moitié modifié. Git a un outil fait pour ça : git worktree. Un worktree est une copie de travail de ton dépôt, dans son propre dossier et sur sa propre branche, avec le même historique.

Le plus simple : laisse Claude Code le créer

Les versions récentes de Claude Code savent créer le worktree elles-mêmes avec l’option --worktree (ou -w) et un nom de tâche :

claude --worktree correctif-paiement

Claude Code crée le dossier .claude/worktrees/correctif-paiement/ sur une nouvelle branche worktree-correctif-paiement, et y lance l’agent. Relance la même commande avec un autre nom dans un second terminal : tu as un second agent isolé du premier. Ajoute .claude/worktrees/ à ton .gitignore. À la sortie, Claude Code te propose de garder ou de supprimer le worktree.

Ou à la main, avec git

Tu peux aussi créer les worktrees toi-même, par exemple pour les ranger hors du projet :

# depuis le dossier de ton projet
git worktree add -b agent-tests ../mon-projet-tests
git worktree add -b agent-docs ../mon-projet-docs
git worktree list

Lance ensuite un agent dans chaque dossier : cd ../mon-projet-tests puis claude. Quand un agent a terminé, relis ses changements, fusionne sa branche depuis ton dossier principal, puis supprime le worktree :

# relire ce que l’agent a changé
git diff main...agent-tests
# fusionner sa branche
git merge agent-tests
# supprimer le worktree devenu inutile
git worktree remove ../mon-projet-tests

Remplace main par le nom de ta branche principale. Un worktree est une copie neuve : les fichiers que git ne suit pas, comme .env, n’y sont pas, et il faut réinstaller les dépendances (par exemple npm install) dans chaque dossier. Avec --worktree, un fichier .worktreeinclude à la racine du projet liste les fichiers ignorés par git à copier automatiquement dans chaque nouveau worktree. Les détails sont dans la documentation officielle de Claude Code.

3. Des règles communes dans CLAUDE.md et AGENTS.md

Claude Code lit le fichier CLAUDE.md à la racine du projet, et Codex lit AGENTS.md. Mets-y ce que chaque agent doit savoir avant de commencer : comment lancer les tests, les conventions de code, ce qu’il ne faut jamais toucher. Tous partent alors avec les mêmes consignes, sans que tu les répètes.

Si ton projet n’a qu’un AGENTS.md, les versions récentes de Claude Code le lisent directement. Si tu as les deux fichiers, ajoute la ligne @AGENTS.md dans CLAUDE.md : Claude Code en importe alors le contenu, et tu n’as qu’un seul fichier à tenir à jour.

4. Garder le contrôle : permissions et relecture

• Commence prudent. Un nouvel agent démarre en lecture seule, ou en te demandant avant d’agir. Donne-lui plus d’autonomie quand tu as vu comment il travaille sur ce projet.
• Réserve le mode sans garde-fou aux copies jetables. Jamais sur un dossier dont tu as besoin tel quel.
• Relis avant de fusionner. Regarde le diff et lance les tests de la branche. Un agent sûr de lui peut avoir tort.
• Fais relire par un autre agent. Un relecteur qui n’a pas le contexte de l’auteur voit ce que l’auteur ne voit plus.

5. Suivre qui fait quoi

Avec 3 terminaux ouverts, tu perds vite le fil : lequel attend ta permission ? lequel a terminé ? lequel tourne en rond ? Des onglets bien nommés et les notifications de ton terminal te mènent loin.

Claude Code a aussi sa propre vue d’ensemble : la commande claude agents ouvre, dans un seul terminal, tes sessions regroupées par état (en cours, en attente de ta réponse, terminées). Elle est encore en aperçu de recherche et ne couvre que Claude Code.

Plus tu ajoutes d’agents, plus il te faut une vue d’ensemble qui montre l’état de chacun, avec un seul endroit où répondre. C’est ce que fait Gestionnaire, pour Claude Code et pour Codex dans la même fenêtre.

Comment Gestionnaire s’y prend

Gestionnaire est une app Mac qui met ces réflexes en place sans que tu tapes les commandes. Elle ne remplace ni Claude Code ni Codex : elle les lance et les réunit dans une seule fenêtre, avec tes abonnements.

• De 1 à 6 agents en 1 clic, avec des préréglages Solo, Duo et Équipe.
• Un worktree par agent dans un dépôt Git : chacun travaille sur sa propre copie et sa propre branche, et ton dossier n’est pas touché.
• Un tableau de bord : qui travaille, qui attend ta réponse, qui a terminé.
• Lecture seule ou modification, au choix, agent par agent.
• Des messages entre agents, avec ton accord : tu vois l’expéditeur, le destinataire et le texte entier avant de choisir « Envoyer » ou « Refuser ».

La page Nouvelle session : préréglage, agent, permissions, nombre d’agents et isolation « Un worktree par agent ».

Pour la liste complète des fonctions, va sur la page d’accueil. Pour installer l’app et lancer ta première session, suis le guide des premiers pas.

Combien d’agents lancer à la fois

Commence avec 2 ou 3. Trois limites te rattrapent ensuite :

• Ton forfait. Tous les agents puisent dans le même quota d’usage : 4 agents l’épuisent plus vite qu’un seul.
• La mémoire de ton Mac. Chaque agent occupe plusieurs centaines de Mo.
• Ta capacité de relecture. C’est la vraie limite : un agent qui produit plus vite que tu ne relis ne t’avance pas.

Questions fréquentes