Qu'est-ce qu'un sous-agent ?

Plus une session de Claude Code dure, plus sa conversation se charge : résultats de recherche, journaux, contenus de fichiers, sorties de tests. Les sous-agents sont l’un des moyens les plus pratiques de garder cette conversation nette. Ce cours, adapté du cours Introduction to subagents de Claude Academy, vous apprend à les comprendre, à en créer, à les concevoir pour qu’ils soient fiables, et à savoir quand ils valent la peine. Les faits cités viennent de la documentation officielle de Claude Code, vérifiée le 5 novembre 2026.

Une définition

D’après la documentation, un sous-agent est un assistant d’IA spécialisé dans un type de tâche. Chacun s’exécute dans sa propre fenêtre de contexte, avec ses propres instructions (son prompt système), un accès à des outils choisis et des permissions indépendantes. Quand Claude rencontre une tâche qui correspond à la description d’un sous-agent, il la lui délègue ; le sous-agent travaille seul et renvoie son résultat.

Le cas d’usage type tient en une phrase : utilisez un sous-agent quand une tâche annexe noierait votre conversation principale sous des résultats de recherche, des journaux ou des contenus de fichiers que vous ne relirez pas. Le sous-agent fait ce travail dans son contexte et ne renvoie que le résumé.

Comment l’information circule

À l’aller, le sous-agent ne voit pas votre conversation : ni votre historique, ni les skills déjà utilisées, ni les fichiers que Claude a déjà lus. Claude rédige un message de délégation qui résume la tâche, et le sous-agent part de là. Son contexte de départ contient :

• son prompt système : ses propres instructions et quelques détails sur l’environnement, et non le prompt système de Claude Code ;
• le message de délégation écrit par Claude ;
• les fichiers CLAUDE.md de tous les niveaux que charge la conversation principale ;
• un instantané de l’état git du dépôt ;
• le contenu complet des skills que sa définition demande de précharger.

Les sous-agents intégrés Explore et Plan démarrent sans CLAUDE.md ni état git, pour que la recherche reste rapide et peu coûteuse. Un sous-agent que vous définissez peut lui aussi démarrer sans vos CLAUDE.md, avec omitClaudeMd: true dans sa définition. Certains éléments n’atteignent jamais un sous-agent ordinaire : le style de réponse que vous avez choisi et la mémoire automatique de la conversation principale.

Pendant le travail, tout ce que le sous-agent lit et produit reste dans son contexte à lui. Il peut parcourir des dizaines de fichiers ou lancer une suite de tests complète sans que rien de cela n’atterrisse dans votre conversation.

Au retour, seul son rapport final revient à Claude. Avant que Claude ne le lise, Claude Code l’examine : le sous-agent a pu lire des fichiers, des pages web ou des sorties de commandes que vous n’avez jamais vus, qui pourraient contenir des instructions visant la conversation principale. Le rapport arrive sous un en-tête qui précise que les consignes qu’il contient sont les mots du sous-agent et n’ont aucune autorité venant de vous.

Les sous-agents intégrés

Claude Code en fournit plusieurs, que Claude utilise de lui-même quand c’est utile :

D’autres agents d’appoint existent, comme claude-code-guide, qui répond aux questions sur les fonctionnalités de Claude Code. Chaque sous-agent intégré hérite des règles de permission de la conversation principale.

Premier plan ou arrière-plan

Un sous-agent peut tourner au premier plan, en bloquant la conversation jusqu’à ce qu’il ait fini, ou en arrière-plan, pendant que vous continuez à travailler. Par défaut, un sous-agent que Claude lance depuis votre conversation démarre en arrière-plan. S’il a besoin d’une permission, la demande apparaît dans votre session principale avec le nom du sous-agent qui la pose. Ses résultats arrivent plus tard, sous forme de notification.

Un cas à part : le fork

Un fork est un sous-agent qui hérite de toute la conversation au lieu de partir de zéro. Il voit le même prompt système, les mêmes outils, le même modèle et le même historique que la session principale : inutile de lui réexpliquer la situation. Ses appels d’outils restent pourtant hors de votre conversation, et seul son résultat revient. Comme son début est identique à celui de la session, il réutilise son cache de prompt et coûte moins cher qu’un sous-agent neuf pour une tâche qui demande le même contexte. Vous pouvez en lancer un vous-même avec /subtask suivi d’une tâche, par exemple /subtask draft unit tests for the parser changes so far.

Ce qu’un sous-agent n’est pas

Les sous-agents vivent à l’intérieur d’une session. Pour faire tourner plusieurs sessions indépendantes en parallèle, Claude Code propose les background agents ; pour des sessions qui s’échangent des messages, la messagerie entre sessions ; pour une équipe de sessions coordonnée par Claude, les agent teams. Ce cours se concentre sur les sous-agents.

À vous de jouer

Observer une délégation. Dans un projet que vous connaissez, demandez à Claude Code : « Use a subagent to find where errors are logged in this codebase ». Ouvrez /tasks pendant que le sous-agent travaille, puis comparez ce qui revient dans votre conversation avec le nombre de fichiers qu’il a lus. Lancez ensuite la même recherche sans sous-agent, et regardez la place qu’elle prend dans votre contexte.

Cours officiel — Ce cours suit le programme du cours officiel de Claude Academy ; son contenu, rédigé en français, s’appuie sur la documentation officielle citée à chaque leçon. Pour valider le cours officiel, suivez Introduction to subagents sur Claude Academy.

Sources officielles : What are subagents? (Claude Academy) · Create custom subagents (documentation Claude Code : contexte de départ, sous-agents intégrés, arrière-plan, fork, examen des rapports) · Explore the context window

Points clés à retenir

• Un sous-agent est un assistant spécialisé qui travaille dans sa propre fenêtre de contexte, avec ses instructions, ses outils et ses permissions
• Il ne voit pas votre conversation : Claude lui écrit une consigne ; il reçoit aussi CLAUDE.md et l’état git (sauf Explore et Plan)
• Seul son rapport final revient, examiné par Claude Code et marqué comme venant du sous-agent
• Explore, Plan et general-purpose sont intégrés ; par défaut, les sous-agents tournent en arrière-plan
• Un fork hérite de toute la conversation et partage le cache de prompt