Création d'un sous-agent

Création d'un sous-agent

La façon la plus simple de créer un sous-agent est de demander à Claude de l'écrire pour vous. Décrivez le sous-agent que vous souhaitez et l'endroit où l'enregistrer, et Claude écrit le fichier. La vidéo et les trois premières captures d'écran de cette leçon montrent l'assistant /agents, qui a été supprimé dans Claude Code v2.1.198. Le fichier du sous-agent et ses champs restent inchangés, vous devez donc toujours choisir une portée, des outils, un modèle et une couleur. Incluez ces choix dans votre requête.

Tout d'abord, choisissez la portée de votre sous-agent. Un fichier dans .claude/agents/ est au niveau du projet, et un fichier dans ~/.claude/agents/ est au niveau de l'utilisateur :

• Niveau projet -- disponible uniquement dans le projet en cours
• Niveau utilisateur -- partagé entre tous les projets sur votre machine

Ensuite, vous pouvez choisir comment le créer. Vous pouvez rédiger la configuration manuellement, mais l'approche recommandée consiste à laisser Claude la générer pour vous. Décrivez simplement ce que vous voulez que le sous-agent fasse, et Claude produira un nom, une description et une invite système en fonction de votre saisie.



Personnalisation des outils

Lors de la création, vous avez la possibilité de personnaliser les outils auxquels le sous-agent 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 sous-agent a réellement besoin. Un relecteur 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 afin qu'il puisse plus facilement identifier les modifications en attente.

Choix d'un modèle et d'une couleur

Après avoir configuré les outils, vous sélectionnez le modèle Claude qui alimente le sous-agent. Vos options incluent :

• Haiku -- idéal pour les tâches rapides et légères
• Sonnet -- un bon compromis entre vitesse et profondeur
• Opus -- idéal pour les analyses complexes
• Inherit -- utilise le modèle en cours d'exécution dans votre conversation principale

Enfin, vous choisissez une couleur. Celle-ci apparaît dans l'interface afin que vous puissiez rapidement identifier quel sous-agent est actif. C'est un petit détail, mais il est utile lorsque vous avez plusieurs sous-agents en cours d'exécution.



Le fichier de configuration

Une fois la création terminée, le fichier de configuration du sous-agent est enregistré dans le dossier correspondant à la portée que vous avez choisie (pour un sous-agent au niveau du projet, généralement .claude/agents/your-agent-name.md). Voici à quoi ressemble une configuration de sous-agent 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 sous-agent. C'est ainsi que vous y faites référence, soit en le demandant directement à Claude, soit en tapant @agent-code-quality-reviewer dans votre message.
• description -- Contrôle le moment où Claude décide d'utiliser le sous-agent. Cela doit tenir sur une seule ligne (utilisez des caractères de saut de ligne échappés \n si vous avez besoin de retours à la ligne). Vous pouvez inclure ici des exemples de conversations pour aider Claude à comprendre quand la délégation est appropriée.
• tools -- Liste les outils auxquels le sous-agent peut accéder. Claude remplit ce champ à partir de votre requête, mais vous pouvez modifier la liste ici à tout moment.
• model -- Spécifie quel modèle Claude utiliser : un alias (sonnet, opus, haiku, ou fable), un identifiant de modèle complet tel que claude-sonnet-5, ou inherit.
• color -- La couleur d'interface permettant d'identifier le sous-agent.

Invites système

Le corps du fichier markdown (tout ce qui se trouve sous le frontmatter YAML) constitue l'invite système. C'est ici que vous donnez au sous-agent ses instructions : sur quoi il doit se concentrer, comment il doit analyser les choses, et comment il doit rapporter ses conclusions à l'agent principal.

Une invite système bien rédigée fait toute la différence entre un sous-agent utile et un sous-agent qui passe à côté de l'essentiel. Soyez précis sur ce que le sous-agent doit rechercher et sur la manière dont il doit structurer sa sortie.

Faire en sorte que Claude utilise automatiquement votre sous-agent

Si vous voulez que Claude délègue des tâches au sous-agent sans que vous ayez à le demander 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 dans lesquels le sous-agent doit être utilisé. Plus vos exemples sont concrets, mieux Claude saura quand déléguer.

Tester votre sous-agent

Après avoir créé votre sous-agent, testez-le en effectuant quelques modifications de code et en demandant à Claude de les relire. Si le dossier agents n'existait pas au démarrage de votre session, redémarrez d'abord Claude Code pour charger le nouveau sous-agent.



Si le sous-agent n'est pas utilisé alors que vous vous y attendiez, revenez en arrière et vérifiez la description. Ajouter des exemples et des scénarios déclencheurs plus précis aide Claude à comprendre quand déléguer le travail à votre sous-agent.