Agent teams Claude Code vs subagents : quand utiliser chacun, et comment monter une équipe

Agent teams vs subagents

Les deux exécutent du travail en parallèle dans des fenêtres de contexte séparées. La différence tient à qui coordonne : avec les subagents, l’agent principal gère tout ; dans une équipe, les coéquipiers prennent des tâches dans une liste partagée et se parlent entre eux.

Quand utiliser les agent teams (et quand s’en passer)

• Recherche et revue : les coéquipiers examinent un problème sous différents angles, puis remettent en question les conclusions des autres.
• Nouveaux modules ou fonctionnalités : chaque coéquipier prend en charge une partie distincte, comme le frontend, le backend et les tests.
• Débogage avec des hypothèses concurrentes : plusieurs coéquipiers cherchent chacun à prouver leur théorie et à réfuter celles des autres.
• Pas pour du travail séquentiel, des modifications des mêmes fichiers ou des tâches avec beaucoup de dépendances : utilisez alors une seule session ou des subagents.
• Pas pour le travail de routine : la consommation de tokens augmente avec chaque coéquipier actif.

Comment monter une agent team Claude Code

1. Activez les agent teams

   Mettez CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS à 1 dans votre environnement ou dans le bloc env de settings.json. Les équipes nécessitent une session interactive ; avec -p (et avec l’Agent SDK), Claude ne crée pas de coéquipiers.

   // settings.json: agent teams are experimental and off by default
   {
     "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }
   }
   
   // Optional: give each teammate its own split pane (tmux or iTerm2)
   {
     "teammateMode": "auto"
   }

2. Décrivez l’équipe en langage courant

   Indiquez combien de coéquipiers vous voulez et ce que fait chacun. Claude crée la liste de tâches partagée, les lance et synthétise leurs conclusions quand ils ont fini.

   Spawn three teammates to review PR #142:
   - One focused on security implications
   - One checking performance impact
   - One validating test coverage
   Have them each review and report findings.

3. Choisissez un mode d’affichage

   Le mode in-process est le mode par défaut et fonctionne dans n’importe quel terminal : les coéquipiers apparaissent dans un panneau sous le prompt ; utilisez les flèches et Entrée pour en ouvrir un et lui écrire, et Ctrl+T pour la liste de tâches. Les panneaux séparés donnent à chaque coéquipier son propre panneau et nécessitent tmux ou iTerm2 avec la CLI it2 ; réglez teammateMode sur auto ou tmux, ou lancez claude --teammate-mode auto.

4. Réutilisez les rôles déjà définis

   Demandez un coéquipier « utilisant le type d’agent security-reviewer » pour réutiliser une définition de subagent de .claude/agents/, avec ses outils, son modèle et ses instructions.

5. Pilotez, puis arrêtez

   Faites le point avec les coéquipiers, réorientez-les, et dites « attends tes coéquipiers » si le chef d’équipe commence à faire leur travail. Pour finir, demandez au chef d’équipe d’arrêter un coéquipier par son nom ; les répertoires de l’équipe sont nettoyés à la fin de la session.

Source : documentation Claude Code, Agent teams

Bonnes pratiques et limites

• Commencez avec 3 à 5 coéquipiers et environ 5 à 6 tâches chacun ; trois coéquipiers concentrés font souvent mieux que cinq dispersés.
• Donnez à chaque coéquipier un ensemble de fichiers différent : deux coéquipiers qui modifient le même fichier s’écrasent mutuellement.
• Mettez les détails de la tâche dans le prompt de création : les coéquipiers chargent CLAUDE.md, les serveurs MCP et les skills, mais pas la conversation du chef d’équipe.
• Utilisez des hooks comme contrôles qualité : TeammateIdle, TaskCreated et TaskCompleted peuvent renvoyer le travail avec le code de sortie 2.
• Limites : une équipe par session, pas d’équipes imbriquées, le chef d’équipe ne peut pas changer, /resume ne restaure pas les coéquipiers in-process, et le statut des tâches peut être en retard.
• Les panneaux séparés ne fonctionnent pas dans le terminal intégré de VS Code, Windows Terminal ni Ghostty ; le mode in-process fonctionne partout.
• Avec les agent teams activées, un subagent que Claude nomme peut se lancer comme coéquipier ; mettez la variable à 0 pour retrouver des subagents classiques.

Agent teams vs les autres façons de faire tourner Claude Code en parallèle

Les agent teams découpent une tâche que vous suivez, dans une seule session. Pour des tâches indépendantes, lancez des sessions séparées dans des worktrees git ou comme agents en arrière-plan ; pour une comparaison complète, lisez plusieurs agents Claude Code. Pour limiter le coût, voir comment réduire la consommation de tokens de Claude Code.

Une équipe qui continue de travailler après la fin de la session

Une agent team vit dans une seule session et s’arrête quand vous la fermez. Crewmark transforme des sessions Claude Code, Codex, DeepSeek Harness ou OpenCode en employés IA dotés de rôles, d’objectifs et d’horaires de travail durables : chacun se réveille avec une pulsation, prend l’issue suivante sur un tableau partagé et vous écrit quand il a besoin d’une décision.

1. Donnez un rôle à chaque employé

   Un ingénieur logiciel, un relecteur, un spécialiste SEO : les rôles que vous créeriez comme coéquipiers, mais pour de bon.

2. Travaillez depuis un seul tableau

   Les issues remplacent la liste de tâches de la session, et elles survivent aux redémarrages, aux jours et aux semaines.

3. Laissez la pulsation lancer le travail

   Toutes les 15, 30 ou 60 minutes pendant les horaires de travail ; voir ce qu’est un employé IA.

FAQ sur les agent teams de Claude Code