Un sous-agent de Claude Code fait le travail salissant ailleurs et ne vous rend que le résumé.
C’est sa raison d’être, et la documentation la dit simplement. Vous en lancez un quand une tâche annexe noierait votre conversation. Des résultats de recherche, des journaux, des fichiers que vous ne relirez jamais.
Ce qu’il économise, c’est votre contexte. Pas vos jetons.
Ce qu’il est vraiment
Chaque sous-agent tourne dans sa propre fenêtre de contexte. Il a son prompt système, ses outils et ses autorisations propres.
Sa fenêtre est dimensionnée par son modèle à lui, pas par celui du parent. Un petit modèle donne un petit contexte, même quand la session qui le lance en a un grand.
Et chaque invocation crée une instance neuve. On ne reprend pas un sous-agent, on en lance un autre.
Le coût, et ce qu’il recouvre
Anthropic l’écrit sans détour. Un sous-agent envoie ses propres requêtes, et elles comptent dans les mêmes limites d’usage que la conversation principale.
La confusion est facile à faire. Économiser du contexte et économiser de l’argent, ce n’est pas la même ligne.
La phrase à dire en interne tient en une ligne. Le sous-agent sort le travail de votre fenêtre, il ne le sort pas de vos limites d’usage.
Ce qu’il voit en démarrant
Son contexte initial n’est pas vide, et c’est la partie qu’on découvre en pratique.
Il contient tous les niveaux de la hiérarchie CLAUDE.md que charge la conversation principale. Une photo de l’état Git de votre dépôt. Le contenu complet des skills nommés dans sa définition. Et la liste des autres agents nommés de la session.
Conséquence directe pour une équipe. Vos conventions écrites une fois dans CLAUDE.md profitent à chaque sous-agent lancé, sans que personne ait à les recopier.
La documentation, relevée le 29 septembre 2026, énumère ce que contient son contexte initial. L’historique de votre conversation n’y figure pas.
Les outils, et le filtre qu’on ne voit pas venir
Un sous-agent hérite des outils de la conversation principale, puis deux filtres se referment.
Le premier retire une courte liste d’outils à tout sous-agent, même si la définition les demande. Les outils qui posent une question à l’humain en font partie. C’est logique pour un agent censé travailler seul.
Le sous-agent fait avec ce que la consigne lui a dit. Comme un stagiaire avec un mot sur le bureau.
Le second filtre est celui qui surprend. Il s’applique aux sous-agents lancés en arrière-plan, et l’arrière-plan est le mode par défaut. Ces sous-agents gardent tous les outils MCP, mais seulement une liste réduite d’outils intégrés.
Un sous-agent n’est donc pas équipé comme votre session principale. Si le vôtre échoue sur un outil que vous utilisez tous les jours, commencez par là.
Où on les définit
Cinq emplacements, avec un ordre de priorité. Quand deux définitions portent le même nom, c’est celle de l’emplacement le plus prioritaire qui gagne.
Les réglages gérés par l’organisation passent en premier. Puis le drapeau --agents de la session. Puis le dossier .claude/agents/ du projet. Puis ~/.claude/agents/, valable pour tous vos projets. Puis le dossier agents/ d’un plugin.
Pour une équipe, un seul de ces cinq emplacements compte. .claude/agents/ vit dans le dépôt, donc tout le monde l’a. Une définition améliorée profite à tous au prochain git pull.
Un fichier de définition, c’est un frontmatter en YAML puis le prompt système en Markdown. Rien de plus.
Le nom, et ce qu’il déclenche
Claude peut donner un nom à un sous-agent, de lui-même, sans vous demander. Le nom permet de s’adresser à lui. Claude peut lui écrire ou le reprendre par ce nom après qu’il a fini.
Une ligne à connaître si vous activez les équipes d’agents. Un sous-agent que Claude nomme se lance alors comme coéquipier. Une équipe peut donc se former sans que personne l’ait demandée. Le détail est dans Claude Code en équipe.
Les limites, écrites par Anthropic
Vingt sous-agents en parallèle. Au-delà, la création échoue avec un message explicite.
Les sous-agents travaillent dans une seule session. Pour faire dialoguer des sessions séparées, ce n’est plus le bon outil.
Les agents intégrés d’exploration et de planification ne tournent qu’une fois. Ils ne rendent pas d’identifiant, donc Claude ne peut pas les reprendre.
Et une limite qui vous rattrape quand la bibliothèque grossit. Les descriptions de vos sous-agents occupent du contexte. Le seuil est de 15 000 jetons de descriptions cumulées, les intégrées exclues. Au-delà, Claude Code affiche un avertissement au démarrage.
Ce seuil est un bon indicateur de santé. Des définitions longues occupent du contexte à chaque session, y compris celles que personne n’utilise ce jour-là.
Sous-agent ou coéquipier
La documentation tranche, et le critère est simple.
Le sous-agent quand seul le résultat compte. Il rend son résultat à celui qui l’a lancé. Il coûte moins cher, puisque ce résultat revient résumé.
Le coéquipier quand les agents doivent se partager ce qu’ils trouvent, se contredire et se coordonner seuls. Il coûte plus cher, puisque chacun est une instance complète.
Les deux mécanismes et la règle de relecture qui va avec sont détaillés dans Claude Code en équipe.
Ce qu’on en fait concrètement
Le cas qui rend service dès la première semaine est la revue à plusieurs angles. Un relecteur seul creuse l’angle qu’il a pris en premier. Trois sous-agents avec chacun sa consigne couvrent la sécurité, la performance et les tests.
Le second cas est la recherche. Une exploration de dépôt produit des centaines de lignes que vous ne relirez pas. C’est exactement ce que le sous-agent est fait pour absorber.
C’est ce qu’on monte pendant la formation Claude Code, sur vos dépôts. Les définitions repartent versionnées dans le projet.
Source relevée le 29 septembre 2026, la documentation des sous-agents d’Anthropic.