Agent Teams : plusieurs agents, un seul projet
Plusieurs instances de Claude Code peuvent travailler en Ă©quipe sur un projet â avec des rĂŽles, une liste de tĂąches partagĂ©e et des coĂ»ts en tokens nettement plus Ă©levĂ©s.
Deux façons de faire tourner plusieurs agents
La mĂ©thode manuelle : tu dĂ©marres plusieurs sessions Claude Code en parallĂšle, chacune dans son propre git worktree, pour que les changements ne se percutent pas. La mĂ©thode coordonnĂ©e, c'est ce qu'offre Claude Code avec les Agent Teams : une session devient le team lead, qui rĂ©partit les tĂąches et fusionne les rĂ©sultats ; les teammates travaillent indĂ©pendamment, chacun avec sa propre fenĂȘtre de contexte.
Comment travaille une équipe
L'Ă©quipe se coordonne via une liste de tĂąches partagĂ©e : le lead crĂ©e des tĂąches, les teammates les prennent en charge ou rĂ©cupĂšrent eux-mĂȘmes la prochaine disponible. Contrairement aux sous-agents, les teammates peuvent s'envoyer des messages directement entre eux â par exemple pour rĂ©futer mutuellement leurs hypothĂšses. Les Agent Teams sont expĂ©rimentales et dĂ©sactivĂ©es par dĂ©faut (en date de juillet 2026) ; elles doivent ĂȘtre activĂ©es via une variable d'environnement.
RĂŽles typiques
Des schĂ©mas Ă©prouvĂ©s d'aprĂšs la doc : un writer implĂ©mente, un reviewer vĂ©rifie avec un regard neuf. Ou plusieurs reviewers examinent la mĂȘme pull request sous des angles diffĂ©rents (sĂ©curitĂ©, performance, couverture de tests). Ou plusieurs agents poursuivent des hypothĂšses concurrentes en debugging et tentent de se rĂ©futer mutuellement.
L'avertissement sur les coûts
Chaque teammate est une instance Claude distincte avec sa propre fenĂȘtre de contexte â les coĂ»ts augmentent avec la taille de l'Ă©quipe. Le blog d'ingĂ©nierie d'Anthropic chiffre les systĂšmes multi-agents Ă environ 15 fois les tokens d'un chat normal. Pour des tĂąches sĂ©quentielles ou des modifications du mĂȘme fichier, une session unique reste gĂ©nĂ©ralement le meilleur choix.
EXEMPLE
Prompt au team lead : « Lance trois teammates pour la review de la PR #142 â l'un vĂ©rifie la sĂ©curitĂ©, l'un la performance, l'un la couverture de tests. Rassemble ensuite tous les rĂ©sultats et rĂ©sume-les. »
QUIZ RAPIDE
Qu'est-ce qui distingue les Agent Teams des sous-agents dans Claude Code ?
SOURCES
- Doc Claude Code : Agent Teams â code.claude.com
- Anthropic Engineering: Multi-Agent Research System â www.anthropic.com
- Doc Claude Code : Subagents â code.claude.com
- Doc Claude Code : Git Worktrees â code.claude.com