Subagents Claude Code
L'agent unique devient équipe d'agents spécialisés.
Chaque subagent a son propre contexte, ses outils, ses permissions.
Un worker spawné par l'agent principal
Contexte isolé
Sa propre fenêtre de contexte, son propre prompt système, ses propres outils. Pas de pollution de la conversation principale.
Spécialisé
Un subagent dédié à la revue de code, un autre à la recherche de doc, un autre aux tests. Chacun avec un prompt taillé pour son métier.
Parallèle
Plusieurs subagents peuvent tourner en parallèle. Trois explorations simultanées sur des parties différentes du codebase, ramassage à la fin.
Délégation propre
Le subagent fait son travail dans son espace et renvoie uniquement la synthèse. Vous gardez la décision finale.
Trois livrés avec Claude Code
Explore
Agent rapide en lecture seule, optimisé pour parcourir et comprendre un codebase. Délégué automatiquement quand vous demandez « comment fonctionne X ».
Plan
Utilisé pendant le mode plan vu en leçon 13. Fait l'exploration de contexte avant de proposer le plan d'action.
General-purpose
Pour les tâches complexes multi-étapes qui demandent à la fois exploration et action. Invoqué automatiquement par Claude.
Commande /agents
Interface interactive guidée. Claude écrit lui-même la configuration.
Fichier Markdown
Frontmatter YAML : name, description, tools. Corps = prompt système.
Sauvegarder
~/.claude/agents/ pour global, .claude/agents/ pour projet.
Invoquer avec @
Mention typeahead depuis avril 2026 : @code-reviewer + consigne.
Pour éviter la théâtralité agentique
Commencer petit
Un seul subagent custom, sur une tâche que vous répétez vraiment. Pas une équipe de 15 qui ne tournera jamais.
Routage clair
Le routage automatique est aussi bon que votre description est claire. Si votre subagent ne se déclenche jamais, c'est sa description qui est trop vague.
Plus sûr et prévisible
Donnez uniquement ce qui est nécessaire. Un reviewer en lecture seule (Read, Grep, Glob) est plus sûr qu'un reviewer qui peut aussi écrire.
Optimiser le coût
Un subagent peut tourner sur un modèle différent du principal. Tâches lourdes vers Opus, tâches répétitives vers Haiku. Économies sans perte de qualité.
À tout de suite en leçon 15
Vous savez ce qu'est un subagent, distinguer les intégrés des custom, en créer un personnalisé avec /agents, et l'invoquer avec @ mention.
Exercice — appropriation
Identifiez une tâche annexe que vous demandez régulièrement à Claude pendant que vous travaillez sur un sujet principal — revue de code, recherche dans la doc, génération de tests, audit de sécurité. Créez un subagent dédié avec /agents. Testez-le sur trois cas réels et observez si votre conversation principale reste plus claire.
Quiz · Subagents Claude Code
8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.
Qu'est-ce qu'un subagent dans Claude Code ?
Un subagent est une instance spécialisée de Claude avec son propre contexte, ses outils dédiés et ses permissions ciblées. L'agent unique devient une équipe d'agents spécialisés.
Quelle commande permet de créer et gérer les subagents ?
La commande /agents ouvre l'interface de gestion : créer, lister, modifier, invoquer un subagent par son nom.
Un subagent a son propre contexte, isolé de la conversation principale.
Vrai. Le contexte du subagent est isolé : ses échanges ne polluent pas la conversation principale et inversement. C'est ce qui permet de garder la conversation principale claire.
Comment invoquer un subagent dans une conversation ?
@
Quel cas d'usage type pour un subagent ?
Bon usage : tâche annexe récurrente. Un subagent « code-reviewer » avec accès lecture seul, ou « test-writer » avec accès aux fichiers de test, etc.
Les permissions d'un subagent sont les mêmes que celles de l'agent principal.
Faux. Chaque subagent a ses permissions propres. Un « code-reviewer » peut être lecture seule, un « test-runner » peut exécuter les tests mais pas modifier le code source. Privilèges minimaux par défaut.
Où sont définis les subagents personnalisés ?
Stockage : ~/.claude/agents/ pour vos subagents personnels (réutilisables sur tous vos projets) ou .claude/agents/ à la racine d'un projet (partagés via Git avec l'équipe).
Créer trop de subagents pour de petites tâches peut être contreproductif.
Vrai. Comme tout outil de spécialisation, à utiliser avec parcimonie. Si vous créez 15 subagents pour un projet de 1000 lignes, vous fragmentez votre travail au lieu de le simplifier.