Subagent — déléguer comme un développeur senior
Envoyer des tâches ciblées à des instances Claude spécialisées
⏱ Estim. ~6 min
01 · Lire
Les développeurs seniors ne font pas tout eux-mêmes — ils délèguent. Quand un développeur junior demande à un senior d'enquêter sur un bug, le senior ne lâche pas ce qu'il fait. Il envoie quelqu'un enquêter et lui faire un retour.
Les subagents te permettent de faire pareil avec Claude Code. Plutôt qu'une seule grande conversation qui essaie de tout gérer — lire des fichiers, lancer des tests, étudier l'architecture — tu peux envoyer des tâches ciblées à des subagents spécialisés qui travaillent dans leur propre context window.
Le gros avantage : les subagents gardent ta conversation principale propre. Un subagent peut lire 50 fichiers pour comprendre ton système d'authentification, mais il ne renvoie qu'un court résumé dans ton context window.
💡 Imagine çaImagine un subagent comme un assistant de recherche envoyé à la bibliothèque. Tu n'y vas pas toi-même avec le bureau encombré de livres — il y va, lit tout et revient avec une page de résumé. Ton bureau reste libre pour le vrai travail.
Points clés
- Les subagents tournent dans un context window séparé de ta conversation principale
- Ils enquêtent, analysent et exécutent des tâches en toute indépendance
- Seul le résumé revient dans ton contexte — pas tous les fichiers qu'ils ont lus
- Ta conversation principale reste concentrée sur l'implémentation
02 · Lire
Claude Code propose plusieurs types de subagents intégrés, chacun conçu pour des tâches précises : - Explore — recherche en read-only. Cherche dans les fichiers, lit le code, répond aux questions sur la base de code. Ne peut pas éditer. - Plan — conception d'architecture. Explore la base de code et propose un plan d'implémentation. Reste en read-only jusqu'à ton approbation. - Bash — expert des commandes. Exécute des commandes dans le terminal. À utiliser pour lancer les tests, les builds, ou faire des vérifications système.
Claude génère automatiquement un subagent quand il reconnaît une tâche à isoler — par exemple enquêter sur une grosse base de code ou lancer une suite de tests. Tu peux aussi en demander un explicitement.
Points clés
- Explore : recherche read-only et analyse de la base de code
- Plan : conception d'architecture et planification d'implémentation
- Bash : commandes terminal et opérations système
- Claude génère automatiquement un subagent quand c'est pertinent
03 · Exemple de code
Tu peux demander directement à Claude d'utiliser un subagent. Voici un prompt qui déclenche la délégation à un subagent.
Prompt qui déclenche un subagent
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Quand tu demandes à Claude « d'enquêter », « d'explorer », « d'analyser » ou « de lancer les tests », il délègue souvent à un subagent automatiquement. Le subagent fait le gros du travail dans son propre contexte et renvoie un résumé concis dans ta conversation.
04 · Lire
Tu peux créer tes propres subagents personnalisés en écrivant un SKILL.md avec un frontmatter YAML. Ça définit un agent spécialisé avec ses propres instructions, ses restrictions d'outils et son choix de modèle.
Les agents personnalisés sont puissants parce que tu peux limiter leurs capacités. Un code reviewer n'a besoin que de lire des fichiers — il ne devrait pas éditer ni lancer de commandes. Un test runner a besoin de Bash mais pas d'Edit. Restreindre les outils rend l'agent plus sûr et plus concentré.
Points clés
- Les agents personnalisés sont définis dans un SKILL.md avec frontmatter YAML
- Le champ tools: limite ce que l'agent peut faire
- Un reviewer a besoin de Read/Grep/Glob — pas d'Edit ni de Bash
- Les restrictions rendent l'agent plus sûr et plus concentré
05 · Exemple de code
Voici comment construire un subagent code-reviewer personnalisé. Le frontmatter YAML définit son comportement.
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
Cet agent ne peut que lire du code — pas éditer de fichiers ni lancer de commandes. La restriction tools: Read, Grep, Glob garantit qu'il reste concentré sur la revue. model: sonnet indique d'utiliser Sonnet (rapide, cost-effective) plutôt que le modèle de ta conversation principale.
06 · Quiz
Tu implémentes une nouvelle fonctionnalité et tu dois comprendre comment marche le système d'authentification existant. Ça implique de lire plus de 20 fichiers. Quelle est la méthode la plus efficace côté contexte ?
- Lire toi-même les 20 fichiers dans la conversation principale
- Demander à Claude d'expliquer l'authentification sans lire de fichiers
- Ouvrir une nouvelle session Claude pour l'investigation
- Utiliser un subagent pour enquêter et renvoyer un résumé
07 · Associer
Associe chaque type de subagent à son meilleur usage.
(Cette section est interactive — active JavaScript pour l'utiliser.)
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.