Subagents Claude Code : le guide complet pour déléguer en parallèle (2026)

Un subagent Claude Code (ou sous-agent) est un agent IA secondaire que la session principale lance pour traiter une tâche précise dans sa propre fenêtre de contexte isolée. Introduits en 2025 et devenus un pilier de Claude Code en 2026, les subagents permettent de déléguer l'exploration de code, l'audit ou la rédaction de tests à des agents spécialisés qui travaillent en parallèle, puis ne renvoient qu'un résumé à la conversation principale. Résultat : votre contexte reste propre, et plusieurs tâches indépendantes avancent en même temps. Depuis avril 2026, les subagents et les connexions MCP s'initialisent en parallèle, ce qui réduit nettement le temps de démarrage des workflows multi-agents.

Si vous travaillez déjà avec Claude Code mais que vous saturez votre fenêtre de contexte sur les gros projets, ou que vos tâches longues vous font perdre du temps, les subagents sont la réponse. Ce guide vous explique ce qu'ils sont, quand les utiliser, et comment les configurer concrètement.

Un subagent Claude Code, c'est quoi exactement ?

Par défaut, Claude Code travaille dans une seule fenêtre de contexte : toute votre conversation, les fichiers lus, les commandes exécutées et les réponses s'accumulent au même endroit. Sur un petit projet, c'est parfait. Sur une grosse base de code, ce contexte se remplit vite — et un contexte saturé dégrade la qualité des réponses.

Un subagent résout ce problème. C'est une instance Claude enfant que la session principale invoque pour une mission ciblée. Chaque subagent possède :

• sa propre fenêtre de contexte, indépendante de la conversation principale ;
• un system prompt personnalisé qui définit son rôle (reviewer, testeur, explorateur…) ;
• une liste d'outils restreinte (vous pouvez par exemple n'autoriser que la lecture) ;
• des permissions propres.

Quand le subagent termine, son travail verbeux — recherches de fichiers, logs, raisonnement multi-étapes — reste isolé. Seul le résumé final remonte à votre session. Votre contexte principal ne se pollue jamais avec les détails.

Pensez au subagent comme à un collègue à qui vous confiez une mission : il part fouiller, travaille de son côté, et revient avec une synthèse. Vous n'avez pas besoin de voir chaque étape de sa recherche.

Subagent ou skill : lequel choisir ?

C'est la confusion la plus fréquente en 2026. Subagents, skills, hooks et slash commands forment la « stack d'extensibilité » de Claude Code, mais ils ne servent pas la même chose.

La règle de 2026 : réfléchissez d'abord en subagent quand la tâche est isolable ou parallélisable, et passez au skill quand vous voulez les mêmes instructions exécutées en ligne, dans le contexte courant. Pour en savoir plus sur les skills, consultez notre guide Skills Claude Code : le guide complet et l'article sur l'automatisation avec hooks, skills et agents.

Pourquoi utiliser des subagents en 2026 ?

Trois bénéfices concrets expliquent leur adoption massive.

1. Économie de contexte. En isolant les tâches gourmandes (lire 40 fichiers pour comprendre une architecture, par exemple), vous évitez de remplir votre conversation principale. Vous gardez de la marge pour le vrai travail.

2. Parallélisme. La session principale peut lancer plusieurs subagents qui tournent simultanément et renvoient leurs résultats indépendamment. Pour une tâche d'exploration, le gain de temps réel est important : au lieu de chercher dix fois de suite, vous cherchez dix fois en même temps.

3. Spécialisation et coût. Chaque subagent a son propre system prompt et son propre modèle. La sélection de modèle par agent vous permet de router le raisonnement critique vers Opus, et les tâches volumineuses et peu sensibles vers Haiku — vous optimisez le coût sans sacrifier la qualité.

Un arbitrage à connaître : le parallélisme consomme plus de tokens. Si votre budget tokens est serré, faites l'exploration en séquentiel. Si c'est votre temps qui est compté, partez en parallèle.

Comment créer un subagent Claude Code ?

Deux méthodes. La plus simple est interactive : tapez la commande dédiée et laissez Claude Code vous guider.

@@@

/agents

@@@

Vous pouvez aussi définir un subagent à la main. Un subagent est un fichier Markdown avec un en-tête YAML (frontmatter), placé dans \