Comment faire tourner plusieurs agents Claude Code à la fois

Quatre façons de faire tourner des agents Claude Code en parallèle

Subagents : des assistants en parallèle dans une seule session

Un subagent a sa propre fenêtre de contexte, son propre prompt système et ses propres outils. Il ne voit pas votre conversation, et seul son résumé revient, ce qui garde le contexte de la session principale léger. Claude Code en fournit de base, comme Explore (lecture seule) et Plan, et vous pouvez ajouter les vôtres.

1. Définissez un subagent

   Créez un fichier Markdown dans .claude/agents/ (partagé avec le projet) ou ~/.claude/agents/ (pour vous seul). Seuls name et description sont obligatoires ; tools limite ce qu’il peut utiliser et model choisit le modèle.

   ---
   name: code-reviewer
   description: Reviews code for quality and best practices
   tools: Read, Glob, Grep
   model: sonnet
   ---
   
   You are a code reviewer. When invoked, analyze the code and give
   specific, actionable feedback on quality, security and best practices.

2. Laissez Claude en lancer plusieurs à la fois

   Demandez le travail en parallèle, par exemple « relis les modules auth, billing et search en parallèle ». Les subagents que Claude crée démarrent en arrière-plan par défaut, jusqu’à 20 à la fois, et rendent compte quand ils ont fini. Tapez /tasks pour les voir.

3. Donnez leur propre worktree aux subagents qui modifient des fichiers

   Ajoutez isolation: worktree au frontmatter du subagent, ou demandez à Claude d’utiliser des worktrees pour ses agents. Chacun modifie alors une copie temporaire du dépôt, supprimée s’il n’a fait aucune modification.

Lancer des sessions Claude Code en parallèle dans des worktrees git

1. Ignorez le dossier des worktrees

   Claude Code crée les worktrees dans .claude/worktrees/ à la racine du dépôt. Le dépôt doit contenir au moins un commit.

   echo ".claude/worktrees/" >> .gitignore

2. Lancez une session par tâche

   Dans chaque terminal, lancez claude --worktree (ou -w) avec un nom différent. Chacune obtient son propre dossier et une branche nommée worktree-<name>, créée à partir de la branche par défaut.

   # terminal 1
   claude --worktree feature-auth
   
   # terminal 2
   claude --worktree bugfix-login

3. Copiez les fichiers non suivis dont vous avez besoin

   Un nouveau worktree ne contient que les fichiers suivis. Listez des fichiers comme .env dans un fichier .worktreeinclude (syntaxe gitignore) et Claude Code les y copie.

   .env
   .env.local

4. Fusionnez et faites le ménage

   À la fin d’une session, un worktree sans modifications est supprimé avec sa branche ; s’il contient des modifications, Claude Code demande s’il faut le garder. Fusionnez les branches comme n’importe quelle autre. Les exécutions headless -p ne posent pas la question : supprimez-les avec git worktree remove.

5. Ou utilisez l’app de bureau

   Appuyez sur Cmd+N (Ctrl+N sous Windows) pour une nouvelle session et activez Worktree avant de la démarrer ; l’option est désactivée par défaut. Les sessions peuvent s’afficher côte à côte en vue partagée.

Source : documentation d’Anthropic sur les worktrees

Sessions en arrière-plan avec --bg et agent view

claude --bg "<prompt>" lance une session en arrière-plan et rend la main immédiatement : vous pouvez en lancer plusieurs à la suite. Chacune passe dans son propre worktree avant de modifier quoi que ce soit. claude agents les liste ; claude logs <id>, claude attach <id> et claude stop <id> gèrent une session.

Elles continuent après la fermeture du terminal, mais pas après l’extinction de l’ordinateur. Agent view est en research preview. Pour en savoir plus sur les exécutions sans surveillance, voir comment lancer des agents Claude Code en arrière-plan.

Agent teams : des agents qui se parlent

Les agent teams sont expérimentales et désactivées par défaut. Activez-les avec CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 dans votre shell ou dans le bloc env de settings.json, puis demandez à Claude de « créer trois coéquipiers » pour une tâche. Les coéquipiers partagent une liste de tâches et s’envoient des messages ; ils s’affichent dans le terminal, ou dans des panneaux séparés avec tmux ou iTerm2.

• Sessions interactives uniquement : -p et l’Agent SDK ne créent pas de coéquipiers.
• Une équipe par session, pas d’équipes imbriquées, et les coéquipiers in-process ne sont pas restaurés par /resume.
• Les coéquipiers partagent une seule copie de travail : donnez à chacun un ensemble de fichiers différent.
• Elles coûtent bien plus cher : selon la documentation d’Anthropic, une équipe consomme environ 7 fois plus de tokens qu’une session seule quand les coéquipiers tournent en plan mode.

Éviter que des agents en parallèle s’écrasent mutuellement

• Si deux agents risquent de toucher les mêmes fichiers, donnez à chacun son propre worktree. Une session dans un worktree ne peut pas modifier la copie de travail principale, et ses subagents non plus.
• Dans une agent team, répartissez le travail par fichiers : deux coéquipiers qui modifient le même fichier s’écrasent mutuellement.
• Chaque subagent et chaque session puisent dans les mêmes limites d’utilisation : en faire tourner plusieurs multiplie la consommation. Utilisez model: haiku pour les subagents simples.
• Des agents qui lancent les mêmes tests ou le même serveur de développement peuvent entrer en conflit sur les ports ; donnez à chacun son propre port.

Faites de vos agents en parallèle une équipe avec des postes

Les worktrees et les agent teams découpent une tâche que vous surveillez. Crewmark fait tourner plusieurs sessions Claude Code ou Codex comme des employés, chacun avec son rôle, ses objectifs et ses horaires de travail, et leur confie du travail sur un seul tableau.

1. Un employé par rôle

   Un spécialiste SEO, un ingénieur logiciel et un designer UI vivent chacun dans leur propre conversation, avec leurs propres instructions et leur propre objectif.

2. Un seul tableau pour tous

   Assignez les tickets à l’employé le plus adapté. Chacun se réveille à sa pulsation, prend son ticket suivant et commente au fil de l’eau : vous voyez qui fait quoi.

3. Ils vous sollicitent, vous, pas les uns les autres

   Quand un employé a besoin d’une relecture ou d’une autorisation, il vous écrit et passe à autre chose. Lisez ce qu’est un employé IA.

FAQ : plusieurs agents Claude Code