La nouvelle fonctionnalité Agent Teams de Claude Code vous permet de coordonner plusieurs agents IA travaillant en parallèle comme une véritable équipe d'ingénieurs. Voici comment l'activer et commencer à diriger votre propre escouade IA.

Vous êtes le PDG maintenant : Comment diriger une équipe de dev IA dans Claude Code

Imaginez. Vous ouvrez votre terminal, tapez quelques phrases, et soudain votre écran se divise en plusieurs panneaux - chacun étant un développeur IA autonome travaillant sur une partie différente de votre projet. Ils communiquent entre eux. Ils prennent des tâches. Ils remettent en question les idées des autres. Et vous, vous vous installez confortablement et regardez le tout se dérouler comme un jeu de stratégie en temps réel.

Ce sont les Agent Teams dans Claude Code. Et c'est maintenant une réalité.

Que sont les Agent Teams ?

Les Agent Teams vous permettent de coordonner plusieurs instances de Claude Code travaillant ensemble. Une session agit comme le chef d'équipe - elle coordonne le travail, assigne les tâches et synthétise les résultats. Les autres sont des coéquipiers - des sessions indépendantes, chacune fonctionnant dans sa propre fenêtre de contexte, communiquant directement entre elles.

Voici ce qui différencie les Agent Teams des sous-agents : les sous-agents fonctionnent à l'intérieur d'une seule session et ne peuvent que rapporter au agent principal. Ils ne peuvent pas se parler entre eux. Les Agent Teams sont des instances Claude Code complètement indépendantes qui s'envoient des messages directement. Utilisez les sous-agents quand vous avez besoin de travailleurs rapides et concentrés qui font leur rapport. Utilisez les Agent Teams quand les coéquipiers doivent partager leurs découvertes, se challenger mutuellement et se coordonner de manière autonome.

Vous gardez le contrôle tout le temps. Claude ne crée jamais une équipe sans votre approbation - soit vous en demandez une, soit Claude en suggère une et attend votre confirmation avant de procéder.

Activez-le en 30 secondes

Les Agent Teams sont expérimentaux et désactivés par défaut. Activez-les avec l'une de ces deux méthodes :

Option 1 : Variable d'environnement

bash

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Option 2 : Fichier de configuration

Ajoutez-le à votre settings.json :

json

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

C'est tout. Vous êtes maintenant un manager d'équipe.

Lancez votre première équipe

Pas de fichiers de configuration. Pas de YAML. Décrivez simplement la tâche et la structure d'équipe souhaitée en langage naturel. Claude crée l'équipe, lance les coéquipiers et coordonne le travail selon votre prompt.

Cet exemple fonctionne bien car les trois rôles sont indépendants et peuvent explorer le problème sans attendre les uns les autres :

Je conçois un outil CLI qui aide les développeurs à suivre les commentaires
TODO dans leur base de code. Crée une équipe d'agents pour explorer cela
sous différents angles : un coéquipier sur l'UX, un sur l'architecture
technique, un qui joue l'avocat du diable.

Appuyez sur Entrée et regardez. Claude crée une équipe avec une liste de tâches partagée, lance un coéquipier pour chaque angle, les laisse explorer, synthétise leurs découvertes et fait le ménage quand le travail est terminé.

Le terminal du chef d'équipe liste tous les coéquipiers et ce sur quoi ils travaillent. On dirait un tableau de bord de projet qui se met à jour en temps réel.

Deux façons de suivre l'action

Vous choisissez comment votre équipe apparaît à l'écran :

Le mode in-process est le mode par défaut. Tous les coéquipiers fonctionnent dans votre terminal principal. Utilisez Shift+Haut/Bas pour sélectionner un coéquipier et tapez pour lui envoyer un message directement. Cela fonctionne dans n'importe quel terminal - aucune configuration supplémentaire nécessaire.

Le mode split-pane est le clou du spectacle. Chaque coéquipier obtient son propre panneau visible. Vous regardez littéralement plusieurs développeurs IA coder côte à côte en temps réel. Il nécessite tmux ou iTerm2 et ne fonctionne pas dans le terminal intégré de VS Code, Windows Terminal ou Ghostty.

Si vous voulez cette sensation de jeu de stratégie en temps réel - le mode split-pane est celui qu'il vous faut. Regarder trois agents enquêter simultanément sur votre base de code sous différents angles dans des panneaux séparés est véritablement palpitant.

Contrôlez votre équipe comme un pro

Une fois qu'une équipe tourne, vous parlez au chef d'équipe en langage naturel. Il gère la coordination, l'assignation des tâches et la délégation selon vos instructions.

Mais voici le coup de maître - le Delegate Mode. Appuyez sur Shift+Tab pour parcourir les modes de permission. Quand une équipe d'agents est active, le cycle inclut le Delegate Mode, qui restreint le chef d'équipe aux outils de coordination uniquement. Pas de code, juste du lancement, de l'envoi de messages et de la gestion de tâches. Cela résout le problème courant du chef d'équipe qui essaie d'implémenter les tâches lui-même au lieu de les déléguer.

Vous pouvez aussi contourner le chef d'équipe complètement. Utilisez Shift+Haut/Bas pour sélectionner n'importe quel coéquipier et lui envoyer un message directement. Vous n'êtes pas enfermé dans une chaîne de commandement - vous pouvez intervenir où vous voulez, exactement comme un vrai manager d'équipe qui va au bureau de quelqu'un.

La liste de tâches partagée

En coulisses, l'équipe fonctionne avec une liste de tâches partagée. Les tâches ont trois états : en attente, en cours et terminée. Les tâches peuvent avoir des dépendances - quand un coéquipier termine une tâche dont d'autres tâches dépendent, les tâches bloquées sont automatiquement débloquées.

Les coéquipiers réclament les tâches de manière autonome. Quand l'un termine son travail, il prend la prochaine tâche non assignée et non bloquée de la liste. Pas de micro-management nécessaire.

Toute la configuration de l'équipe et les tâches sont stockées localement dans ~/.claude/teams/{team-name}/config.json.

Où les Agent Teams dominent

Les Agent Teams sont les plus efficaces pour les tâches où l'exploration parallèle apporte une vraie valeur ajoutée. Voici les cas d'utilisation les plus forts directement du guide :

Recherche et revue de code

Plusieurs coéquipiers examinent simultanément différents aspects d'un problème, puis partagent et challengent mutuellement leurs découvertes. Un seul revieweur a tendance à se concentrer sur un type de problème à la fois. Divisez les critères en domaines indépendants et tout reçoit une attention approfondie en même temps :

Crée une équipe d'agents pour examiner la PR #142. Lance trois revieweurs :
- Un concentré sur les implications de sécurité
- Un qui vérifie l'impact sur les performances
- Un qui valide la couverture de tests
Qu'ils examinent chacun et rapportent leurs conclusions.

Trois agents, trois angles, tous actifs en même temps. On a l'impression de commander une équipe d'intervention.

Nouveaux modules ou fonctionnalités

Les coéquipiers possèdent chacun une partie séparée sans se marcher dessus. Quand les limites sont claires, c'est là que les Agent Teams brillent :

Crée une équipe d'agents pour construire la nouvelle fonctionnalité
de tableau de bord. Un coéquipier sur la couche API, un sur les
composants frontend, un sur la suite de tests.

Quand le coéquipier API termine les définitions de types, il envoie un message directement au coéquipier frontend. Le coéquipier tests demande au coéquipier API de lancer un serveur de dev. Ils se coordonnent entre eux sans que vous leviez le petit doigt.

Debugging avec hypothèses concurrentes

Au lieu de tester les théories une par une, lancez des coéquipiers qui poursuivent chacun une hypothèse différente en parallèle. Ils convergent plus vite vers la réponse - et ils peuvent challenger les découvertes des autres en cours de route.

Voyez cela comme un débat entre experts où vous êtes le juge.

Coordination inter-couches

Des modifications qui s'étendent au frontend, au backend et aux tests - chacune gérée par un coéquipier différent. C'est le scénario classique du "trop de pièces en mouvement pour un seul cerveau", et les Agent Teams le gèrent magnifiquement.

Quand NE PAS utiliser les Agent Teams

Toutes les tâches ne nécessitent pas une équipe. Les Agent Teams ajoutent un surcoût de coordination et utilisent significativement plus de tokens qu'une session unique. Ils fonctionnent mieux quand les coéquipiers peuvent opérer indépendamment.

Passez-vous des équipes et utilisez une session unique ou des sous-agents pour :

Les tâches séquentielles où chaque étape dépend de la précédente
Les modifications du même fichier où plusieurs agents créeraient des conflits
Le travail avec beaucoup de dépendances qui empêche l'exécution parallèle
Les tâches de routine qu'un seul agent gère parfaitement

Vous ne rassembleriez pas une équipe de cinq personnes pour renommer une variable. La même logique s'applique ici.

Coûts en tokens : Le prix de la puissance

C'est la section la plus importante. Les Agent Teams utilisent significativement plus de tokens qu'une session unique. Chaque coéquipier a sa propre fenêtre de contexte, et l'utilisation de tokens évolue avec le nombre de coéquipiers actifs.

Pour la recherche, la revue de code et le développement de nouvelles fonctionnalités, les tokens supplémentaires en valent généralement la peine. Pour les tâches de routine, une session unique est bien plus rentable.

Voyez cela comme embaucher des freelances - vous les faites venir pour les gros projets, pas pour les tâches quotidiennes.

Votre CLAUDE.md fonctionne toujours

Bonne nouvelle - CLAUDE.md fonctionne normalement avec les Agent Teams. Les coéquipiers lisent les fichiers CLAUDE.md depuis leur répertoire de travail, donc toutes les directives spécifiques au projet s'appliquent automatiquement à toute l'équipe. Aucune configuration supplémentaire nécessaire.

Limitations connues

Les Agent Teams sont expérimentaux et la documentation est transparente à ce sujet. Les limitations actuellement connues incluent des problèmes de reprise de session, de coordination des tâches et de comportement à l'arrêt. Vous ne pouvez faire tourner qu'une seule équipe par session, les équipes imbriquées ne sont pas supportées, et le mode split-pane est limité à tmux et iTerm2.

Le chef d'équipe essaie parfois d'implémenter les tâches lui-même au lieu de déléguer. Deux solutions : dites-lui explicitement "attends que tes coéquipiers aient terminé leurs tâches avant de continuer" dans votre prompt, ou utilisez le Delegate Mode (Shift+Tab) pour le restreindre aux outils de coordination.

Ce sont les premiers jours - mais l'expérience fondamentale donne déjà l'impression de quelque chose de fondamentalement nouveau.

Approches connexes

Les Agent Teams coexistent avec d'autres stratégies de travail parallèle dans Claude Code :

Les sous-agents sont votre option de délégation légère. Ils lancent des agents auxiliaires pour la recherche ou la vérification au sein de votre session - mieux adaptés aux tâches qui ne nécessitent pas de coordination inter-agents.

Les sessions parallèles manuelles utilisant les git worktrees vous permettent de faire tourner plusieurs sessions Claude Code vous-même sans coordination d'équipe automatisée.

La progression est claire : sous-agents pour les tâches solo rapides, Agent Teams quand les collaborateurs doivent vraiment travailler ensemble.

Pour commencer : Votre première mission

Voici la progression recommandée :

Semaine une : Activez les Agent Teams et commencez par une revue de code. Trois revieweurs, trois angles - sécurité, performance, couverture de tests. Risque faible, rendement élevé. Observez comment ils se coordonnent et prenez le pouls du flux.

Semaine deux : Essayez une exploration de recherche. Donnez à l'équipe une question de design ouverte avec trois perspectives différentes. Regardez-les challenger mutuellement leurs idées.

Semaine trois : Tentez une implémentation de fonctionnalité avec des limites claires. Un coéquipier par couche, chacun avec son propre territoire.

D'ici là, vous aurez un instinct pour savoir quand les équipes apportent de la valeur et quand une session solo est le meilleur choix.

Le verdict final

Les Agent Teams transforment Claude Code d'un développeur unique en une équipe coordonnée que vous dirigez en temps réel. Vous décrivez ce que vous voulez, assignez des rôles, regardez plusieurs agents IA démarrer dans des panneaux séparés, prendre des tâches, s'envoyer des messages et livrer des résultats en parallèle.

C'est expérimental. Ça consomme des tokens. Ça a des aspérités. Et c'est la chose la plus excitante qui soit arrivée dans le codage assisté par IA cette année.

Activez-le. Lancez une équipe. Regardez votre terminal prendre vie.

Vous n'écrivez plus seulement du code. Vous dirigez le spectacle.

Claude Code Agent Teams : Vous êtes maintenant le PDG d'une équipe de dev IA (et ça ressemble à un jeu)