Qu’est-ce qu’un sous-agent ?
Un sous-agent est un agent auxiliaire que lance un agent de codage principal pour lui déléguer une tâche précise. Il a sa propre fenêtre de contexte, ses instructions et ses autorisations d’outils, et à la fin il ne renvoie qu’un résumé, si bien que la conversation principale ne se remplit pas de détails.
Comment ça marche
L’agent principal confie une tâche à un sous-agent, comme chercher dans la base de code, lancer des tests et résumer les échecs, ou relire une modification. Le sous-agent démarre avec un contexte vierge ; les fichiers qu’il lit et la sortie des commandes qu’il voit restent dans sa propre fenêtre, et l’agent principal ne reçoit que le résultat. Plusieurs sous-agents peuvent tourner en même temps.
Définir des sous-agents dans Claude Code
Dans Claude Code, les sous-agents sont des fichiers Markdown avec un frontmatter YAML. Les sous-agents du projet vivent dans .claude/agents/ et les personnels dans ~/.claude/agents/ ; vous pouvez aussi les gérer avec la commande /agents.
- name et description : le nom du sous-agent et quand l’utiliser. L’agent principal décide d’après cette description.
- tools : les outils qu’il peut utiliser, par exemple uniquement des outils de lecture pour un relecteur.
- model : en option, un autre modèle pour le sous-agent.
- Le corps du fichier est le prompt système du sous-agent.
Quand les sous-agents aident
Les sous-agents sont les plus utiles quand vous voulez garder la conversation principale propre.
- Une recherche qui lit beaucoup de fichiers : le détail reste dans le sous-agent et le contexte principal reste petit.
- Des rôles de spécialistes : revue de sécurité, écriture de tests, documentation.
- Exploration en parallèle : plusieurs sous-agents parcourent des modules différents en même temps.
Limites
Un sous-agent ne voit pas l’historique de la conversation principale, donc la tâche qu’on lui donne doit se suffire à elle-même. Comme chaque sous-agent construit son contexte de zéro, la consommation totale de tokens peut augmenter. Les sous-agents travaillent en général dans le même dossier que l’agent principal, donc des sous-agents parallèles qui modifient des fichiers peuvent se gêner.
Les sous-agents dans AgentVera
AgentVera rend visibles les sous-agents lancés par Claude Code. La vue Subagents de la fenêtre de visite du projet et de carte du code liste les sous-agents lancés par un agent Claude Code.
- Pour chacun : le type, s’il a tourné en arrière-plan, l’état, le nombre d’outils et la durée, plus une chronologie de ses étapes.
- Elle lit les transcriptions locales et fonctionne pour l’instant avec les agents Claude Code locaux.
- La task line, la vue d’équipe et la parallel team utilisent des agents séparés et visibles au lieu de sous-agents : chacun a son propre volet et sa conversation, et vous pouvez lui parler directement.
- Visite du projet et carte du codeDécouvrez un projet grâce à une visite guidée, voyez les dépendances entre modules et les fichiers qui cassent le plus.
- Chaîne de tâchesMettez des tâches en file et laissez chacune passer par les agents Analysis, Plan, Build et Review, dans l’ordre.
- Vue d’équipeTransformez vos agents ouverts en équipe avec un manager, des rôles et des liens hiérarchiques, puis regardez-la travailler en direct.
FAQ
En quoi un sous-agent diffère-t-il d’une session d’agent séparée ?
L’agent principal lance un sous-agent et récupère son résultat ; vous ne voyez en général que le résumé. Une session séparée tourne de son côté et vous lui parlez directement.
Les sous-agents économisent-ils des tokens ?
Ils gardent petit le contexte de la conversation principale, ce qui aide dans les longues sessions. Mais la lecture du sous-agent coûte aussi des tokens, donc la consommation totale peut augmenter.
Un sous-agent peut-il modifier des fichiers ?
Cela dépend des outils que sa définition autorise. Un sous-agent qui n’a que Read, Grep et Glob peut lire le code mais pas le modifier.
Où ranger les fichiers de sous-agents ?
Ceux que votre équipe doit partager vont dans .claude/agents/ du projet ; ceux que vous seul utilisez vont dans ~/.claude/agents/. Les fichiers du dossier du projet parviennent à votre équipe via git.