Chapitre 1 · L'essentiel
Créer ton premier sous-agent
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementUn sous-agent, c'est un fichier texte. Pas de code, pas d'installation : un fichier Markdown avec un petit en-tête, rangé au bon endroit.
Où le ranger
| Dossier | Pour qui |
|---|---|
.claude/agents/ dans ton projet | Seulement ce projet (et partageable avec ceux qui travaillent dessus) |
~/.claude/agents/ dans ton dossier personnel | Tous tes projets |
Si deux sous-agents portent le même nom, la documentation indique que celui du projet passe avant celui du dossier personnel.
À quoi ressemble le fichier
Voici un relecteur complet, prêt à l'emploi. Le fichier s'appelle .claude/agents/relecteur.md :
---
name: relecteur
description: Relit un texte avant publication (fautes, clarté, ton, promesses). À utiliser avant de publier un post, une légende, une page ou un e-mail.
tools: Read, Grep, Glob
model: sonnet
---
Tu es le relecteur de mes contenus. Tu relis le texte demandé et tu signales :
1. les fautes d'orthographe et de grammaire ;
2. les phrases floues ou trop longues ;
3. ce qui ne correspond pas à mon ton (tutoiement, phrases courtes) ;
4. toute promesse, tout chiffre ou tout avis client qui n'est pas prouvé.
Tu ne modifies aucun fichier. Tu renvoies une liste courte : le problème, puis la correction proposée. Si tout est bon, dis-le en une phrase.
L'en-tête, ligne par ligne
name(obligatoire) : le nom du sous-agent, en minuscules, avec des tirets si besoin.description(obligatoire) : la ligne la plus importante. C'est elle que Claude lit pour décider quand confier une tâche à ce sous-agent. Dis ce qu'il fait et quand l'utiliser. La documentation indique qu'ajouter « use proactively » (à utiliser de façon proactive) encourage Claude à l'appeler de lui-même.tools(facultatif) : la liste des outils autorisés. Sans cette ligne, le sous-agent hérite de tous les outils. Pour un relecteur, la lecture suffit :Read, Grep, Glob. On peut aussi interdire des outils avecdisallowedTools: Write, Edit.model(facultatif) :haiku,sonnet,opusouinherit(le même modèle que ta conversation). Haiku pour les tâches simples et rapides, Sonnet pour le quotidien, Opus pour le raisonnement complexe. Les modèles évoluent : vérifie la liste à jour dans la documentation.
Tout ce qui suit l'en-tête devient les consignes du sous-agent : son rôle, ses règles, la forme de sa réponse.
L'astuce : demande toujours une réponse courte et structurée (« une liste : problème, correction »). C'est ce résumé qui revient dans ta conversation. S'il est long, tu perds l'intérêt du sous-agent.
La façon la plus simple : demander à Claude
Tu n'es pas obligé d'écrire le fichier toi-même. Dans Claude Code, demande :
Crée un sous-agent « relecteur » dans .claude/agents/. Son rôle : relire mes textes avant publication. Lecture seule. Montre-moi le fichier avant de l'enregistrer.
Claude écrit le fichier, te le montre, et l'enregistre après ton accord. La leçon 4 donne la version complète de ce prompt et neuf autres.
Vérifier qu'il est là
Demande simplement à Claude : « Quels sous-agents sont disponibles dans ce projet ? ». Si ton nouveau sous-agent n'apparaît pas, vérifie le dossier et le nom du fichier, puis relance Claude Code. Selon ta version, la commande /agents ouvre un écran de gestion ou te rappelle comment les créer : la documentation officielle décrit le comportement de ta version.
À toi de jouer
Crée le relecteur ci-dessus dans un de tes projets, en le demandant à Claude ou en copiant le fichier. Puis demande : « Utilise le relecteur sur [un texte de ton projet]. » Tu as réussi quand tu reçois une liste courte de corrections, sans que le texte complet de la relecture encombre ta conversation.