1. Le problème : la pollution du contexte
Quand Claude Code fait une grosse recherche (lire 50 fichiers, analyser un dépôt entier), tout ça s'ajoute à son contexte. Conséquences :
- Le contexte grossit, devient cher (chaque appel inclut tout)
- L'agent "se perd dans le bruit" (l'attention se dilue)
- Vous perdez le fil principal de votre demande
Solution : déléguer les sous-tâches lourdes à des sub-agents qui travaillent dans leur propre bulle, et qui ne renvoient que le résultat synthétisé.
2. Comment ça marche
Un sub-agent est un Claude Code "enfant" lancé par le principal pour une tâche précise. Il a :
- Son propre contexte (vide au démarrage)
- Ses propres outils (souvent un sous-ensemble)
- Une mission claire passée en paramètre
- Renvoie un seul résultat à l'agent principal quand il a fini
L'agent principal ne voit pas le détail du travail du sub-agent. Il reçoit juste la conclusion. C'est ce qui préserve son contexte.
3. Les sub-agents intégrés
Claude Code a 3 sub-agents intégrés que vous pouvez invoquer immédiatement :
1. Explore (Sonnet)
Pour explorer un dépôt, chercher des informations dispersées, comprendre une structure. Utilise des outils de lecture en mode agressif.
2. Plan
Pour décomposer une tâche complexe en plan d'action structuré. Renvoie un plan détaillé, sans modifier de fichiers.
3. General-purpose
Sub-agent généraliste pour toute tâche isolée qui n'entre pas dans une catégorie spécifique.
4. Comment invoquer un sub-agent
Vous demandez en langage naturel, Claude Code décide automatiquement de déléguer si pertinent :
L'agent principal délègue à Explore, qui parcourt le projet, et renvoie une liste compacte. Votre contexte reste léger.
5. Le parallélisme : lancer plusieurs sub-agents en même temps
Le vrai pouvoir : lancer plusieurs sub-agents en parallèle. Si vous avez 4 sous-tâches indépendantes, elles peuvent toutes tourner simultanément :
Au lieu de prendre 40 minutes en séquentiel, ça prend 12 minutes en parallèle. Gain de temps massif sur les analyses multi-périodes ou multi-sources.
6. Créer vos propres sub-agents custom
Pour vos workflows métier récurrents, créez des sub-agents spécialisés. Créez .claude/agents/comptable.md :
Maintenant vous pouvez l'invoquer : "Lance le sub-agent comptable sur les fichiers du dossier ./factures-mars/". Il utilise les outils que vous avez déclarés (Read, Glob), suit ses instructions, renvoie le rapport.
7. Quand utiliser un sub-agent (et quand non)
✅ Bons cas pour sub-agent
- Recherche dans beaucoup de fichiers (résultat = liste compacte)
- Analyses parallèles de plusieurs sources indépendantes
- Tâche isolée qui n'a pas besoin de votre contexte projet
- Travail "lourd" qui pollue le contexte (lire un dépôt entier)
- Utiliser un modèle différent (déléguer à Haiku pour économiser)
❌ Mauvais cas pour sub-agent
- Tâches courtes (overhead du sub-agent > gain)
- Tâches qui nécessitent un dialogue itératif
- Tâches qui dépendent du contexte de la conversation principale
- Création d'1-2 fichiers seulement (pas besoin)
8. Limiter les outils d'un sub-agent
Pour la sécurité, vous pouvez restreindre les outils d'un sub-agent dans son fichier de définition :
Cet agent peut lire et chercher, mais pas modifier ni exécuter. Parfait pour un sub-agent d'analyse pure (audit, recherche).
Liste des principaux outils : Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch.
9. Cas concret : équipe de sub-agents pour analyse stratégique
Imaginez : vous voulez préparer un comité stratégique. Vous créez 4 sub-agents :
- analyst-finance : analyse les KPIs financiers, lit les rapports comptables
- analyst-marketing : analyse les performances marketing, leads, conversions
- analyst-rh : analyse turnover, satisfaction équipes, recrutements
- analyst-strat : synthétise les 3 précédents et propose des actions
Vous lancez : "Lance analyst-finance, analyst-marketing, analyst-rh en parallèle. Quand ils ont fini, lance analyst-strat avec leurs 3 résultats."
30 minutes plus tard, vous avez un comité prêt. C'est le pouvoir des multi-agents intégrés à Claude Code.
10. À retenir avant le chapitre suivant
- Sub-agents = bulle isolée pour tâche précise. Préservent le contexte principal.
- 3 sub-agents intégrés : Explore, Plan, General-purpose
- Parallélisme possible : 3-4 sub-agents en même temps = gain de temps massif
- Sub-agents custom dans
.claude/agents/*.md - Restriction d'outils par sub-agent pour sécurité
- À utiliser pour : recherches, analyses parallèles, tâches isolées
- À éviter pour : tâches courtes, dialogues itératifs
Au chapitre 5, on plonge dans les skills custom : créer vos propres compétences réutilisables qui s'activent automatiquement selon le contexte.