Agent Teams : le guide complet
Découvrez Agent Teams, la fonctionnalité expérimentale de Claude Code pour faire collaborer plusieurs agents sur un même projet. Configuration, cas d'usage et limites.
Qu'est-ce que Agent Teams ?
Agent Teams est une fonctionnalité expérimentale de Claude Code qui permet à plusieurs sessions d'agents de collaborer sur un même projet en partageant des informations et en coordonnant leurs actions. C'est comme passer d'un développeur solo à une équipe de développeurs spécialisés.
Fonctionnalité expérimentale (Research Preview)
Agent Teams est actuellement en research preview. Cela signifie que la fonctionnalité est disponible pour les utilisateurs avancés mais peut évoluer significativement. Activez-la avec la variable d'environnement CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Attendez-vous à des changements dans les futures versions.
L'analogie de l'open space
Imaginez un open space où chaque développeur travaille sur sa tâche, mais tous peuvent se parler, partager leurs avancées et se coordonner. Agent Teams fonctionne de la même façon : chaque agent a sa propre session Claude Code, mais ils partagent un espace de communication commun pour éviter les conflits et les doublons.
Activer Agent Teams
Pour activer cette fonctionnalité, définissez la variable d'environnement avant de lancer Claude Code.
# Activer Agent Teamsexport CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1# Puis lancer Claude Code normalementclaude
Vous pouvez aussi l'ajouter à votre fichier de configuration shell pour une activation permanente.
# Dans ~/.bashrc ou ~/.zshrcexport CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Comment configurer un team
Un team est un groupe d'agents qui travaillent ensemble sur un même projet. Chaque agent est identifié par un team_name commun qui permet la coordination.
Définir le team
Choisissez un nom de team descriptif. Tous les agents qui partagent ce nom pourront communiquer entre eux.
# Terminal 1 - Agent de développementclaude --team_name "feature-auth"# Terminal 2 - Agent de testsclaude --team_name "feature-auth"# Terminal 3 - Agent de reviewclaude --team_name "feature-auth"
Assigner les rôles
Donnez à chaque agent un rôle clair via son prompt initial. Les agents doivent savoir ce qu'ils font et ce que font les autres.
# Terminal 1 - Agent de développement> Tu es le développeur principal du team "feature-auth".> Ta mission : implémenter le module d'authentification JWT.> Un autre agent s'occupe des tests, un troisième fait la review.# Terminal 2 - Agent de tests> Tu es le testeur du team "feature-auth".> Ta mission : écrire les tests pour le module d'authentification.> Attends que le développeur ait commencé avant d'écrire les tests.# Terminal 3 - Agent de review> Tu es le reviewer du team "feature-auth".> Ta mission : review le code produit par le développeur et le testeur.> Interviens quand du code est prêt à être reviewé.
Laisser les agents collaborer
Les agents communiquent via un espace partagé. Ils peuvent voir les fichiers modifiés par les autres agents et coordonner leurs actions pour éviter les conflits.
Cas d'usage
1. Review croisée
Deux agents travaillent en tandem : l'un écrit le code, l'autre le review en temps réel.
# Agent 1 : Développeur> Implémente un système de cache Redis pour les sessions utilisateur.> Quand tu as terminé un module, signale-le pour review.# Agent 2 : Reviewer> Tu es le reviewer. Analyse chaque module produit par le développeur.> Signale les problèmes de sécurité, performance et maintenabilité.> Le développeur corrigera ensuite tes remarques.
Ce pattern crée une boucle de feedback continue : le développeur code, le reviewer identifie les problèmes, le développeur corrige, et ainsi de suite.
2. Développement parallèle
Plusieurs agents travaillent sur des modules indépendants du même projet.
# Agent 1 : Module API> Implémente les endpoints REST pour /users et /products.> Utilise Express.js avec validation Zod.# Agent 2 : Module Frontend> Implémente les pages React pour la liste des produits> et le profil utilisateur. Consomme l'API REST.# Agent 3 : Module Base de données> Crée les migrations Prisma pour les tables users et products.> Ajoute les seeds de développement.
Chaque agent travaille dans son domaine, mais ils restent coordonnés pour assurer la cohérence des interfaces.
3. Orchestration de pipeline
Un agent orchestre une séquence de tâches en déléguant à des agents spécialisés.
# Agent orchestrateur> Tu coordonnes le pipeline de release.> Étape 1 : Demande à l'agent tests de vérifier la couverture> Étape 2 : Demande à l'agent security de faire un audit> Étape 3 : Demande à l'agent docs de mettre à jour le changelog> Étape 4 : Si tout est vert, prépare le tag de release
Communication entre agents
Les agents d'un même team partagent un contexte commun qui leur permet de se coordonner.
| Mécanisme | Description |
|---|---|
| Fichiers partagés | Les agents voient les modifications de fichiers des autres en temps réel |
| État du projet | Chaque agent accède à l'état Git courant (branches, commits, diffs) |
| Messages | Les agents peuvent s'envoyer des messages via l'espace de communication du team |
Pas de mémoire partagée
Important : les agents ne partagent pas leur fenêtre de contexte. Chaque agent a son propre historique de conversation. La coordination passe par les fichiers, l'état Git et les messages du team, pas par un accès direct aux pensées des autres agents.
Limites actuelles
Agent Teams étant en research preview, plusieurs limitations existent.
Limites à connaître
- Pas de gestion automatique des conflits : si deux agents modifient le même fichier, vous devrez résoudre les conflits manuellement
- Consommation de tokens élevée : chaque agent consomme ses propres tokens, les coûts sont multipliés par le nombre d'agents
- Coordination imparfaite : les agents ne se synchronisent pas toujours parfaitement, des doublons peuvent survenir
- Pas de persistence entre sessions : quand une session se termine, le contexte de l'agent est perdu
- Support limité aux worktrees : l'isolation via worktrees n'est pas encore parfaitement intégrée aux teams
Bonnes pratiques
1. Limitez le nombre d'agents
Deux à trois agents bien configurés valent mieux que cinq agents mal coordonnés. Commencez petit.
# BON : 2 agents complémentaires# Développeur + Reviewer# À ÉVITER : trop d'agents# Développeur + Testeur + Reviewer + Doc + Security + Perf# → Trop de coordination nécessaire, résultats imprévisibles
2. Définissez des responsabilités claires
Chaque agent doit avoir un périmètre bien défini. Évitez les chevauchements de responsabilités.
3. Utilisez des branches séparées
Pour éviter les conflits de fichiers, assignez une branche Git par agent quand c'est possible.
# Agent 1 travaille sur feat/auth-api# Agent 2 travaille sur feat/auth-frontend# Agent 3 fait la review sur les deux branches
4. Surveillez la consommation
Avec plusieurs agents actifs, la consommation de tokens peut grimper rapidement. Surveillez votre utilisation et fixez des limites.
Perspectives
Agent Teams est encore jeune, mais les possibilités sont prometteuses :
- Gestion automatique des conflits : résolution intelligente des modifications concurrentes
- Orchestration déclarative : décrire un pipeline d'agents dans un fichier de configuration
- Mémoire partagée : un espace commun où les agents peuvent stocker et récupérer des informations
- Monitoring intégré : tableau de bord pour suivre l'activité de chaque agent en temps réel
Prochaines étapes
Maintenant que vous comprenez les Agent Teams, explorez les agents individuels et l'orchestration.
- Top agents par cas d'usage : Les agents les plus utiles classés par catégorie
- Orchestration avancée : Patterns d'orchestration pour des workflows complexes
- Comprendre les agents : Revenir aux fondamentaux