Les sous-agents

Un sous-agent est un assistant spécialisé que Claude lance pour une tâche précise. Il travaille dans sa propre fenêtre de contexte, avec ses propres instructions et ses propres outils, et ne renvoie qu’un résumé. Cette leçon en donne l’essentiel ; le cours Introduction aux sous-agents du catalogue les traite en détail.

À quoi ça sert

La documentation résume le cas d’usage en une phrase : utilisez un sous-agent quand une tâche annexe noierait votre conversation sous des résultats de recherche, des journaux ou des contenus de fichiers que vous ne relirez pas. Le sous-agent fait ce travail de son côté et ne rapporte que la synthèse. Les sous-agents servent aussi à :

• imposer des contraintes, en limitant les outils qu’un sous-agent peut utiliser (un relecteur qui ne peut pas modifier de fichiers) ;
• spécialiser un comportement, avec des instructions ciblées sur un domaine ;
• réutiliser une configuration d’un projet à l’autre ;
• maîtriser les coûts, en confiant une tâche simple à un modèle plus rapide et moins cher comme Haiku.

Ceux que Claude utilise déjà

Vous vous servez de sous-agents sans le savoir. Claude Code en intègre plusieurs et les lance de lui-même :

• Explore, un agent rapide en lecture seule, pour chercher et analyser dans une base de code ;
• Plan, qui fait les recherches nécessaires pendant le mode plan ;
• general-purpose, pour les tâches complexes en plusieurs étapes qui demandent à la fois d’explorer et d’agir.

Les sous-agents que Claude lance depuis votre conversation tournent par défaut en arrière-plan : vous continuez à travailler, et leurs résultats arrivent quand ils ont fini.

Créer le vôtre

Un sous-agent est un fichier Markdown avec un en-tête YAML. Le plus simple est de demander à Claude de l’écrire :

Create a personal code-improver subagent in ~/.claude/agents/ that scans
files and suggests improvements for readability, performance, and best
practices. It should explain each issue, show the current code, and
provide an improved version. Make it read-only and have it use Sonnet.

Claude produit un fichier de ce type :

---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

You are a code improvement specialist. For each issue you find, explain
the problem, show the current code, and provide an improved version.

Seuls name et description sont obligatoires. La description est décisive : c’est elle que Claude lit pour décider quand déléguer. tools limite les outils (ici, lecture seule) et model choisit le modèle. Le texte sous l’en-tête devient les instructions du sous-agent.

L’emplacement décide de la portée : .claude/agents/ pour un projet (à commiter pour toute l’équipe), ~/.claude/agents/ pour tous vos projets.

Notez un changement récent : depuis la version 2.1.198, la commande /agents n’ouvre plus d’assistant de création ; elle rappelle simplement de demander à Claude ou de modifier directement ces dossiers. Les modifications d’un fichier existant sont prises en compte en quelques secondes, sans redémarrage.

L’appeler

• En langage courant : « utilise le sous-agent code-improver pour proposer des améliorations » ; Claude décide de déléguer.
• Avec une mention : tapez @ et choisissez le sous-agent dans la liste, pour garantir qu’il soit utilisé.
• Pour toute la session : claude --agent code-improver.

Quand ne pas s’en servir

Un sous-agent part d’un contexte vierge : il ne voit pas votre conversation, seulement la consigne que Claude lui transmet. Restez dans la conversation principale pour une tâche qui demande des allers-retours fréquents, des phases qui partagent beaucoup de contexte, ou un petit changement rapide. Et ne déléguez pas en espérant une meilleure réponse : la documentation précise que confier la même tâche à un sous-agent ne l’améliore pas. Ce qui aide, c’est un relecteur neuf, qui n’a pas vu votre raisonnement. Enfin, chaque sous-agent consomme ses propres jetons.

À vous de jouer

Un relecteur en lecture seule. Demandez à Claude de créer un sous-agent de projet reviewer dans .claude/agents/, avec les seuls outils Read, Grep et Glob et un format de rapport par priorité. Faites-lui relire votre dernière modification, puis vérifiez qu’il ne peut rien modifier.

Sources officielles : Subagents (Claude Academy) · Create custom subagents · Best practices

Points clés à retenir

• Un sous-agent travaille dans son propre contexte et ne renvoie qu’un résumé
• Claude utilise déjà Explore, Plan et general-purpose, en arrière-plan par défaut
• Un sous-agent personnalisé est un fichier Markdown dans .claude/agents/ ou ~/.claude/agents/ ; name et description sont obligatoires, la description décide de la délégation
• Le plus simple est de demander à Claude d’écrire le fichier ; /agents n’a plus d’assistant depuis la version 2.1.198
• Pas de sous-agent pour un échange itératif ou un petit changement