Agent teams : collaboration multi-sessions

📚 Navigation de la série : L'article précédent [28 Utilisation de skill-creator] vous a appris à créer un skill déclenché avec précision. Cet article aborde la « collaboration multi-agents » : regrouper plusieurs sessions Claude Code au sein d'une équipe. Vous agissez en tant que chef de chantier pour répartir le travail, ils s'occupent chacun d'une partie en parallèle, et vous validez le tout à la fin.

⚠️ Expérimental, sujet à changement : Agent teams est une fonctionnalité expérimentale explicitement marquée par l'équipe officielle, désactivée par défaut, et nécessite Claude Code v2.1.32 ou une version ultérieure. Les commandes et les valeurs par défaut de cet article sont basées sur la documentation officielle au moment de la rédaction, mais l'interface, les raccourcis clavier et le comportement peuvent être ajustés par la suite. Veuillez vérifier votre version avec claude --version avant de continuer.

« Pourquoi as-tu trois Claude ouverts sur ton écran ? Et ils sont tous en train de tourner. »

« Un qui modifie le frontend, un pour le backend, et un autre dédié à l'écriture des tests. Je surveille et je répartis le travail. »

« Mais ce n'est pas le bazar ? Comment peux-tu surveiller les trois à la fois tout seul ? »

« Je n'ai pas besoin de les surveiller en permanence. Ils font chacun leur travail. Si l'un d'eux est bloqué ou a besoin de ma décision, il me contacte de lui-même. La plupart du temps, je fais autre chose. »

La personne avec les trois Claude ouverts dans cette conversation, c'est moi. La première fois que j'ai exécuté plusieurs sessions simultanément sur le même écran, la réaction de mon collègue à côté était exactement la même : d'abord la surprise, puis « comment fais-tu pour tous les surveiller ». Pour le dire simplement, ce qui surprend, c'est « comment une seule personne peut diriger plusieurs IA en même temps », et c'est précisément ce que nous allons décortiquer dans cet article : Agent teams (équipes d'agents), qui permet à plusieurs sessions Claude Code de collaborer comme une équipe où vous ne vous occupez que de la répartition et de la validation.

À la fin de cet article, vous obtiendrez :

• Ce qu'est réellement Agent teams et comment il dépasse les limites d'une session unique, expliqué en une phrase
• La différence avec les subagents (sous-agents) étudiés précédemment — un tableau comparatif pour savoir « quand utiliser quoi »
• Le rôle des quatre composants clés de l'équipe (leader (responsable), coéquipiers, liste de tâches partagée, boîte aux lettres)
• Comment gérer plusieurs sessions avec l'« écran de contrôle » claude agents (agent view), et comment basculer entre coéquipiers avec Shift+Down au sein d'une équipe
• Un cas pratique à suivre avec les résultats attendus : activer la fonctionnalité → créer une équipe de trois personnes → les regarder travailler en parallèle

---

01 Comprendre d'abord : Où se situent les limites d'une session unique

Commençons par la conclusion : Agent teams est conçu pour briser les deux barrières d'une session unique Claude Code : « contexte limité + exécution séquentielle ».

Dans les articles précédents, nous avons travaillé dans « une seule session » : lancer un Claude, lui donner des instructions, et le regarder faire étape par étape. Ce mode suffit pour 90 % des tâches. Cependant, deux situations vous feront atteindre ses limites :

Premièrement, le contexte ne rentre plus. Une session ne dispose que d'une seule fenêtre de contexte (context window, qui s'apparente à sa « mémoire de travail »). Si vous lui demandez de lire en même temps le frontend, le backend et les tests, puis d'effectuer des modifications globales, sa mémoire sera rapidement saturée et il commencera à « oublier » des choses au fur et à mesure.

Deuxièmement, il ne peut faire qu'une chose à la fois. Une session unique est intrinsèquement séquentielle : lire A puis lire B, modifier le frontend puis passer au backend. Même pour trois tâches totalement indépendantes, il doit les traiter l'une après l'autre.

Analogie : un grand chantier où vous seriez à la fois électricien, maçon et menuisier, effectuant tous les métiers vous-même. D'une part, votre cerveau ne peut pas enregistrer autant de tâches parallèles (en surveillant l'électricité, vous oubliez l'avancement de la maçonnerie) ; d'autre part, vous n'avez que deux mains (si vous câblez, vous ne pouvez pas poser de carrelage), vous devez donc terminer un métier avant de passer au suivant. Dans ce cas, la solution intelligente n'est pas de tout porter sur vos épaules, mais de devenir chef de chantier : recruter des ouvriers pour l'électricité, la maçonnerie et la menuiserie afin qu'ils travaillent en parallèle, pendant que vous répartissez le travail et validez le résultat.

Agent teams vous transforme d'un « ouvrier sur le terrain » en un « chef de chantier stratégique ». Cette approche s'applique particulièrement à quatre types de tâches (désignés comme les « meilleurs cas d'usage » officiels) :

• Recherche et revue : plusieurs coéquipiers examinent différents aspects d'un même problème en parallèle, puis remettent en question leurs découvertes respectives
• Nouveaux modules / Nouvelles fonctionnalités : chaque coéquipier s'occupe d'une partie isolée sans interférer avec les autres
• Débogage par hypothèses concurrentes : plusieurs coéquipiers testent différentes théories en parallèle, s'excluent mutuellement et convergent plus rapidement vers la cause première
• Modifications multi-couches : lorsque le frontend, le backend et les tests couvrent plusieurs couches, un coéquipier est affecté à chaque couche

💡 Résumé en une phrase : Une session unique se heurte aux limites de la mémoire saturée et de l'exécution séquentielle ; Agent teams vous fait passer d'un travailleur isolé à un chef de chantier dirigeant une équipe en parallèle.

---

02 Quelle est la véritable différence avec un subagent

C'est la paire la plus facile à confondre, il faut donc clarifier les choses dès le départ — sinon, même après avoir appris les deux fonctionnalités, vous ne saurez pas laquelle utiliser.

Le subagent que nous avons étudié dans le chapitre précédent (chapitre 23) consiste à sous-traiter une tâche à un assistant spécialisé au sein d'une même session : il dispose d'un contexte indépendant et renvoie ses conclusions à la conversation principale, mais les coéquipiers ne communiquent pas entre eux et vous ne les gérez pas directement. Agent teams est totalement différent — il s'agit de la collaboration entre plusieurs sessions complètes et équivalentes de Claude Code, où les coéquipiers peuvent s'envoyer directement des messages et où vous pouvez contourner le leader pour discuter directement avec un coéquipier spécifique.

Analogie : un subagent est un travailleur temporaire envoyé faire une course, tandis qu'une agent team est une équipe qualifiée réunie pour un projet. Au travailleur temporaire, vous dites simplement : « Va extraire les erreurs de ces mille lignes de logs ». Il le fait de son côté, revient vous donner un bout de papier et ne connaît pas vos autres travailleurs temporaires, ne communiquant qu'avec vous. Dans une équipe, en revanche, les ouvriers peuvent se demander mutuellement : « As-tu modifié ton API de ton côté pour que je puisse m'y connecter ? », et vous, le chef de chantier, pouvez à tout moment aller voir n'importe quel ouvrier pour lui donner des instructions spécifiques.

La différence concrète est résumée dans ce tableau — s'il y a une chose à retenir, c'est celle-ci :

Dimension	Subagent (Sous-agent)	Agent teams (Équipe d'agents)
Contexte	Contexte indépendant, résultats renvoyés à l'appelant	Contexte indépendant, complètement autonome
Qui coordonne	L'agent principal gère tout	Le leader coordonne, mais avec une liste de tâches partagée pour l'auto-coordination
Entre coéquipiers	Pas de communication, rapport direct à l'agent principal	Envoi direct de messages
Gestion directe	Impossible, uniquement via la session principale	Possible de dialoguer directement avec n'importe quel coéquipier
Coût en tokens	Modéré, résultats synthétisés dans le contexte principal	Élevé, chaque coéquipier est une instance indépendante de Claude
Idéal pour	Tâches ciblées nécessitant juste un résultat sans débat	Collaborations complexes nécessitant discussions et remises en question

Le critère de décision officiel le plus important à retenir :

Utilisez des subagents lorsque vous avez besoin de travailleurs rapides et concentrés pour rapporter des résultats. Utilisez des agent teams lorsque les coéquipiers doivent partager leurs découvertes, se remettre en question mutuellement et s'auto-coordonner.

Il existe également une règle empirique plus simple : ces « ouvriers » ont-ils besoin de communiquer entre eux ? Si non (chacun cherche de son côté et synthétise à la fin), utilisez un subagent, c'est moins cher. Si oui (collaboration et ajustements continus, critique mutuelle), optez pour une agent team.

💡 Résumé en une phrase : Le subagent est un coursier temporaire — il travaille seul et ne fait de rapport qu'à vous ; l'agent team est une équipe — les coéquipiers se parlent et vous pouvez diriger chacun directement. Le besoin de communication interne est la ligne de partage des eaux pour choisir l'un ou l'autre.

---

03 Comment l'équipe est constituée : Les quatre composants clés

Le fonctionnement d'une agent team repose sur quatre composants clés. Apprenez à les reconnaître pour comprendre ce qui se passe à l'écran.

Analogie : une véritable équipe de chantier. Un chef de chantier (leader), quelques ouvriers (teammates), un tableau des tâches affiché au mur (task list) et une boîte aux lettres permettant aux ouvriers de s'envoyer des notes de communication (mailbox). Une fois ces quatre éléments réunis, l'équipe peut tourner.

Voici le tableau d'architecture officiel décrivant ces quatre éléments :

Composant	Rôle
Team lead (Responsable)	La session principale qui crée l'équipe, génère les coéquipiers et coordonne le travail — c'est-à-dire celle que vous ouvrez en premier
Teammates (Coéquipiers)	Des instances indépendantes de Claude Code qui s'approprient des tâches et travaillent individuellement, chacune avec son propre contexte
Task list (Liste de tâches)	Une liste de travail partagée que les coéquipiers s'attribuent et complètent, avec trois statuts : À faire / En cours / Terminé
Mailbox (Boîte aux lettres)	Un système d'envoi de messages entre agents. Les messages des coéquipiers sont automatiquement transmis au leader sans que vous ayez besoin de les interroger

Voici quelques détails de fonctionnement cruciaux pour les débutants :

Le leader ne peut plus être modifié une fois défini. La session qui crée l'équipe reste le leader pour toujours — vous ne pouvez pas promouvoir un coéquipier au rang de leader, ni transférer la direction. Ainsi, la session que vous ouvrez en premier constitue l'entité même de votre « chef de chantier ».

Les coéquipiers peuvent s'attribuer des tâches de deux manières. Le leader peut affecter explicitement un travail (« cette tâche est pour A ») ; ou les coéquipiers, après avoir terminé leur tâche en cours, peuvent choisir eux-mêmes la tâche suivante non attribuée et non bloquée sur le tableau des tâches (appelé « auto-attribution »). Pour éviter que deux coéquipiers ne s'attribuent la même tâche en même temps, le système utilise un mécanisme de verrouillage de fichier afin d'éviter toute collision.

Les tâches peuvent avoir des dépendances. Par exemple, « Écrire les tests » doit attendre que « Implémenter la fonctionnalité » soit terminé. Une tâche ayant des dépendances non résolues ne peut pas être attribuée ; dès que la dépendance est satisfaite, la tâche bloquée est automatiquement déverrouillée.

Les coéquipiers n'héritent pas de l'historique de votre conversation. C'est le piège le plus fréquent pour les débutants : supposer que les coéquipiers savent naturellement ce que sait le leader, et finir par générer des coéquipiers sans leur donner aucun contexte, les laissant complètement perdus. La documentation officielle l'explique clairement : les coéquipiers se chargent avec le même contexte de projet qu'une session standard (CLAUDE.md, MCP, skills), mais l'historique de conversation du leader n'est pas hérité. Par conséquent, lors de la répartition des tâches, veillez à expliciter clairement le contexte dans vos instructions.

💡 Résumé en une phrase : Une équipe = un chef (leader, immuable) + des ouvriers (coéquipiers, chacun avec son propre contexte) + un tableau des tâches (liste partagée, gérant les dépendances et l'auto-attribution) + une boîte aux lettres (messages internes) ; pensez à fournir tout le contexte nécessaire lors de la distribution des tâches, car les coéquipiers ne lisent pas votre historique.

Ce schéma clarifie les quatre composants d'une agent team : au centre se trouve le leader (chef de chantier) qui génère des coéquipiers indépendants (ouvriers) effectuant chacun leur part du travail ; en bas, un tableau des tâches partagé permet à chacun de s'attribuer du travail et de gérer automatiquement les dépendances ; enfin, les coéquipiers disposent d'une boîte aux lettres directe — vous pouvez voir en un coup d'œil si les messages contournent le leader et qui s'est attribué quelle tâche.

---

04 Utiliser l'agent view comme « écran de contrôle » pour gérer plusieurs sessions

Une fois l'équipe en place, une question se pose : plusieurs sessions tournent en même temps, où dois-je regarder ?

La réponse est l'agent view (vue des agents) — un « écran de contrôle » qui regroupe toutes les sessions en arrière-plan sur un seul écran, accessible via la commande claude agents.

⚠️ L'agent view est une version préliminaire de recherche (Research Preview), nécessitant Claude Code v2.1.139 ou une version ultérieure. L'interface et les raccourcis clavier peuvent changer selon les versions.

Analogie : le tableau d'avancement des travaux affiché sur le mur du chantier. Vous n'avez pas besoin d'aller voir chaque poste de travail pour demander « où en es-tu ? », il vous suffit de lever les yeux vers le tableau : vous voyez immédiatement quelle étape est en cours, laquelle est bloquée en attendant votre décision, ou laquelle est déjà validée. La commande claude agents est ce tableau pour Claude Code : chaque session occupe une ligne, précédée d'une icône dont la couleur et l'animation vous indiquent son état.

Voici les états officiels correspondants, parmi les plus courants :

État	Affichage de l'icône	Signification
En cours	Animation	Claude exécute un outil ou génère une réponse
Entrée requise	Jaune	En attente de votre réponse à une question ou d'une validation de permission
Terminé	Vert	La tâche a été accomplie avec succès
Échec	Rouge	La tâche s'est terminée sur une erreur

Sur ce tableau de bord, vous pouvez effectuer trois actions sur n'importe quelle ligne, de la plus légère à la plus engageante :

• Jeter un œil (Peek) : appuyez sur Space pour ouvrir un petit panneau et voir les dernières sorties de la session ou la question sur laquelle elle bloque — la plupart du temps, cela suffit, sans avoir besoin d'entrer réellement dans la session. Vous pouvez tapez votre réponse directement dans ce panneau et appuyer sur Enter pour l'envoyer sans y entrer.
• Répondre : vous pouvez répondre directement depuis le panneau de prévisualisation. Si un choix multiple est proposé, appuyez simplement sur la touche numérique correspondante.
• S'attacher (Attach) : appuyez sur Enter ou → pour basculer dans la conversation complète de cette session, exactement comme si vous aviez ouvert un seul Claude. Appuyez sur ← sur une ligne de saisie vide pour revenir au tableau de bord.

Il existe un aspect très pratique : ces sessions en arrière-plan continuent de s'exécuter même si aucun terminal n'est ouvert. Un processus de supervision indépendant (supervisor) les gère en arrière-plan — même si vous fermez l'agent view, fermez le shell ou ouvrez une toute nouvelle session, ils continuent à travailler. À votre retour, en exécutant claude agents, ils seront toujours là.

Vous pouvez tout à fait utiliser claude agents comme point d'entrée principal à la place de claude : en arrivant, lancez simplement quelques tâches indépendantes dans la zone de saisie en bas du tableau de bord (chaque prompt suivi de Enter lance une nouvelle session en parallèle), puis vaquez à vos occupations. Revenez traiter les alertes lorsque des lignes passent au jaune (votre intervention est requise) ou au vert (tâche terminée). C'est bien plus propre et confortable que de jongler entre sept ou huit fenêtres de terminal.

💡 Résumé en une phrase : claude agents est l'« écran de contrôle » pour gérer plusieurs sessions : une session par ligne, avec un code couleur indiquant le statut. Utilisez Space pour jeter un œil, Enter pour entrer dans la session, et ← pour en sortir. Les sessions continuent de tourner en arrière-plan sans nécessiter de garder le terminal ouvert.

---

05 Diriger ses coéquipiers au sein d'une équipe : Répartition, bascule et demandes de plans

Ce qui précède concernait la gestion générale des « multi-sessions ». Concernant l'agent teams lui-même, comment dirigez-vous concrètement vos coéquipiers en tant que leader ? L'essentiel tient en une phrase : expliquez simplement en langage naturel ce que vous voulez au leader, et il se chargera de la coordination, de la répartition et de la délégation.

Pour lancer une équipe, pas besoin de retenir des commandes complexes, décrivez simplement la tâche et la structure de l'équipe en langage naturel. Voici l'exemple officiel très parlant (trois rôles indépendants qui n'ont pas à s'attendre mutuellement) :

I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Create an agent team to explore this from different angles: one
teammate on UX, one on technical architecture, one playing devil's advocate.

Vous pouvez également formuler votre demande directement : « Aide-moi à créer une agent team pour explorer ce problème sous différents angles : un coéquipier responsable de l'UX, un autre de l'architecture technique, et un dernier jouant l'avocat du diable. » Claude créera alors l'équipe, générera les coéquipiers selon les angles demandés, les laissera explorer, puis synthétisera leurs découvertes.

Basculer entre les coéquipiers et donner des instructions spécifiques. En mode in-process (au sein du même terminal), appuyez sur Shift+Down pour faire défiler les coéquipiers. Une fois sur le profil d'un coéquipier, vous pouvez taper directement un message pour lui envoyer — ajouter une consigne, poser une question de suivi, ou lui demander de changer d'approche. Appuyez sur Enter pour entrer dans sa session et voir les détails, sur Escape pour interrompre son cycle en cours, et sur Ctrl+T pour basculer vers la liste des tâches. Une fois arrivé au dernier coéquipier, appuyer à nouveau sur Shift+Down vous ramène au leader.

Notez bien la différence de raccourcis clavier pour ne pas les confondre : dans l'écran de contrôle des sessions en arrière-plan, utilisez ↑/↓ pour changer de ligne, tandis que dans une agent team, utilisez Shift+Down pour changer de coéquipier. Deux contextes, deux raccourcis.

Demander aux coéquipiers de proposer un plan avant d'agir. Lorsque la tâche présente des risques, vous pouvez exiger que le coéquipier planifie d'abord en mode lecture seule, et n'agisse qu'après votre approbation (via le leader) :

Générer un coéquipier architecte pour refactoriser le module d'authentification.
Avant qu'il ne modifie quoi que ce soit, son plan doit d'abord être approuvé.

Une fois que le coéquipier a fini sa planification, il envoie une « demande d'approbation de plan » au leader. Il ne sortira du mode planification pour commencer à travailler que si vous l'approuvez. Si vous refusez la proposition, il la modifiera en fonction de vos retours avant de la soumettre à nouveau.

Spécifier le nombre de coéquipiers et les modèles. Vous pouvez également indiquer explicitement le nombre d'agents et le modèle à utiliser :

Créer une équipe de 4 coéquipiers pour refactoriser ces modules en parallèle.
Chaque coéquipier doit utiliser Sonnet.

Ne négligez pas ce point clé d'économie : par défaut, les coéquipiers ne suivent pas le choix de /model du leader. Si vous souhaitez modifier uniformément leur modèle, spécifiez-le dans le prompt comme ci-dessus, ou modifiez le « modèle par défaut des coéquipiers » dans /config.

Fermer la session once finished. À la fin de la tâche, demandez au leader de nettoyer l'équipe :

Nettoyer cette équipe

⚠️ L'équipe officielle insiste : le nettoyage doit impérativement être effectué via le leader, et non par un coéquipier — le contexte d'équipe d'un coéquipier pourrait être mal analysé, laissant les ressources dans un état incohérent. De plus, avant de nettoyer, vous devez d'abord arrêter les coéquipiers en cours d'exécution, sous peine de voir le nettoyage échouer si le leader détecte des coéquipiers actifs.

💡 Résumé en une phrase : La création d'équipe, la répartition du travail, le basculement entre coéquipiers (Shift+Down), les demandes d'approbation et le nettoyage final se pilotent tous en langage naturel via le leader. Retenez ces trois règles d'or : le modèle des coéquipiers doit être spécifié à part, le contexte doit être fourni en intégralité dans les instructions, et le nettoyage se fait toujours via le leader.

---

06 Faut-il utiliser une équipe : Ne divisez pas pour le plaisir de diviser

Arrivé ici, vous avez peut-être hâte de diviser toutes vos tâches pour les confier à une équipe. Attendez — c'est le prolongement de la règle d'or à contre-courant du chapitre 23 sur les subagents : diviser les tâches n'est pas toujours la bonne solution.

L'utilisation d'Agent teams a un coût réel, encore plus élevé que celui des subagents :

Premièrement, la consommation de tokens est élevée. Chaque coéquipier étant une instance indépendante et complète de Claude dotée de son propre contexte, avoir plusieurs coéquipiers signifie consommer autant de fois plus de tokens. L'équipe officielle l'indique clairement : pour les tâches quotidiennes, une session unique est plus rentable ; le surcoût en tokens n'en vaut la peine que pour les travaux de recherche, de revue ou de nouvelles fonctionnalités qui tirent un réel avantage de la parallélisation.

Deuxièmement, la coordination elle-même a un coût. Plus vous avez de coéquipiers, plus les communications mutuelles, la coordination des tâches et les conflits potentiels augmentent. Passé un certain seuil, ajouter d'autres coéquipiers n'accélèrera plus le travail de manière proportionnelle — trois coéquipiers concentrés sont souvent plus efficaces que temps de cinq dispersés.

J'ai résumé la pertinence de diviser ou non le travail dans ce tableau comparatif, auquel vous pouvez vous référer :

Scénario	Diviser en équipe ou non
Modification parallèle du frontend, du backend et des tests sans dépendances mutuelles	✅ Oui, affecter une couche à chaque agent est parfaitement adapté
Origine d'un bug inconnue, volonté de tester plusieurs hypothèses concurrentes en parallèle	✅ Oui, laisser les coéquipiers s'exclure mutuellement permet de converger plus vite
Revue d'une PR par plusieurs personnes (un pour la sécurité, un pour les performances, un pour les tests)	✅ Oui, chacun utilise ses propres critères sans chevauchement
Suite d'étapes séquentielles dépendantes (A doit être fini pour faire B)	❌ Non, une session unique est plus fluide pour le travail séquentiel
Plusieurs coéquipiers devant modifier le même fichier	❌ Non, deux agents éditant le même fichier risquent de s'écraser mutuellement
Une petite tâche rapide	❌ Non, le coût de coordination dépasserait le temps gagné

L'équipe officielle propose également deux conseils très pratiques pour démarrer en évitant les erreurs de débutant :

Commencez par des tâches qui n'impliquent pas d'écriture de code, comme la « recherche / revue ». Examiner une PR, étudier une bibliothèque ou diagnostiquer un bug — ces tâches ont des limites claires et n'écrivent pas de code. Elles vous permettent de comprendre la valeur de l'exploration parallèle sans vous soucier des tracas de coordination liés à l'écriture de code synchrone. La première fois que j'ai utilisé Agent teams, c'était pour passer en revue une PR : trois coéquipiers surveillaient respectivement la sécurité, les performances et la couverture de test. Aucun fichier n'a été modifié durant tout le processus, ce qui a évité les conflits. C'était un plaisir de voir les conclusions émerger progressivement des trois côtés — une fois cette expérience réussie, j'ai osé passer à la « modification de code en parallèle ». Ne faites pas comme moi la fois suivante, où j'ai lancé trois coéquipiers pour modifier en parallèle trois fichiers adjacents : les modifications entraient en conflit et le temps passé à résoudre les collisions a rendu le travail plus lent qu'une simple exécution séquentielle dans une session unique.

Démarrez avec une équipe de 3 à 5 personnes. Cette taille est idéale pour toutes sortes de tâches : elle offre de la parallélisation sans que la coordination ne devienne incontrôlable. N'agrandissez l'équipe que si la tâche tire réellement profit de la présence de bras supplémentaires.

💡 Résumé en une phrase : Agent teams consomme plus de tokens et nécessite plus de coordination que les subagents, ne divisez le travail que s'il y a un réel intérêt à le faire en parallèle. Évitez de diviser en cas de dépendances mutuelles, de modifications sur le même fichier ou de tâches triviales. Les débutants feraient mieux de commencer par des revues ou recherches sans écriture de code avec une équipe de 3 à 5 agents.

---

07 En pratique : Activer la fonctionnalité et lancer une équipe de trois agents

Rien ne vaut la pratique. Voici comment activer Agent teams à partir de zéro, puis lancer une équipe de trois agents pour exécuter une tâche très simple en parallèle, le tout sans dépendre d'un projet complexe.

Prérequis : exécutez claude --version pour vérifier que vous disposez de la version v2.1.32 ou supérieure ; sinon, mettez-la d'abord à jour avec claude update.

Étape 1 : Activer la fonctionnalité expérimentale

Agent teams étant désactivé par défaut, vous devez activer l'interrupteur dans les paramètres utilisateur. Éditez le fichier ~/.claude/settings.json (créez-le s'il n'existe pas) et ajoutez cette section env :

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

Résultat attendu : la configuration env est présente dans le fichier. C'est la méthode d'activation spécifiée officiellement — définir la variable d'environnement CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS à 1.

Étape 2 : Créer un répertoire de test et y lancer Claude (Mac / Linux)

mkdir team-demo
cd team-demo
claude

Utilisateurs Windows : exécutez également mkdir et cd, puis lancez claude.

Résultat attendu : l'écran d'accueil de Claude Code apparaît avec la zone de saisie en bas.

Étape 3 : Créer une équipe de trois agents en langage naturel

Saisissez l'instruction suivante (décrivant la tâche et la structure de l'équipe pour laisser le leader la composer lui-même) :

Aide-moi à créer une agent team pour étudier la question « Faut-il choisir un site statique ou dynamique pour un blog personnel ? » sous trois angles différents :
Un coéquipier défend uniquement « le choix du site statique », un autre uniquement « le choix du site dynamique »,
et un troisième joue l'avocat du diable en cherchant des failles dans les deux solutions. Laissez chacun donner ses conclusions.

Résultat attendu : Claude vous indique d'abord qu'il s'apprête à créer une équipe et à générer trois coéquipiers (chacun selon son rôle), puis vous demande confirmation. Il ne créera pas d'équipe sans vous consulter — l'équipe officielle spécifiant bien qu'aucune équipe n'est créée sans votre approbation. Une fois validé, les trois coéquipiers se lancent l'un après l'autre et commencent à travailler dans leur propre contexte.

Étape 4 : Utiliser Shift+Down pour examiner un coéquipier

Une fois l'équipe lancée, le terminal du leader affiche la liste des coéquipiers et leurs tâches en cours. Appuyez sur Shift+Down pour faire défiler les coéquipiers et lui envoyer un message en direct. Par exemple, positionnez-vous sur l'avocat du diable et ajoutez :

Aide-moi également à trouver des failles sous l'angle du « coût de maintenance ».

Résultat attendu : le message est envoyé directement à ce coéquipier (sans passer par le leader) ; il intégrera le « coût de maintenance » dans ses critiques. Une fois sur le dernier coéquipier, appuyer à nouveau sur Shift+Down vous ramène au leader — de retour chez le leader, vous pouvez de nouveau piloter l'ensemble.

Étape 5 : Nettoyage final

Une fois la recherche terminée, revenez au leader et demandez-lui de nettoyer :

Aide-moi à nettoyer cette équipe.

Résultat attendu : le leader vérifie que tous les coéquipiers se sont arrêtés, puis supprime les ressources partagées de l'équipe. Si des coéquipiers sont toujours actifs, le nettoyage échoue — demandez alors au leader d'arrêter les coéquipiers (« demande aux coéquipiers de s'arrêter (shut down) ») avant de réessayer. Rappelez-vous la règle officielle : le nettoyage doit toujours passer par le leader, ne laissez jamais un coéquipier le faire.

En complétant ces cinq étapes, vous avez réalisé par vous-même le parcours complet : « activer → constituer l'équipe → exécuter en parallèle → discuter en direct avec un coéquipier → nettoyer ». Toutes les utilisations futures d'Agent teams reposeront sur cette même base, en variant simplement les tâches et les rôles.

💡 Résumé en une phrase : Activation de l'interrupteur env dans settings.json → instruction en langage naturel au leader pour composer l'équipe → Shift+Down pour discuter en direct avec un coéquipier → nettoyage final par le leader. Expérimenter ce flux vaut mieux que retenir par cœur dix raccourcis clavier.

---

08 Conclusion

Dans ce chapitre, nous avons passé en revue la « collaboration multi-agents » de Claude Code de bout en bout — vous êtes passé du rôle d'ouvrier sur le terrain à celui de chef supervisant une équipe.

Récapitulons les points clés :

Ce que vous voulez faire	Outil à utiliser	Point clé
Dépasser les limites de mémoire et d'exécution séquentielle d'une session unique	Agent teams	Plusieurs sessions équivalentes en parallèle, vous pilotez en tant que leader
Distinguer la différence avec un subagent	Vérifier si la communication interne est requise	Utilisez une équipe si de la concertation ou des critiques sont requises, sinon préférez le subagent (moins cher)
Gérer plusieurs sessions en parallèle	claude agents (agent view)	Une session par ligne, code couleur pour le statut, Space pour prévisualiser (Peek)
Changer de coéquipier pour discuter en direct	Shift+Down	La boucle vous ramène au leader ; ne confondez pas avec ↑/↓ qui sert à changer de ligne sur le tableau
Évaluer s'il faut diviser	Tableau d'aide à la décision	Ne divisez pas en cas de dépendances mutuelles, de modifications sur le même fichier ou pour des tâches triviales

Vous devriez maintenant être capable de : expliquer ce qu'apporte Agent teams, ses différences avec les subagents, utiliser l'écran de contrôle claude agents pour superviser plusieurs sessions en parallèle, piloter la création d'une équipe en langage naturel via le leader, et savoir clairement « quand diviser le travail et quand s'en abstenir ». Cette compétence de « chef de chantier » est votre meilleur atout pour paralléliser de grandes tâches sans perdre le contrôle de vos dépenses.

Soyons honnêtes — cela reste une fonctionnalité expérimentale ; l'interface et les raccourcis changent selon les versions, et une session unique reste amplement suffisante pour 90 % des tâches quotidiennes. Conservez-la comme un « accélérateur de grands chantiers » dans votre boîte à outils, sans chercher à diviser inutilement de petites tâches.

---

Le prochain article 30 « Choisir ses fonctionnalités : CLAUDE.md vs Skill vs Hook vs MCP vs Subagent » — À ce stade, vous avez découvert une multitude de fonctionnalités de Claude Code : CLAUDE.md, Skill, Hook, MCP, Subagent et Agent teams. Toutefois, connaître les outils ne suffit pas, le plus difficile étant de savoir lequel utiliser face à un besoin concret. Dans le prochain article, je vous proposerai un tableau décisionnel synthétisant les « limites et cas d'usage » de chaque fonctionnalité. Après cela, vous n'aurez plus jamais de doute sur l'outil à adopter face à un problème donné.

---

Lectures recommandées

• Guide d'utilisation de CLAUDE.md : graver les règles du projet dans sa mémoire
• Manuel de référence CLI : commandes et drapeaux
• Agent SDK : intégrer les capacités de Claude Code dans votre application