« Agents » est le mot le plus galvaudé du moment. Dans Claude Code, il a un sens précis et utile, très éloigné des promesses du type « une armée d'IA qui travaille pour vous pendant que vous dormez ». Cette page dit ce que c'est, quand ça sert vraiment, comment en créer un sans écrire de code, et ce que ça coûte.
Agent, sous-agent : de quoi parle-t-on ?
Claude Code est déjà un agent : vous lui confiez un objectif, il enchaîne lui-même les étapes (lire les fichiers, modifier, lancer une commande, vérifier) jusqu'à l'atteindre.
Les sous-agents sont des assistants que Claude Code lance pour une tâche annexe. Chacun a, selon la documentation d'Anthropic :
- sa propre mémoire de travail, séparée de votre conversation ;
- ses propres consignes, écrites pour sa spécialité ;
- ses propres outils et permissions : un sous-agent peut, par exemple, n'avoir le droit que de lire.
Quand il a fini, il ne rapporte à Claude qu'un résumé. C'est tout l'intérêt : les centaines de lignes qu'il a lues ou produites pour y arriver ne viennent pas encombrer votre conversation.
Une image : vous êtes avec un chef de chantier (Claude Code). Plutôt que d'aller lui-même mesurer chaque pièce et de vous lire toutes les mesures, il envoie quelqu'un, qui revient avec « deux pièces ne sont pas aux normes, voici lesquelles ».
Les trois principaux agents déjà fournis
Claude Code les utilise tout seul, sans que vous ayez rien à faire :
| Agent | Ce qu'il fait | Ce qu'il peut faire |
|---|---|---|
| Explore | Chercher et comprendre dans les fichiers d'un projet, rapidement | Lire seulement, aucune modification |
| Plan | Rassembler les informations quand vous êtes en mode Plan, avant de proposer un plan | Lire seulement |
| General-purpose | Les tâches en plusieurs étapes qui demandent de chercher et d'agir | Tous les outils disponibles pour les sous-agents |
Quand vous voyez passer dans la conversation une ligne avec un nom d'agent et une courte description de tâche, c'est Claude qui délègue.
Quand un sous-agent est utile, et quand il ne l'est pas
La documentation d'Anthropic donne des critères clairs, que je reformule :
Un sous-agent est utile quand :
- la tâche produit beaucoup de texte dont vous n'avez pas besoin (lancer tous les tests et ne remonter que les échecs, lire de longs journaux d'erreurs, parcourir tout un site) ;
- vous voulez limiter ce qu'il a le droit de faire (un relecteur qui ne peut rien modifier) ;
- plusieurs recherches indépendantes peuvent avancer en même temps.
Restez dans la conversation principale quand :
- vous faites des allers-retours rapides, « change ça, non plutôt ça » ;
- les étapes partagent beaucoup de contexte (préparer, construire, tester la même fonction) ;
- c'est une petite modification ciblée ;
- vous êtes pressé : un sous-agent repart de zéro et doit d'abord se renseigner.
Et si ce que vous voulez, c'est une procédure réutilisable qui s'applique dans votre conversation, ce n'est pas un agent qu'il vous faut mais un skill.
Créer votre premier sous-agent, en français
Pas besoin d'écrire de fichier vous-même. La documentation d'Anthropic montre la méthode la plus simple : le demander à Claude. Par exemple :
Crée un sous-agent personnel nommé relecteur, dans le dossier des agents
personnels pour qu'il serve dans tous mes projets. Il relit les pages
modifiées du site, cherche les fautes, les liens cassés, les textes qui
débordent sur téléphone et les informations incohérentes. Il ne doit rien
modifier : lecture seule. Il me rend une liste courte, classée par gravité.
Claude écrit un fichier qui ressemble à ceci :
---
name: relecteur
description: Relit les pages modifiées et signale fautes, liens cassés et problèmes d'affichage. À utiliser après chaque modification de contenu.
tools: Read, Grep, Glob
---
Tu es un relecteur exigeant. Pour chaque page modifiée, signale les fautes,
les liens cassés, les textes qui débordent sur téléphone et les informations
incohérentes. Ne modifie rien. Rends une liste courte, classée par gravité.
Les lignes qui comptent :
description: c'est en la lisant que Claude décide de faire appel à l'agent. La documentation conseille d'y mettre « use proactively » (ou l'équivalent) si vous voulez qu'il soit appelé de lui-même.tools: la liste de ce qu'il a le droit de faire. Ici, lire et chercher, rien d'autre.model(facultatif) : on peut faire tourner un agent simple sur un modèle plus léger, comme Haiku, pour consommer moins.
Où il est enregistré :
| Emplacement | Où il sert |
|---|---|
.claude/agents/ dans votre dossier utilisateur | Tous vos projets sur cet ordinateur |
.claude/agents/ dans le projet | Ce projet seulement, et toute personne qui travaille dessus |
Si Claude ne trouve pas votre nouvel agent alors que le dossier des agents vient d'être créé, redémarrez Claude Code : une session en cours ne détecte pas un dossier qui n'existait pas à son lancement.
L'utiliser
Trois façons, de la plus souple à la plus directive :
- Le nommer dans votre demande : « Utilise le relecteur sur les pages que tu viens de modifier. » Claude décide de déléguer.
- Le mentionner avec @ : tapez
@et choisissez l'agent dans la liste, comme vous le feriez pour un fichier. Il sera lancé à coup sûr. - Laisser Claude l'appeler seul quand la tâche correspond à la description.
Un sous-agent peut tourner au premier plan (la conversation attend qu'il ait fini) ou en arrière-plan (vous continuez à travailler pendant ce temps) ; par défaut, ceux que Claude lance depuis votre conversation démarrent en arrière-plan. Si un sous-agent en arrière-plan a besoin d'une autorisation, Claude Code vous la soumet dans la conversation principale en précisant de quel agent elle vient.
Ce que ça coûte vraiment
C'est le point à ne pas oublier. Sur un abonnement, les sous-agents ne sont pas facturés à part, mais chacun envoie ses propres requêtes, qui comptent dans la même limite d'utilisation que vous. La documentation d'Anthropic le répète : lancer plusieurs sessions ou sous-agents en même temps multiplie la consommation, et leurs résultats, en revenant dans la conversation, prennent aussi de la place.
Les limites techniques, à connaître :
- 20 sous-agents en même temps par session, par défaut ;
- trois niveaux d'imbrication : un sous-agent peut en lancer d'autres, jusqu'à trois niveaux sous la conversation principale ;
- un avertissement au démarrage si les descriptions de tous vos agents dépassent 15 000 « tokens » (l'unité de texte que compte le modèle, un morceau de mot) : gardez-les courtes.
Si vous êtes sur l'offre Pro, allez-y doucement avec les agents en parallèle : c'est le meilleur moyen d'atteindre votre limite des 5 heures en milieu de matinée. Les offres et leurs limites sont détaillées sur la page prix de Claude Code.
Au-delà des sous-agents : faire travailler plusieurs Claude
Anthropic distingue cinq façons de mener plusieurs tâches à la fois. Pour quelqu'un qui ne code pas, voici ce qu'il faut en retenir au 14/11/2026 :
| Façon | Ce que c'est | Pour vous ? |
|---|---|---|
| Sous-agents | Des assistants délégués dans une même session | Oui, c'est le premier pas |
| Sessions en parallèle | Plusieurs conversations Claude Code, chacune sur sa tâche : dans la barre latérale de l'application de bureau, ou réunies dans le terminal par la commande claude agents (fonction encore en avant-première) | Oui, dès que vous menez deux chantiers |
| Projets | Une conversation suivie sur claude.ai/code ou dans l'application de bureau, qui lance elle-même des sessions parallèles, dans le cloud ou sur votre ordinateur. Bêta publique sur Pro, Max et Ultra, ouverte progressivement aux comptes | Pour un travail qui s'étale sur des jours ou des semaines |
| Agent teams | Une session chef qui répartit les tâches entre plusieurs sessions qui se parlent | Expérimental, désactivé par défaut, dans le terminal et pas dans l'application de bureau : pas pour débuter |
| Workflows dynamiques | Un script qui orchestre de nombreux sous-agents et recoupe leurs résultats | Pour de très gros chantiers (un audit complet, des centaines de fichiers) |
Quand deux sessions travaillent sur le même projet, le risque est qu'elles modifient les mêmes fichiers. Claude Code peut donner à chaque session sa propre copie de travail, un « worktree ». Dans l'application de bureau, pour un projet sauvegardé avec Git, il suffit d'activer l'option Worktree sous la zone de saisie avant de démarrer la session.
Les erreurs à éviter avec les agents
Créer des agents avant d'en avoir besoin. Une équipe de dix agents spécialisés le premier jour, c'est dix descriptions chargées à chaque session et des délégations que vous ne comprenez pas. Créez un agent le jour où une tâche annexe noie votre conversation.
Oublier qu'un sous-agent part de zéro. Il ne connaît pas votre conversation, et la mémoire automatique de la conversation principale ne lui est pas transmise. Mettez dans ses consignes ce qu'il doit savoir, ou demandez à Claude de lui transmettre le contexte utile.
Donner tous les droits par défaut. Un relecteur n'a pas besoin de modifier, un chercheur n'a pas besoin de publier. Listez les outils autorisés : c'est la meilleure protection contre une mauvaise surprise.
Confondre « agent Claude Code » et « agent IA d'entreprise ». Les sous-agents de Claude Code vous aident à construire. Un agent qui répond à vos clients ou qui traite vos commandes tous les jours est un autre sujet, qui se construit, se surveille et se plafonne comme un produit à part entière : mon agence l'explique sur la page agents IA en entreprise.
Pour aller plus loin
- Débuter avec Claude Code avant de déléguer : le guide Claude Code pour débutants.
- Brancher vos agents sur vos outils : les MCP.
- Écrire les procédures que vos agents appliqueront : les skills.
Si vous voulez mettre en place vos premiers agents sur votre projet sans y passer la semaine, on peut le faire ensemble en trente minutes pendant une visio de déblocage. Et si vous préférez que je construise l'application entière, c'est la formule « Je le fais pour vous ».
