# Qu’est-ce qu’un sous-agent ?

URL: https://agentvera.dev/fr/glossary/subagent/

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.

- **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.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/