Générateur de sous-agents Claude Code
Décrivez une tâche unique et bien définie que vous voulez déléguer - relire des PR pour trouver des failles de sécurité, écrire des tests unitaires, rechercher comment quelque chose fonctionne dans une base de code - et récupérez un fichier .claude/agents/<nom>.md complet à déposer directement dans Claude Code. L'IA rédige le contenu ; le nom, l'en-tête YAML et la liste d'outils autorisés sont tous vérifiés par rapport aux vraies règles des sous-agents pendant que vous modifiez, et une description en lecture seule contenant des outils capables d'écrire est signalée automatiquement.
1. Décrivez la tâche que vous voulez déléguer
Un langage simple convient très bien. Pensez à une portion de travail bien définie que vous confieriez volontiers à un spécialiste, dont vous ne liriez que le résumé - c'est exactement ce pour quoi un sous-agent est fait.
Ou partez de l'un de ces exemples
Votre .claude/agents/<name>.md apparaîtra ici, entièrement modifiable, avec le nom et la description vérifiés par rapport aux véritables contraintes des sous-agents au fur et à mesure que vous tapez.
Ce que contient vraiment un fichier de sous-agent
Un sous-agent est un seul fichier markdown : du frontmatter YAML en haut, un corps markdown en dessous. Le corps n'est pas un indice ou un complément - c'est l'intégralité du system prompt du sous-agent, qui remplace celui par défaut de Claude Code pendant toute la durée d'exécution de ce sous-agent. Il démarre aussi dans sa propre fenêtre de contexte, sans aucune partie de votre conversation actuelle reportée, donc tout ce qu'il doit savoir doit être écrit dans ce corps.
Seuls deux champs de frontmatter sont obligatoires. name n'utilise que des lettres minuscules et des tirets, ne contient aucun deux-points, et doit être unique parmi vos sous-agents - c'est le nom du fichier et la façon dont vous appelez le sous-agent à la main. description est le champ qui mérite qu'on s'y attarde, car c'est le seul texte que Claude lit pour décider quel sous-agent doit recevoir une tâche. Deux sous-agents avec des descriptions vagues se voleront mutuellement leur travail.
Tout le reste est facultatif, et ce générateur câble réellement chacun de ces champs dans le fichier : tools (une liste blanche séparée par des virgules - omettez-la pour hériter de tous les outils), disallowedTools (la liste noire), model (sonnet, opus, haiku, fable, un identifiant de modèle complet, ou inherit), permissionMode, maxTurns (un plafond de tours agentiques avant qu'il ne s'arrête et ne renvoie une sortie partielle), skills (des noms de skills precharés dans son contexte) et color, qui est purement visuel.
La chose la plus utile que vous puissiez faire avec cette liste est de garder tools restreint. Un relecteur de code qui ne possède que Read, Glob, Grep ne peut pas réécrire votre branche pendant qu'il « aide », quelle que soit la tournure de la conversation. Cet outil recoupe la liste blanche avec ce que votre description dit être le rôle du sous-agent, et signale une tâche censée être en lecture seule à qui on aurait malgré tout confié Write, Edit ou Bash.
Questions fréquentes
Qu'est-ce qu'un sous-agent Claude Code, exactement ?
Un sous-agent est une instance spécialisée de Claude qui s'exécute dans sa propre fenêtre de contexte séparée avec un system prompt différent, ce qui vous permet de lui déléguer une sous-tâche bien définie et de ne récupérer que le résumé. Il est défini par un seul fichier markdown à .claude/agents/<nom>.md : un en-tête YAML avec un nom et une description en haut, et un corps qui devient l'intégralité du system prompt de ce sous-agent. Comme il travaille dans un contexte isolé, la longue exploration désordonnée qu'il effectue - lire cinquante fichiers, lancer des greps, suivre des pistes sans issue - n'atterrit jamais dans votre conversation principale. Seul son rapport final le fait. Cette isolation est tout l'intérêt : elle garde votre contexte principal propre, et permet de confier une tâche étroite, dangereuse si mal utilisée, à un ensemble d'outils tout aussi étroit.
Agents vs compétences Claude Code - quelle est la différence ?
Une compétence charge des instructions dans la conversation que vous avez déjà ; un sous-agent démarre une toute nouvelle conversation. Quand une compétence se déclenche, le corps de son SKILL.md est ajouté au contexte actuel de Claude, qui continue de travailler en tant que lui-même, avec tout ce qu'il savait déjà. Quand un sous-agent se déclenche, Claude fait naître une instance séparée avec un contexte vierge et un system prompt différent, cette instance travaille seule, et seul son message final revient. Utilisez donc une compétence quand vous voulez apprendre à Claude à faire quelque chose qu'il fera ensuite ici - un style maison, une checklist, une procédure de release. Utilisez un sous-agent quand vous voulez que le travail soit fait ailleurs et ne voulez que la conclusion : une grosse recherche que vous ne voulez pas voir encombrer votre contexte, ou une relecture que vous voulez faire effectuer par quelque chose qui ne peut littéralement pas modifier vos fichiers. Une commande slash est une troisième chose, plus simple encore : un prompt enregistré que vous déclenchez en tapant /nom, exécuté en ligne, sans isolation et sans identité propre.
Comment créer un sous-agent dans Claude Code ?
Créez le dossier avec mkdir -p .claude/agents, enregistrez-y un fichier markdown nommé d'après le sous-agent, et rechargez Claude Code. Le fichier a besoin d'un en-tête YAML avec au moins name (lettres minuscules et tirets uniquement, pas de deux-points, unique) et description (quand Claude doit lui déléguer), suivi du corps qui sert de system prompt. Placez-le dans .claude/agents/ à l'intérieur du dépôt pour le commiter sur git et le partager avec votre équipe, ou dans ~/.claude/agents/ de votre dossier personnel pour le garder personnel sur tous vos projets. Si les deux existent avec le même nom, celui du projet l'emporte dans ce dépôt. Ce générateur écrit le fichier entier pour vous et affiche le chemin exact et la commande mkdir pour la portée choisie.
Pourquoi la liste d'outils autorisés compte-t-elle autant ?
Parce que c'est la seule limite stricte sur ce qu'un sous-agent peut faire. Omettez tools et le sous-agent hérite de tout ce qu'a la conversation principale, y compris les outils MCP - très bien pour un assistant de confiance, inutilement risqué pour un sous-agent dont le seul travail est de regarder et de rapporter. Un relecteur de sécurité muni de Read, Glob, Grep ne peut physiquement pas modifier votre arborescence de travail ; le même relecteur avec Bash et Write le peut. La règle de base est le moindre privilège : accordez le minimum nécessaire, ajoutez Write et Edit seulement pour un sous-agent censé modifier des fichiers, et ajoutez Bash seulement quand il doit vraiment exécuter quelque chose comme une suite de tests. Cet outil signale l'incohérence dans les deux sens - une description de relecture disposant d'outils d'écriture, et une description de correction sans aucun moyen d'écrire quoi que ce soit.
Comment Claude choisit-il quel sous-agent utiliser ?
Il compare la tâche à la description de chaque sous-agent, cette chaîne est donc votre table de routage. Une description comme « Relit le code » ne donne à Claude rien pour discriminer et sera choisie pour tout ou pour rien. Nommez plutôt les déclencheurs concrets : « Relit le code modifié pour des failles de sécurité - injection, autorisation manquante, désérialisation dangereuse, secrets divulgués. À utiliser proactivement après tout changement touchant l'authentification ou la gestion des entrées, et chaque fois que l'utilisateur demande une revue de sécurité. » Dire « utiliser proactivement » encourage la délégation automatique ; vous pouvez toujours forcer l'appel d'un sous-agent par son nom - « utilise le sous-agent security-code-reviewer pour vérifier ce diff ». Dans une configuration multi-agents où plusieurs sous-agents se chevauchent, les descriptions doivent tracer des frontières claires entre eux, c'est pourquoi ce générateur avertit en direct quand la vôtre est trop générique ou omet la partie « quand ».
Deux outils complémentaires à celui-ci : le Claude Skill Generator écrit un SKILL.md qui charge des instructions dans la conversation où vous êtes déjà, et le AI Slash Command Generator écrit la version fichier unique en /command.