Claude Code agents et subagents : déléguer pour aller plus vite
Sommaire
▶️ En Bref
Un subagent est une instance de Claude lancée par Claude Code principal pour exécuter une sous-tâche isolée. Le subagent travaille dans son propre contexte, retourne un résultat, puis disparaît. Cela protège votre contexte principal et permet la parallélisation. Idéal pour : recherches massives, refactorings indépendants, exploration multi-fichiers. Lancement via l’outil Agent avec un prompt auto-suffisant.
Les agents et subagents sont la fonctionnalité la plus puissante de Claude Code pour les tâches complexes. Bien utilisés, ils transforment l’outil en orchestrateur capable de gérer plusieurs threads de travail en parallèle.
Agent vs subagent : la différence
La terminologie peut prêter à confusion. Clarifions :
- Agent (au sens large) : Claude Code lui-même. Vous lui parlez en langage naturel, il agit sur votre projet.
- Subagent : un agent fils lancé par Claude Code principal pour une tâche spécifique. Il a son propre contexte, ses propres outils, et retourne un résultat à l’agent parent.
📖 Analogie
Pensez l’agent principal comme un chef d’orchestre et les subagents comme des musiciens. Chacun joue sa partie sans gêner les autres. Le chef d’orchestre coordonne sans lire chaque note de chaque instrument.
Quand utiliser un subagent ?
Trois situations typiques où un subagent vaut largement le coût en tokens :
1. Recherche dans un gros codebase
Au lieu d’inonder votre contexte avec 50 fichiers ouverts, déléguez à un subagent : « Cherche toutes les utilisations de la fonction processOrder dans le projet, retourne un résumé ». Le subagent explore, vous récupérez juste le résumé.
2. Tâches indépendantes parallélisables
Refactorer 5 modules sans dépendances entre eux ? Lancez 5 subagents en parallèle, chacun gère son module.
3. Sous-tâches risquées ou expérimentales
Tester une approche dans une worktree Git isolée. Si le subagent se plante, votre projet principal n’est pas affecté.
Lancer un subagent en pratique
Claude Code utilise un outil interne Agent pour lancer des subagents. Vous demandez simplement :
📌 Exemple de prompt à l’agent principal
« Lance un subagent pour analyser tous les hooks React du projet et identifier ceux qui ont des memory leaks. Donne-moi juste le rapport final. »
L’agent principal va :
- Préparer un prompt auto-suffisant pour le subagent
- Choisir le bon type d’agent spécialisé (Explore, general-purpose, etc.)
- Lancer le subagent
- Recevoir le rapport final
- Synthétiser pour vous
💡 Règle d’or pour briefer un subagent
Le subagent ne voit pas votre conversation. Le prompt doit être complet et auto-suffisant : objectif, contexte, format de réponse attendu. C’est comme briefer un nouveau collègue.
Parallélisation : agents en parallèle
Le vrai super-pouvoir : lancer plusieurs subagents en parallèle dans une seule requête.
« Lance en parallèle : un subagent qui audite la sécurité, un qui audite la performance, un qui audite l’accessibilité. Synthèse à la fin. »
Au lieu d’attendre 3 × 5 minutes (séquentiel), vous attendez 5 minutes total. Gain de temps massif sur les gros projets.
Limites de la parallélisation
- Les subagents ne se voient pas entre eux : chacun travaille en silo
- Les modifications de fichiers concurrentes peuvent créer des conflits
- Le coût en tokens monte rapidement (chaque subagent = un contexte complet)
Bonne pratique : paralléliser des tâches en lecture seule (analyse, audit) ou des écritures dans des zones disjointes (modules séparés).
Types d’agents spécialisés
Claude Code propose plusieurs types d’agents préconfigurés :
- general-purpose : agent généraliste avec accès à tous les outils
- Explore : agent en lecture seule, optimisé pour la recherche dans un codebase
- Plan : architecte qui dessine un plan d’implémentation détaillé
- code-reviewer : reviewer une PR ou une étape de plan
- statusline-setup : configurer la status line de Claude Code
Vous pouvez aussi créer vos propres agents personnalisés en plaçant des fichiers Markdown dans ~/.claude/agents/.
Les pièges à éviter
⚠️ Erreurs courantes
- Briefing flou : un subagent mal briefé livre du travail générique. Soyez précis.
- Tâche trop petite : pas la peine de lancer un subagent pour une tâche de 30 secondes — le coût overhead n’en vaut pas la peine.
- Subagents qui modifient les mêmes fichiers : conflits garantis.
- Confiance aveugle dans le résultat : un subagent peut prétendre avoir fait le travail sans l’avoir réellement fait. Vérifiez.
- Trop de subagents simultanés : au-delà de 5 en parallèle, la coordination devient difficile.
FAQ
Combien coûte un subagent ?
Chaque subagent consomme des tokens comme une session normale (input + output). Compter ~1-3 $ pour une tâche moyenne avec Sonnet, plus pour Opus.
Le subagent voit-il mon CLAUDE.md ?
Oui, les fichiers CLAUDE.md du projet sont chargés dans tout subagent lancé depuis ce projet.
Peut-on suivre l’avancement d’un subagent ?
L’agent principal vous notifie quand le subagent termine. Pour les tâches longues, vous pouvez les lancer en arrière-plan et continuer à travailler.
Un subagent peut-il en lancer un autre ?
Théoriquement oui (récursion), mais c’est rarement utile et augmente vite la complexité. Préférez orchestrer depuis l’agent principal.
Quelle est la différence avec un hook ?
Un hook est une commande shell exécutée automatiquement avant/après une action de Claude. Un subagent est une instance de Claude qui réfléchit. Voir : Claude Code hooks.
✅ Ce qu’il faut retenir
- Subagent = Claude lancé par Claude pour une sous-tâche isolée
- Protège le contexte principal et permet la parallélisation
- Idéal pour : recherches massives, audits, refactorings indépendants
- Briefing complet et auto-suffisant obligatoire
- Types préconfigurés (Explore, Plan, code-reviewer…) ou agents custom
- Coût : 1-3 $ par subagent moyen, attention au cumul
Pour étendre Claude Code autrement : Skills, Hooks et MCP. Vue d’ensemble : Comment utiliser Claude Code.
%20(1).png)
Envie d’aller plus loin ?
Découvrez nos formations complètes avec accompagnement personnalisé.
Voir la formation