Créer un Subagent

Claude Code est livré avec des subagents intégrés, mais vous pouvez également créer les vôtres. Les subagents personnalisés se spécialisent dans des tâches spécifiques -- comme l'examen du code, la rédaction de tests ou la vérification de la documentation. Ils sont définis comme des fichiers markdown avec un frontmatter YAML qui indique à Claude quand utiliser le subagent et comment il doit se comporter.

Le moyen le plus simple de créer un subagent est d'utiliser la commande slash /agents. Cela ouvre l'interface principale pour gérer vos subagents. De là, sélectionnez Create new agent.

On vous demandera d'abord de choisir la portée de votre subagent :

Project-level \-- disponible uniquement dans le projet actuel
User-level \-- partagé entre tous les projets sur votre machine

Ensuite, vous pouvez choisir comment le créer. Vous pouvez écrire la configuration manuellement, mais l'approche recommandée est de laisser Claude la générer pour vous. Décrivez simplement ce que vous voulez que le subagent fasse, et Claude produira un nom, une description et un system prompt basés sur votre entrée.

Personnaliser les Outils

Lors de la création, vous avez la possibilité de personnaliser les outils auxquels le subagent peut accéder. Les catégories d'outils incluent :

Outils en lecture seule
Outils d'édition
Outils d'exécution
Outils MCP
Autres outils

Réfléchissez à ce dont votre subagent a réellement besoin. Un examinateur de code n'a probablement pas besoin d'outils d'édition -- il doit lire et analyser le code, pas le modifier. Cependant, vous pourriez vouloir garder les outils d'exécution activés pour qu'il puisse plus facilement identifier les modifications en attente.

Choisir un Modèle et une Couleur

Après la configuration des outils, vous sélectionnez quel modèle Claude alimente le subagent. Vos options sont :

Haiku \-- idéal pour les tâches rapides et légères
Sonnet \-- un bon équilibre entre vitesse et profondeur
Opus \-- idéal pour l'analyse complexe
Inherit \-- utilise le modèle de votre conversation principale

Enfin, vous choisissez une couleur. Cela s'affiche dans l'interface pour que vous puissiez rapidement identifier quel subagent est actif. C'est un petit détail, mais cela aide quand vous avez plusieurs subagents en cours d'exécution.

Le Fichier de Configuration

Une fois la création terminée, le fichier de configuration du subagent est enregistré dans votre projet (généralement à . claude/agents/your-agent-name. md). Voici à quoi ressemble une configuration de subagent typique :

--- name: code-quality-reviewer description: Use this agent when you need to review recently written or modified code for quality, security, and best practice compliance. tools: Bash, Glob, Grep, Read, WebFetch, WebSearch model: sonnet color: purple ---

You are an expert code reviewer specializing in quality assurance, security best practices, and adherence to project standards. Your role is to thoroughly examine recently written or modified code and identify issues that could impact reliability, security, maintainability, or performance.

Décomposons chaque champ :

name \-- Un identifiant unique pour le subagent. C'est ainsi que vous le référencez, soit en demandant directement à Claude, soit en tapant @agent code-quality-reviewer dans votre message.
description \-- Contrôle quand Claude décide d'utiliser le subagent. Cela doit être une seule ligne (utilisez des caractères de nouvelle ligne échappés \n si vous avez besoin de sauts). Vous pouvez inclure des exemples de conversations ici pour aider Claude à comprendre quand la délégation est appropriée.
tools \-- Liste les outils auxquels le subagent peut accéder. Cela correspond à ce que vous avez sélectionné lors de la génération, mais vous pouvez modifier la liste ici à tout moment.
model \-- Spécifie quel modèle Claude utiliser : sonnet, opus, haiku, ou inherit.
color \-- La couleur de l'interface pour identifier le subagent.

System Prompts

Le corps du fichier markdown (tout ce qui se trouve sous le frontmatter YAML) est le system prompt. C'est là que vous donnez au subagent ses instructions : sur quoi il doit se concentrer, comment il doit analyser les choses et comment il doit rapporter les résultats à l'agent principal.

Un system prompt bien rédigé fait la différence entre un subagent utile et un qui rate l'objectif. Soyez précis sur ce que le subagent doit rechercher et comment il doit structurer sa sortie.

Faire Utiliser Votre Subagent Automatiquement par Claude

Si vous voulez que Claude délègue des tâches au subagent sans que vous le demandiez explicitement, incluez le mot "proactively" dans le champ description. Par exemple :

description: Proactively suggest running this agent after major code changes...

Vous pouvez également ajouter des exemples de conversations à la description pour aider Claude à comprendre les scénarios spécifiques où le subagent doit être utilisé. Plus vos exemples sont concrets, mieux Claude comprend quand déléguer le travail à votre subagent.

Tester Votre Subagent

Après avoir créé votre subagent, testez-le en effectuant des modifications de code et en demandant à Claude de les examiner.

Si le subagent n'est pas utilisé quand vous vous y attendez, retournez vérifier la description. Ajouter des exemples plus spécifiques et des scénarios de déclenchement aide Claude à comprendre quand déléguer le travail à votre subagent.