Claude Code lance le mode équipe ! Vous devez absolument utiliser les Agent Teams !
Claude Code vient de lancer une autre fonctionnalité majeure : Agent Teams, qui peut être compris comme une version super renforcée des Sub Agents ~ Voici une comparaison entre Agent Teams et Subagents :
Je l'ai déjà essayé ! (Très agréable ! Très agréable ! Très agréable !)
Conditions pour activer Agent Teams :
1. Mettez à jour Claude Code à la dernière version (claude update)
2. Ajoutez cette ligne dans settings.json :
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 3. Redémarrez Claude Code ~
4. Utilisez ensuite le langage naturel pour demander à Claude Code de créer un Agent Team (bien sûr, expliquez clairement ce que l'Agent Team doit faire)
De plus, les autres modèles n'affectent pas le travail d'Agent Teams (j'utilise KIMi for coding)
Pour plus de détails sur Agent Teams, voir ci-dessous (article officiel d'Anthropic) !
Agent Teams vous permet de coordonner plusieurs instances de Claude Code pour travailler ensemble. Une session agit en tant que leader, coordonnant le travail, attribuant les tâches et synthétisant les résultats. Les membres travaillent indépendamment, chacun dans sa propre fenêtre de contexte, et peuvent communiquer directement entre eux.
Contrairement aux sous-agents (Subagents) qui fonctionnent dans une seule session et ne peuvent rapporter qu'au leader, vous pouvez également interagir directement avec un membre individuel sans passer par le leader.
Ce document couvre :
• Quand utiliser Agent Teams, y compris les meilleurs cas d'utilisation et la comparaison avec les sous-agents
• Lancer une équipe
• Contrôler les membres, y compris les modes d'affichage, l'attribution des tâches et la délégation
• Meilleures pratiques pour le travail parallèle
Quand utiliser Agent Teams
Agent Teams est le plus efficace pour les tâches où l'exploration parallèle ajoute une réelle valeur. Les cas d'utilisation les plus puissants incluent :
• Recherche et revue —— Plusieurs membres peuvent enquêter simultanément sur différents aspects d'un problème, puis partager et défier mutuellement leurs découvertes
• Nouveaux modules ou fonctionnalités —— Les membres peuvent posséder des parties indépendantes, sans interférence
• Débogage avec hypothèses concurrentes —— Les membres testent parallèlement différentes théories, trouvant plus rapidement la réponse
• Coordination intercouches —— Modifications transversales front-end, back-end et tests, chacune prise en charge par un membre différent
Agent Teams ajoute une surcharge de coordination (Osez-vous utiliser Opus4.6 pour ouvrir Agent Teams🤣), augmentant significativement la consommation de tokens par rapport à une session unique. Ils sont plus efficaces lorsque les groupes peuvent fonctionner indépendamment. Pour les tâches séquentielles, l'édition de fichiers uniques ou les travaux avec de nombreuses dépendances, une session unique ou des sous-agents sont plus efficaces.
Comparaison avec les sous-agents
Agent Teams et les sous-agents vous permettent de travailler en parallèle, mais ils fonctionnent différemment. Choisissez en fonction de si vos travailleurs doivent communiquer entre eux :
Sous-agents
Agent Teams
Contexte
Leur propre fenêtre de contexte ; les résultats sont retournés à l'appelant
Leur propre fenêtre de contexte ; complètement indépendants
Communication
Ne rapportent les résultats qu'au leader
Les membres s'envoient directement des messages
Coordination
Le leader gère tout le travail
Liste de tâches partagée, auto-coordination
Le plus adapté
Tâches ciblées où seuls les résultats comptent
Travaux complexes nécessitant discussion et collaboration
Coût en tokens
Plus faible : les résultats sont résumés dans le contexte principal
Plus élevé : chaque membre est une instance indépendante de Claude
Utilisez les sous-agents lorsque vous avez besoin de travailleurs rapides et ciblés rapportant des résultats. Utilisez Agent Teams lorsque le groupe a besoin de partager des découvertes, de se défier mutuellement et de s'auto-coordonner.
Activer Agent Teams
Agent Teams est désactivé par défaut. Activez-le en définissant la variable d'environnement CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS à 1, soit dans l'environnement shell, soit via settings.json :
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}Lancer votre premier Agent Team
Une fois Agent Teams activé, dites à Claude de créer un Agent Team, en utilisant le langage naturel pour décrire la tâche et la structure d'équipe souhaitée. Claude crée l'équipe, génère les membres et coordonne le travail en fonction de votre prompt.
Cet exemple fonctionne bien car les trois rôles sont indépendants et peuvent explorer le problème sans attendre les autres :
Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Créez une équipe d'agents pour explorer ceci sous différents angles : un membre pour l'UX, un pour l'architecture technique, un jouant le rôle de l'avocat du diable.)
De là, Claude crée une équipe avec une liste de tâches partagée, génère des membres pour chaque perspective, les laisse explorer le problème, synthétise les découvertes et tente de nettoyer l'équipe une fois terminé.
Le terminal du leader liste tous les membres et leur contenu de travail. Utilisez Shift+Haut/Bas pour sélectionner un membre et lui envoyer directement un message.
Contrôler votre Agent Team
Utilisez le langage naturel pour dire au leader ce que vous voulez. Il gère la coordination de l'équipe, l'attribution des tâches et la délégation selon vos instructions.
Sélectionner le mode d'affichage
Agent Teams supporte deux modes d'affichage :
• Mode dans le processus —— Tous les membres fonctionnent dans votre terminal principal. Utilisez Shift+Haut/Bas pour sélectionner un membre et taper directement pour envoyer un message. Fonctionne avec n'importe quel terminal, sans configuration supplémentaire.
• Mode écran divisé —— Chaque membre a son propre panneau. Vous pouvez voir simultanément la sortie de tous, cliquez sur un panneau pour interagir directement. Nécessite tmux ou iTerm2.
Le mode par défaut est "auto", utilisant l'écran divisé si vous êtes déjà dans une session tmux, sinon le mode dans le processus.
Pour forcer le mode dans le processus pour une session unique, passez le drapeau :
claude --teammate-mode in-processSpécifier les membres et les modèles
Claude décide combien de membres générer en fonction de votre tâche, ou vous pouvez spécifier exactement ce que vous voulez :
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Créez une équipe de 4 membres pour refactoriser ces modules en parallèle. Utilisez Sonnet pour chaque membre.)
Demander l'approbation du plan des membres
Pour les tâches complexes ou risquées, vous pouvez demander aux membres de planifier avant de mettre en œuvre. Les membres travaillent en mode planification en lecture seule jusqu'à ce que le leader approuve leur méthode :
Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Générez un membre architecte pour refactoriser le module d'authentification. Exigez l'approbation du plan avant qu'ils ne fassent des changements.)
Lorsqu'un membre termine le plan, il envoie une demande d'approbation du plan au leader. Le leader examine le plan et approuve ou rejette avec des commentaires.
Utiliser le mode délégation
Sans le mode délégation, le leader commence parfois à mettre en œuvre lui-même des tâches au lieu d'attendre que les membres terminent. Le mode délégation empêche cela en limitant le leader à des outils de coordination uniquement. Appuyez sur Shift+Tab pour basculer en mode délégation.
Converser directement avec un membre
Chaque membre est une session complète et indépendante de Claude Code. Vous pouvez envoyer directement un message à n'importe quel membre :
• Mode dans le processus : Utilisez Shift+Haut/Bas pour sélectionner un membre, puis tapez pour envoyer un message. Appuyez sur Entrée pour voir la session du membre, puis sur Échap pour interrompre son tour actuel. Appuyez sur Ctrl+T pour basculer la liste des tâches.
• Mode écran divisé : Cliquez sur le panneau d'un membre pour interagir directement avec sa session.
Attribuer et revendiquer des tâches
La liste de tâches partagée coordonne le travail de l'équipe. Le leader crée les tâches, les membres les accomplissent. Les tâches ont trois états : en attente, en cours, terminées. Les tâches peuvent aussi dépendre d'autres tâches.
Le leader peut attribuer explicitement des tâches, ou les membres peuvent les revendiquer eux-mêmes après avoir terminé.
Fermer un membre
Pour terminer gracieusement la session d'un membre :
Ask the researcher teammate to shut down
(Demandez au membre chercheur de s'arrêter)
Le leader envoie une demande d'arrêt. Le membre peut approuver et quitter gracieusement, ou refuser et expliquer pourquoi.
Nettoyer l'équipe
Une fois terminé, demandez au leader de nettoyer :
Clean up the team
(Nettoyer l'équipe)
Cela supprime les ressources partagées de l'équipe. Lorsque le leader exécute le nettoyage, il vérifie les membres actifs, échouant s'il y en a encore en cours, donc fermez-les d'abord.
Comment fonctionne Agent Teams
Architecture
Un Agent Team comprend :
• Leader : La session principale de Claude Code qui crée l'équipe, génère les membres et coordonne le travail
• Membres : Instances indépendantes de Claude Code, chacune traitant des tâches attribuées
• Liste de tâches : Liste partagée des éléments de travail que les membres revendiquent et accomplissent
• Boîte aux lettres : Système de messagerie pour la communication entre agents
Le système gère automatiquement les dépendances des tâches. L'équipe et les tâches sont stockées localement :
• Configuration de l'équipe :
~/.claude/teams/{team-name}/config.json• Liste de tâches :
~/.claude/tasks/{team-name}/
Contexte et communication
Chaque membre a sa propre fenêtre de contexte. Lors de la génération, les membres chargent le même contexte de projet qu'une session régulière : CLAUDE.md, serveurs MCP et compétences. L'historique de conversation du leader n'est pas transmis.
Comment les membres partagent l'information :
• Messagerie automatique : Lorsqu'un membre envoie un message, il est automatiquement transmis au destinataire
• Notification d'inactivité : Lorsqu'un membre termine et s'arrête, il notifie automatiquement le leader
• Liste de tâches partagée : Tous les agents peuvent voir l'état des tâches et revendiquer le travail disponible
Utilisation des tokens
Agent Teams augmente significativement la consommation de tokens par rapport à une session unique. Chaque membre a sa propre fenêtre de contexte, et l'utilisation de tokens augmente avec le nombre de membres actifs. Pour la recherche, la revue et les nouveaux travaux fonctionnels, les tokens supplémentaires en valent généralement la peine. Pour les tâches régulières, une session unique est plus rentable.
Exemples de cas d'utilisation
Exécuter une revue de code parallèle
Un seul réviseur a tendance à se concentrer sur un type de problème à la fois. Diviser les critères de revue en domaines indépendants signifie que la sécurité, les performances et la couverture des tests sont examinées simultanément et de manière approfondie.
Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Créez une équipe d'agents pour revoir le PR #142. Générez trois réviseurs : un se concentrant sur les implications de sécurité, un vérifiant l'impact sur les performances, un validant la couverture des tests. Laissez-les chacun revoir et rapporter les découvertes.)
Enquêter avec des hypothèses concurrentes
Lorsque la cause racine n'est pas claire, un agent unique a tendance à trouver une explication plausible et à cesser de chercher.
Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.Meilleures pratiques
Donner suffisamment de contexte aux membres
Les membres chargent automatiquement le contexte du projet, mais n'héritent pas de l'historique de conversation du leader. Incluez des détails spécifiques à la tâche dans le prompt de génération.
Ajuster la taille des tâches de manière appropriée
• Trop petite : La surcharge de coordination dépasse les bénéfices
• Trop grande : Les membres travaillent trop longtemps sans vérification, augmentant le risque d'effort gaspillé
• Juste : Unité autonome produisant un livrable clair
Attendre que les membres terminent
Parfois, le leader commence à mettre en œuvre lui-même des tâches au lieu d'attendre que les membres terminent. Si vous remarquez cela :
Wait for your teammates to complete their tasks before proceeding
(Attendez que vos membres terminent leurs tâches avant de continuer)
Éviter les conflits de fichiers
Deux membres modifiant le même fichier peuvent entraîner des écrasements. Divisez le travail pour que chaque membre possède un ensemble différent de fichiers.
Surveiller et guider
Vérifiez la progression des membres, redirigez les méthodes inefficaces et synthétisez les découvertes au fur et à mesure.
Limitations
Agent Teams est expérimental. Limitations actuelles :
• Les membres dans le processus ne supportent pas la reprise de session : /resume et /rewind ne restaureront pas les membres dans le processus
• L'état des tâches peut être en retard : Les membres ne marquent parfois pas les tâches comme terminées
• La fermeture peut être lente : Les membres terminent leur demande actuelle avant de s'arrêter
• Une équipe par session : Un leader ne peut gérer qu'une équipe à la fois
• Pas de support pour les équipes imbriquées : Les membres ne peuvent pas générer leurs propres équipes
• Leader fixe : La session qui crée l'équipe reste leader pendant sa durée de vie
• L'écran divisé nécessite tmux ou iTerm2 : Pas de support pour le terminal intégré de VS Code, Windows Terminal ou Ghostty
