Claude Code Subagents Personnalisés : Créer Vos Sous-Agents IA (Guide 2026)

Subagents Claude Code : déléguez sans saturer votre contexte

Vous utilisez Claude Code depuis quelques semaines, votre agent est efficace… mais vous sentez qu'il pourrait faire mieux : contexte qui se remplit trop vite, tâches d'exploration qui noient la conversation, revue de code mélangée à l'implémentation. La réponse tient en un mot : les subagents personnalisés. Ce sont des sous-agents spécialisés que vous définissez une fois et que Claude délègue automatiquement au bon moment.

Dans ce guide 2026, vous allez apprendre ce qu'est réellement un subagent, comment en créer un en deux minutes, comment structurer le fichier .claude/agents, comment bien rédiger la description qui déclenche la délégation, et quels sous-agents valent vraiment le coup au quotidien. Le tout avec des exemples concrets, prêts à copier.

Sommaire

Subagents Claude Code : à quoi ça sert ?

Un subagent est un assistant IA spécialisé que Claude Code invoque pour une tâche bien précise. Il ne s'agit pas d'un simple prompt : c'est un agent à part entière, avec son propre prompt système, sa propre fenêtre de contexte et son propre jeu d'outils autorisés.

Concrètement, cela change trois choses fondamentales dans votre façon de travailler :

C'est cette combinaison — isolation du contexte, spécialisation, parallélisme — qui fait des subagents l'une des fonctionnalités les plus sous-exploitées de Claude Code en 2026.

Sous-agent vs agent principal vs agent teams

Trois notions sont souvent confondues. Clarifions-les.

Pour aller encore plus loin dans la programmation d'agents autonomes, le Claude Agent SDK permet de construire vos propres agents en dehors du terminal. Les subagents, eux, restent la porte d'entrée la plus simple : aucun code, juste un fichier Markdown.

Créer un subagent en 2 minutes

La méthode la plus rapide passe par la commande intégrée. Dans une session Claude Code, tapez :

/agents

L'assistant vous guide pas à pas :

Bon à savoir : sur les versions récentes de Claude Code, /agents peut se contenter d'ouvrir un rappel vous invitant à demander à Claude de créer l'agent, ou à éditer directement le dossier .claude/agents/. La création manuelle reste donc la méthode la plus fiable et la plus transparente — c'est ce que nous détaillons juste après.

Astuce : vous pouvez aussi demander en langage naturel « crée-moi un subagent qui relit le code à la recherche de bugs, en lecture seule ». Claude génère le fichier pour vous. Pour que ce genre de demande donne un bon résultat, un prompt bien formulé fait toute la différence.

Anatomie d'un fichier subagent

Sous le capot, un subagent n'est rien d'autre qu'un fichier Markdown avec un en-tête YAML (le *frontmatter*), suivi du prompt système en Markdown. Voici un exemple complet, à placer dans .claude/agents/code-reviewer.md :

---
name: code-reviewer
description: Expert en revue de code. À utiliser PROACTIVEMENT après chaque modification de code pour repérer bugs, problèmes de sécurité et dette technique.
tools: Read, Grep, Glob
model: sonnet
---

Tu es un relecteur de code senior. Ta mission est de relire les changements récents et de produire une revue claire et actionnable.

Quand tu es invoqué :
1. Repère les fichiers modifiés et lis-les entièrement.
2. Analyse la lisibilité, les bugs potentiels, les failles de sécurité et les cas limites non gérés.
3. Classe tes remarques par gravité : bloquant, important, mineur.
4. Pour chaque remarque, propose une correction concrète.

Ne modifie jamais le code toi-même : tu es en lecture seule. Termine par un résumé de 3 lignes maximum.

Décryptage des quatre champs du frontmatter :

Le corps du fichier, lui, devient le prompt système de l'agent. Traitez-le comme la fiche de poste d'un collaborateur : rôle, méthode, contraintes, format de sortie attendu.

La description : le champ qui déclenche la délégation

Si vous ne deviez soigner qu'une seule chose, ce serait la description. C'est elle que Claude Code lit pour décider s'il doit router une tâche vers votre subagent. Une description vague = un agent jamais appelé (ou appelé à contretemps).

Trois règles pour une bonne description :

Comparez :

description: Aide avec le code.        # trop vague, jamais déclenché à bon escient
description: Relit le code modifié à la recherche de bugs et de failles de sécurité. À utiliser PROACTIVEMENT après chaque changement.   # clair et déclenchable

La deuxième version donne à Claude tous les signaux nécessaires pour déléguer au bon moment, sans que vous ayez à invoquer l'agent manuellement.

Restreindre les outils : le moindre privilège

Par défaut, un subagent sans champ tools hérite de tout l'arsenal de l'agent principal — y compris la capacité de modifier des fichiers et de lancer des commandes shell. Ce n'est pas toujours souhaitable.

Appliquez le principe du moindre privilège : chaque agent n'obtient que les outils dont il a besoin.

Cette discipline a un double bénéfice : elle réduit les risques (un agent en lecture seule ne peut rien casser) et elle clarifie le rôle de chaque agent, ce qui améliore aussi la qualité de ses réponses.

**Vous voulez déléguer réellement les tâches répétitives de développement à l'IA, au lieu de tout faire à la main ?** Découvrez [comment vous faire remplacer par l'IA](https://go.saas-ia.io/se-faire-remplacer-par-lia) sur la partie fastidieuse de votre travail — configuration d'agents, revue, tests, plomberie — et concentrez votre temps sur ce qui a le plus de valeur.

5 subagents utiles au quotidien

Voici cinq sous-agents qui apportent une valeur immédiate. Créez-les une fois, réutilisez-les partout.

Ces subagents se combinent très bien avec d'autres briques d'automatisation. Par exemple, un hook Claude Code peut lancer automatiquement le code-reviewer après chaque commit, et les skills (commandes slash personnalisées) standardisent les instructions que vous répétez le plus.

Cette logique de « chaque agent son rôle » n'est pas propre au développement : les métiers qui automatisent leurs processus avec des agents spécialisés — comme la prospection augmentée documentée par SuperSales — appliquent exactement le même principe de division du travail entre IA.

Projet ou utilisateur : où ranger vos subagents

Deux emplacements, deux usages :

En cas de conflit de nom, le subagent de projet l'emporte sur le subagent personnel. Cette hiérarchie vous permet de surcharger un agent générique par une version adaptée à un projet donné.

Pour les équipes, versionner les subagents dans le dépôt est une excellente pratique : chaque nouveau développeur récupère instantanément les mêmes agents que le reste de l'équipe. C'est un sujet particulièrement pertinent pour les organisations qui déploient des agents IA en interne — un enjeu que le site formation-openclaw.com documente bien sous l'angle des agents auto-hébergés et open-source en entreprise.

Bonnes pratiques et pièges à éviter

Quelques réflexes pour tirer le meilleur des subagents :

Les pièges les plus courants :

Les subagents en action (vidéo)

Pour visualiser concrètement Claude Code déléguer des tâches à ses agents et travailler en autonomie sur un vrai projet, cette démonstration de la chaîne Sophiène.IA montre l'agent à l'œuvre. Une bonne mise en contexte avant de créer vos propres sous-agents.

Passez à la vitesse supérieure

Les subagents personnalisés transforment votre façon d'utiliser Claude Code : au lieu d'un assistant unique qui fait tout, vous obtenez une petite équipe d'IA spécialisées — un relecteur, un testeur, un explorateur — que Claude orchestre au bon moment, sans saturer votre contexte. C'est simple à mettre en place (un fichier Markdown), gratuit, et immédiatement rentable.

Commencez petit : créez votre code-reviewer dès aujourd'hui, observez la différence, puis ajoutez un agent à la fois. En quelques jours, vous aurez une bibliothèque de sous-agents qui reflète vraiment votre façon de travailler.

Pour aller plus loin dans la maîtrise de Claude Code :

FAQ : subagents Claude Code

C'est quoi un subagent dans Claude Code ?

Un subagent (ou sous-agent) est un assistant IA spécialisé que Claude Code peut invoquer pour une tâche précise. Il possède sa propre fenêtre de contexte, son propre prompt système, et un accès aux outils que vous lui autorisez. Il travaille en autonomie sur sa mission (relire du code, explorer une base, écrire des tests…) puis ne renvoie qu'un résumé à la conversation principale. Résultat : votre contexte principal reste propre et l'agent principal garde le fil de la tâche globale.

Où sont stockés les subagents Claude Code ?

Dans des fichiers Markdown placés dans deux dossiers possibles. Les subagents de projet vont dans .claude/agents/ à la racine du dépôt : ils sont versionnés avec Git et partagés avec toute l'équipe. Les subagents personnels vont dans ~/.claude/agents/ : ils sont disponibles dans tous vos projets, mais uniquement pour vous. En cas de conflit de nom, le subagent de projet est prioritaire sur le subagent personnel.

Comment créer un subagent personnalisé ?

Le plus simple est de taper la commande /agents dans Claude Code, puis de suivre l'assistant : choix du niveau (projet ou personnel), nom, description, outils autorisés et prompt système. Vous pouvez aussi créer le fichier à la main : un .md dans .claude/agents/ avec un en-tête YAML (name, description, tools optionnel, model optionnel) suivi du prompt système en Markdown. Claude Code détecte automatiquement le nouveau fichier.

Quelle différence entre un subagent et une skill Claude Code ?

Un subagent est un exécutant autonome avec son propre contexte : Claude lui délègue une tâche entière. Une skill (ou commande slash personnalisée) est plutôt un modèle de prompt réutilisable qui s'exécute dans le contexte principal. En pratique, on utilise les subagents pour isoler des tâches lourdes ou spécialisées (exploration, revue, tests) et les skills pour standardiser des instructions fréquentes. Les deux sont complémentaires.

Combien de subagents peuvent tourner en parallèle ?

Claude Code peut lancer plusieurs subagents en parallèle, chacun dans sa propre fenêtre de contexte. C'est justement l'un de leurs grands avantages : pendant qu'un agent explore le code, un autre peut préparer des tests. En pratique, le nombre simultané reste modéré (quelques agents) pour garder de la lisibilité et maîtriser la consommation de tokens. Pour orchestrer de vraies équipes d'agents, voyez notre guide sur les Agent Teams.

Faut-il restreindre les outils d'un subagent ?

Oui, c'est fortement recommandé. Si vous omettez le champ tools, le subagent hérite de tous les outils de l'agent principal. Pour un agent de revue ou d'exploration, mieux vaut n'autoriser que la lecture et la recherche (Read, Grep, Glob) afin qu'il ne puisse rien modifier par accident. C'est le principe du moindre privilège : chaque agent n'obtient que ce dont il a besoin, ce qui réduit les risques et clarifie son rôle.

Les subagents consomment-ils plus de tokens ?

Chaque subagent démarre avec son propre contexte, ce qui a un coût initial. Mais globalement, ils font souvent économiser des tokens : en isolant une tâche verbeuse (lire 40 fichiers, par exemple), ils évitent de polluer le contexte principal avec des milliers de lignes qui seraient ensuite retraitées à chaque tour. On échange un coût fixe de démarrage contre un contexte principal plus léger et plus durable.