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é.