Aller au contenu
Floskool

Chapitre 1 · L'essentiel

Créer ton premier sous-agent

Leçon gratuite 9 minGroupe Claude Code

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Un 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

DossierPour qui
.claude/agents/ dans ton projetSeulement ce projet (et partageable avec ceux qui travaillent dessus)
~/.claude/agents/ dans ton dossier personnelTous 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 avec disallowedTools: Write, Edit.
  • model (facultatif) : haiku, sonnet, opus ou inherit (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.