Claude Code Agent Teams - De la configuration aux raccourcis

Claude Code Agent Teams a ete lance en meme temps que la sortie d’Opus 4.6. Honnêtement, je trouve la fonctionnalite peu efficiente a ce stade - la consommation de tokens est elevee et la charge de coordination bien reelle.

Mais apres avoir lu le guide de Tom (@tomcrawshaw01), j’ai realise que l’architecture elle-meme merite d’etre comprise. Se familiariser avec elle pendant la phase de previsualisation fera la difference quand elle passera en disponibilite generale.

Les agents solo forment desormais des equipes

Un agent leader decompose le travail et le distribue a plusieurs coequipiers qui s’executent en parallele.

La difference fondamentale avec les sous-agents : les coequipiers communiquent directement entre eux. Au lieu de simplement rapporter les resultats au leader, ils partagent leurs conclusions et vont jusqu’a remettre en question le travail des autres.

La configuration prend 30 secondes

La fonctionnalite est experimentale, donc desactivee par defaut. Une seule ligne suffit pour l’activer.

Ajoutez CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS avec la valeur "1" dans le bloc env de votre settings.json. Vous pouvez aussi le definir comme variable d’environnement shell, mais settings.json persiste entre les sessions et reste plus pratique.

Les seuls raccourcis a connaître

Une fois l’equipe en marche, vous basculerez entre le leader et les coequipiers pour suivre la progression. Il n’y a pas grand-chose a memoriser.

• Shift+Up / Shift+Down - Basculer entre les coequipiers (mode in-process - c’est ce que vous utiliserez la plupart du temps)
• Enter - Afficher les details de la session du coequipier selectionne
• Escape - Interrompre le tour en cours du coequipier selectionne
• Ctrl+T - Afficher ou masquer la liste des taches partagee
• Shift+Tab - Activer le mode Delegate, qui restreint le leader a la coordination uniquement (pas de code)
• Mode split-pane - Cliquer sur le panneau d’un coequipier pour interagir directement

Le mode Delegate est important. Sans lui, le leader se met parfois a coder au lieu de deleguer aux coequipiers.

La compatibilite terminale varie

Le mode split-pane ne fonctionne que dans tmux et iTerm2. Le terminal integre de VS Code, Windows Terminal et Ghostty ne sont pas officiellement pris en charge.

Si vous travaillez dans Ghostty, vous utiliserez le mode in-process par defaut avec Shift+Up/Down pour basculer entre les coequipiers.

Pour visualiser la sortie des coequipiers cote a cote, lancez Claude Code a l’interieur d’une session tmux. La valeur par defaut de teammateMode est "auto", ce qui active automatiquement le mode split-pane lorsque tmux est detecte.

Personnellement, j’utilise tmux new -s {my-project} dans iTerm, puis je lance avec claude --teammate-mode tmux. Cela offre une vue plein ecran de toute l’activite de l’equipe.

Comment les taches circulent

Le travail s’organise autour d’une liste de taches. Le leader cree les taches et les coequipiers les prennent en charge.

• Lorsque le leader cree une liste de taches, les coequipiers revendiquent automatiquement la prochaine tache non attribuee
• Les dependances entre taches sont prises en charge - les taches successeurs ne se debloquent qu’une fois les taches predecesseurs terminees
• Vous pouvez assigner des taches specifiques a des coequipiers specifiques en le disant au leader
• L’arret des coequipiers suit un protocole : le leader envoie une demande d’arret, le coequipier confirme, puis quitte la session
• Nettoyage complet : confirmez que tous les coequipiers se sont arretes, puis demandez au leader de faire le menage

Un simple prompt mentionnant “team” activera la fonctionnalite automatiquement. Mais pour un controle plus precis, definissez le nombre total de coequipiers, attribuez un nom et un role a chacun, fixez le perimetre de delegation, et fournissez un fichier externe avec les regles de dependance entre les taches.

Les tokens s’epuisent plus vite que prevu

Chaque coequipier est une session Claude Code independante. Les executer en parallele fait monter les couts rapidement. Quelques pratiques aident a les contenir.

• Redigez des prompts de creation precis pour les coequipiers. L’historique de conversation du leader ne se transmet pas - seuls CLAUDE.md et le contexte du serveur MCP se chargent automatiquement
• Deux coequipiers modifiant le meme fichier provoqueront des ecrasements. Partitionnez le travail au niveau du fichier
• Commencez par de la recherche ou de la revue de code plutot que par de la generation de code. La complexite de coordination est moindre
• Gardez les unites de taches petites et concretes - une seule fonction ou un seul fichier de test fonctionne bien

Les limitations a connaître avant de les rencontrer

Il s’agit d’une version de previsualisation. Des imperfections sont a prevoir. Les connaître a l’avance evite bien des frustrations.

• Utiliser /resume ou /rewind supprime les coequipiers in-process. Vous devrez demander au leader d’en creer de nouveaux
• Le statut des taches peut accuser un retard. Si un coequipier termine son travail sans marquer la tache comme terminee, les taches successeurs restent bloquees. Verifiez manuellement et demandez au leader de mettre a jour
• Une seule equipe par session. Les coequipiers ne peuvent pas creer de sous-equipes
• La session qui cree l’equipe reste le leader. Vous ne pouvez pas changer de leader ni promouvoir un coequipier en cours de session

La version de previsualisation est brute et la question du rapport cout-efficacite reste ouverte. Mais si vous voulez comprendre ou se dirigent les workflows multi-agents, le moyen le plus rapide est de l’activer et de l’essayer par vous-meme. Les outils necessitent une experience pratique pour etre correctement evalues.