Lancer plusieurs agents Claude Code en parallèle

Un agent, c’est utile. Trois agents sur des tâches séparées pendant que vous relisez le diff du premier, c’est là que les agents en terminal deviennent vraiment rentables. Mais ça dérape vite : deux agents qui modifient le même fichier, des serveurs de dev qui se disputent un port, ou une limite d’utilisation atteinte au milieu de l’après-midi.

Ce guide présente une configuration qui évite ces problèmes. Si vous préférez qu’un agent répartisse et relise le travail à votre place, voir Faire travailler une équipe d’agents IA de code. Elle fonctionne avec Claude Code, Codex, Gemini CLI et n’importe quelle autre CLI d’agent.

En bref

1. Donnez à chaque agent sa propre tâche et, s’il modifie du code, sa propre copie de travail (un git worktree).
2. Gardez tous les agents d’un projet visibles dans une seule grille, pour remarquer quand l’un d’eux a besoin de vous.
3. Utilisez un deuxième agent comme relecteur, pas comme second auteur du même code.
4. Surveillez vos limites d’utilisation, car des agents en parallèle les consomment en parallèle.

Étape 1 : découper le travail en tâches indépendantes

Les agents en parallèle fonctionnent quand leurs tâches ne touchent pas les mêmes fichiers. De bons découpages :

• Une fonctionnalité dans une partie du code et un correctif de bug dans une autre
• Implémenter un changement et écrire des tests pour du code existant
• Un agent qui code, un autre qui rédige la doc ou un plan de migration
• De la recherche ou de la lecture de code, qui ne modifie rien

Les mauvais découpages : deux agents sur le même composant, ou un agent qui refactorise du code qu’un autre est en train d’étendre. Si vous ne pouvez pas décrire les fichiers de chaque tâche sans chevauchement, lancez-les plutôt l’une après l’autre.

Étape 2 : un worktree par agent qui code

Deux agents dans le même dossier partagent un seul arbre de travail. Quand les deux modifient, vous obtenez des changements à moitié appliqués, des conflits surprises et des diffs impossibles à attribuer. La solution : un git worktree par tâche, c’est-à-dire une seconde extraction du même dépôt dans son propre dossier, sur sa propre branche.

git worktree add ../atlas-auth -b feat/auth
git worktree add ../atlas-search -b feat/search

Chaque agent tourne alors dans son propre dossier, et vous fusionnez les branches une fois le travail fini. Claude Code peut aussi tout faire en une étape avec claude --worktree feature-auth. Notre guide git worktree pour Claude Code et Codex détaille tout, y compris les dépendances, les fichiers .env et le nettoyage.

Les agents en lecture seule (relecture, recherche, questions sur la doc) peuvent partager le dossier principal.

Étape 3 : tous les agents sur un seul écran

Avec des agents en parallèle, le problème habituel n’est pas le code, c’est l’attention. Un agent demande une autorisation dans un onglet en arrière-plan et attend vingt minutes.

Dans Vibe Console, chaque projet peut avoir jusqu’à 10 terminaux, en onglets ou en grille de 1×2 à 3×3. Une disposition efficace pour trois agents :

Chaque terminal peut lancer un agent différent : choisissez-en un à côté du bouton Lancer et appuyez sur ⌘K. Pour démarrer un agent dans un worktree, faites d’abord un cd dedans ; vous pouvez glisser un worktree depuis le panneau Contrôle de source sur un terminal pour coller son chemin. Renommez les terminaux (Renommer…) d’après leur tâche : la grille se lit alors comme une liste de tâches.

Chaque onglet affiche une pastille qui indique si son agent travaille ou attend. Quand un agent termine, ou s’arrête pour attendre votre réponse, l’app joue un son et ouvre l’encoche sur la session : vous pouvez regarder ailleurs. Voir Notifications Claude Code sur Mac pour le détail et une alternative gratuite à base de hooks.

Étape 4 : un deuxième agent comme relecteur

Des modèles différents repèrent des erreurs différentes. Une méthode simple et efficace :

1. Claude Code implémente un changement dans son worktree.
2. Quand il a fini, lancez Codex (ou une autre session Claude Code) dans le même dossier avec un prompt de relecture enregistré, par exemple : « Relis le diff non commité pour trouver les bugs, les tests manquants et les problèmes de sécurité. Ne modifie aucun fichier ; liste les problèmes avec le fichier et la ligne. »
3. Recollez les remarques dans le premier agent.

Enregistrez le prompt de relecture une fois dans les Prompts enregistrés (⌘⇧S) et collez-le en un clic dans n’importe quel terminal.

Étape 5 : surveiller vos limites d’utilisation

Les forfaits Claude Code et Codex mesurent l’utilisation par fenêtres, dont une fenêtre glissante de 5 heures et une limite hebdomadaire. Trois agents la consomment à peu près trois fois plus vite, et atteindre une limite en pleine tâche laisse le travail à moitié fait.

Vibe Console affiche des anneaux de quota Claude Code et Codex dans l’encoche et la barre d’outils des terminaux, avec l’heure de réinitialisation, et vous prévient à 80 % et à 100 %. Notre guide des limites d’utilisation de Claude Code explique les fenêtres et comment vous organiser autour.

Étape 6 : fusionner et nettoyer

Quand une tâche est terminée :

1. Relisez le diff de la branche (Contrôle de source, ⌘⇧G).
2. Lancez les tests dans ce worktree.
3. Fusionnez la branche, puis supprimez le worktree (Supprimer le worktree dans le contrôle de source, ou git worktree remove ../atlas-auth).

Combien d’agents, c’est trop ?

Pour la plupart des gens, deux ou trois agents qui codent plus un relecteur, c’est le maximum utile. Au-delà, c’est la relecture qui devient le goulot d’étranglement, pas les agents. N’ajoutez d’agents en parallèle que pour des tâches indépendantes, bien spécifiées et couvertes par de bons tests.

FAQ

Peut-on faire tourner Claude Code et Codex sur le même projet en même temps ?

Oui. Donnez à chacun son propre worktree si les deux modifient du code, ou gardez l’un des deux dans un rôle de relecteur en lecture seule.

Les sessions Claude Code en parallèle partagent-elles le contexte ?

Non. Chaque session a sa propre conversation. Partagez les décisions via des fichiers que les agents lisent, comme CLAUDE.md, AGENTS.md ou des notes de projet.

Faire tourner des agents en parallèle coûte-t-il plus cher ?

Cela consomme plus vite les limites de votre forfait, puisque chaque agent consomme de son côté. La quantité totale de travail est comparable ; elle est simplement faite en moins de temps.

Prêt à essayer ? Téléchargez Vibe Console, gratuit pendant 14 jours.