Un sous-agent coûte avant d'avoir travaillé

Un sous-agent coûte avant d'avoir travaillé, car sa conversation contient déjà des éléments que vous n'avez pas écrits et que chaque lancement recharge. Sans champ tools, il hérite de tous les outils ; sans modèle nommé, il tourne sur le même modèle que vous. Listez ses outils et nommez son modèle selon son rôle.

Un sous-agent est une conversation séparée que Claude Code ouvre pour une tâche. Avant sa première instruction, cette conversation contient déjà des éléments que vous n'avez pas écrits, et chaque lancement les recharge. Le coût d'un sous-agent se compose donc de ce démarrage et du travail demandé.

Ce que contient un sous-agent au départ

La documentation des sous-agents liste, entre autres, ce qu'il reçoit : son propre prompt système avec les informations d'environnement, tous les niveaux de fichiers CLAUDE.md que la conversation principale charge, le contenu intégral des skills nommées dans son champ skills, les serveurs MCP de son champ mcpServers, et le début de son fichier de mémoire si la mémoire est activée. Pour les outils, la règle est inverse de ce qu'on suppose : le champ tools omis laisse le sous-agent hériter de tous les outils disponibles. Plus il y a de pièces au départ, plus le premier appel pèse.

Un agent personnalisé aux outils listés

Un fichier placé dans .claude/agents/ définit un agent que Claude peut lancer par son nom. Celui-ci ne garde que ce que sa tâche exige :

---
name: lecteur
description: Lit des fichiers et rapporte ce qu'ils contiennent, sans rien modifier.
tools: Read, Grep, Glob
model: haiku
---
Tu lis les fichiers demandés et tu rapportes les faits trouvés, avec le nom du fichier.
Tu ne juges pas et tu ne modifies rien.

Les trois outils listés sont les seuls que cet agent peut utiliser, et model: haiku lui donne un petit modèle. La documentation précise que Claude Code surveille ces dossiers et prend en compte un fichier ajouté ou modifié en quelques secondes ; après la création du tout premier fichier d'un dossier agents, un redémarrage de la session est nécessaire.

Nommer le modèle selon le rôle

Sans modèle nommé, la documentation donne cet ordre : le paramètre de l'appel, puis le champ model de la définition, puis la variable CLAUDE_CODE_SUBAGENT_MODEL, puis le modèle de la conversation principale. Un sous-agent qui n'a rien reçu d'autre tourne donc sur le même modèle que vous, sans que rien ne le signale au lancement ; la commande /tasks affiche le modèle sur la ligne du sous-agent. Une collecte mécanique (lire, lister, extraire) peut se confier à un petit modèle ; la rédaction et l'analyse à un modèle moyen ; le juge, qui doit réfuter, au plus capable. Le niveau d'effort se règle de la même façon : l'outil Agent accepte un paramètre effort pour un lancement donné, et la définition d'un agent peut fixer le sien.

Mesurer avant de conclure

Le poids réel de chaque pièce se lit chez vous, pas dans une moyenne. La leçon sur la facture montre où lire la consommation par poste ; appliquez-la à un sous-agent par défaut, puis au même travail confié à l'agent restreint.

Figure 1

Quel modèle prend un sous-agent, dans l'ordre

Rang	Source du modèle
1	Le paramètre model de l'appel lui-même.
2	Le champ model de la définition de l'agent (inherit désigne le modèle principal).
3	La variable CLAUDE_CODE_SUBAGENT_MODEL, si elle est posée.
4	Le modèle de la conversation principale.

Le tableau classe les quatre sources qui décident du modèle d'un sous-agent, de la plus forte à la plus faible.

Figure 2

Deux définitions d'agent pour la même tâche de lecture

Agent par défaut

Pas de champ tools ni model : tous les outils disponibles, et le modèle de la conversation principale.

Agent restreint

tools: Read, Grep, Glob et model: haiku : trois outils et un petit modèle pour une tâche qui ne fait que lire.

La colonne de gauche laisse tout par défaut, la colonne de droite fixe les outils et le modèle dans le fichier de l'agent.

Calibrez vous-même

Une équipe configure une session Claude Code avec un fichier CLAUDE.md volumineux et plusieurs serveurs MCP. Elle lance cinq sous-agents pour lire cinq fichiers de configuration, puis relève sur /cost un total de 4,20 dollars pour cette tâche de lecture.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Votre réponse, avant de voir le corrigé

Ce qu’il faut retenir

Un sous-agent reçoit au départ son prompt, les fichiers CLAUDE.md, les skills et serveurs MCP qu'on lui nomme, et chacun pèse dès le premier appel.
Un champ tools omis donne à l'agent tous les outils disponibles : restreindre est un acte explicite.
Sans modèle nommé, un sous-agent tourne sur le modèle de la conversation principale, rien ne le signale au lancement, et /tasks l'affiche.
Le modèle se répartit par rôle : petit pour collecter, moyen pour rédiger, le plus capable pour juger.
Le coût de démarrage d'un agent se mesure sur la même tâche confiée à un agent par défaut puis à un agent restreint.

À faire maintenant

Créez un dossier d'essai vide, ajoutez-y un fichier notes.txt de trois lignes, puis un fichier .claude/agents/lecteur.md copié de l'exemple. Lancez Claude Code dans ce dossier, demandez à l'agent lecteur de rapporter le contenu de notes.txt, puis tapez /cost et notez la ligne. Refaites la même demande à un sous-agent sans nom, dans une session neuve, et comparez les deux lignes.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.

Claude Code, sous-agents : modèle, outils et contexte de départ consultée le 2026-10-24
Journal de Claude Code, version 2.1.292, paramètre effort de l'outil Agent consultée le 2026-10-24