Les sous-agents : déléguer une recherche

Cette leçon est encore en test : elle s'améliore avec les retours des apprenants. Si quelque chose n'est pas clair, c'est la leçon qu'il faut corriger, pas toi.

À la fin de cette leçon, tu sauras

dire ce qu’est un sous-agent, et quand il est utile ;
déléguer une recherche à un sous-agent, et vérifier son résumé ;
créer un sous-agent à toi, en lecture seule ;
choisir entre sous-agent, skill et conversation principale.

Pourquoi ça t’intéresse

Quand Claude cherche dans beaucoup de fichiers, ta conversation se remplit de résultats que tu ne reliras jamais. Elle devient longue, lente, et Claude suit moins bien ce qui compte. Un sous-agent fait la recherche à part, puis ne te rend que l’essentiel. C’est une délégation : utile, à condition de vérifier le résultat.

Avant de commencer


Il te faut	Claude Code (appli ou terminal), en mode Manuel, et ton dossier mon-espace-ia avec quelques notes ou documents
Coût	L’abonnement de l’agent : Claude Pro au minimum, 18 € par mois hors taxes, prix affiché en France au 24/10/2026. Un sous-agent consomme ta limite d’usage comme ta conversation
Durée	35 minutes
Rappel	Le sous-agent lit tes fichiers comme Claude : rien de la liste « jamais » dans ton dossier

Comprendre en 3 minutes

Un sous-agent est un assistant spécialisé que Claude lance pour une tâche, d’après la documentation (24/10/2026) :

il travaille dans son propre contexte et ne rend que le résumé ;
ses demandes comptent dans les mêmes limites d’usage que ta conversation ;
Claude Code en a déjà, par exemple Explore, qui cherche et lit, sans pouvoir écrire ni modifier ;
tu peux en créer un à toi : un fichier texte, avec un nom, une description et les outils qu’il a le droit d’utiliser.

Sous-agent, skill ou conversation ?

Choisis	Quand
La conversation principale	Un échange suivi, une petite correction, une tâche où chaque étape dépend de la précédente
Une skill (leçon 2)	Une façon de faire que tu répètes, appliquée dans ta conversation
Un sous-agent	Une tâche à part, qui produirait beaucoup de résultats inutiles, et qui peut se résumer

Déléguer ne dispense pas de vérifier. Un résumé cite des fichiers ou des passages : ouvre-en au moins un.

Faire ensemble

1Étape 1 : Déléguer une recherche

Dans mon-espace-ia, en mode Manuel, écris :

Utilise un sous-agent pour chercher dans mon dossier les notes et documents qui parlent de budget. Rends-moi seulement un résumé de 5 lignes au maximum, avec le nom des fichiers.

Lors de notre essai, Claude a lancé le sous-agent Explore, qui a cherché en lecture seule, puis a rendu un résumé de trois fichiers, en précisant ceux qui n’en parlaient pas.

2Étape 2 : Vérifier le résumé

Ouvre un des fichiers cités : parle-t-il bien de budget, comme le dit le résumé ? Si un fichier manque, demande : « Pourquoi [fichier] n’est-il pas dans ta liste ? »

3Étape 3 : Créer ton sous-agent, en lecture seule

Crée un sous-agent de projet nommé chercheur-de-notes, dans .claude/agents/chercheur-de-notes.md. Description : « Cherche dans les notes et documents de ce dossier, et rend un résumé court avec le nom des fichiers. À utiliser pour retrouver une information dans mes notes. » Outils : seulement la lecture et la recherche de fichiers (Read, Grep, Glob). Il ne modifie rien. Montre-moi le fichier avant de le créer.

Relis l’en-tête : le nom, la description, la liste des outils. Le dossier .claude est protégé : Claude Code te demande l’autorisation, dans l’appli comme dans le terminal. Autorise si c’est juste.

4Étape 4 : L’utiliser

Ouvre une nouvelle session (un sous-agent créé en cours de séance peut n’être vu qu’à la séance suivante), puis :

Utilise le sous-agent chercheur-de-notes pour retrouver ce que j'ai décidé sur [un sujet de ton journal].

Vérifie le résumé avec ton journal.

Faire toi-même

Délègue une vraie recherche dans ton dossier, et vérifie au moins un fichier cité.
Si tu refais souvent ce genre de recherche, garde ton sous-agent chercheur-de-notes ; sinon, supprime-le (leçon 7).
Note dans ton journal ce que tu as délégué, et ce que la vérification a montré.

Vérifier

C’est réussi si :

tu as obtenu un résumé d’un sous-agent, et vérifié au moins un fichier qu’il cite ;
ton sous-agent chercheur-de-notes existe, avec seulement des outils de lecture, ou tu as décidé de ne pas le garder ;
tu sais dire, pour une tâche donnée, s’il vaut mieux la conversation, une skill ou un sous-agent.

Erreurs fréquentes :

déléguer une petite tâche : c’est plus long, et ça use ta limite d’usage ;
donner à un sous-agent des droits d’écriture « au cas où » ;
prendre son résumé pour une preuve ;
multiplier les sous-agents : chaque description pèse dans le contexte de chaque séance.

Conserver et reprendre

Tes sous-agents de projet sont des fichiers de .claude/agents/ : ils font partie de ton dossier, et donc de tes copies.
À l’entretien mensuel, retire ceux qui ne servent plus.

Pour aller plus loin

facultatif

Tu peux aussi appeler un sous-agent avec @ suivi de son nom, pour être sûr que c’est lui qui travaille.
La documentation officielle, en anglais : code.claude.com/docs/en/sub-agents (création, portée personnelle ou de projet, choix des outils et du modèle).

Mots nouveaux

4 mots expliqués

Mot	Ce que ça veut dire
Sous-agent	Un assistant spécialisé que Claude lance pour une tâche à part, et qui rend un résumé
Contexte	Ce que Claude a sous les yeux pendant la séance ; un sous-agent a le sien
Explore	Le sous-agent fourni avec Claude Code pour chercher et lire, sans écrire
Déléguer	Confier une tâche, puis vérifier ce qui revient

La délégation de l’étape 1 a été jouée réellement avec Claude Code 2.1.310 dans un dossier d’essai (rapport de tests, T40). La création du sous-agent de l’étape 3 n’a pas été jouée.