La documentation officielle Claude Code introduit les "subagents", des assistants IA spécialisés conçus pour améliorer les workflows task-specific et optimiser la gestion du contexte dans l'environnement de développement. Ces subagents sont des personnalités IA préconfigurées auxquelles Claude Code peut déléguer des tâches, chacune opérant avec un purpose distinct et une expertise domaine ciblée.
Caractéristiques Fondamentales
Chaque subagent possède quatre attributs essentiels : une fenêtre de contexte indépendante qui évite la pollution du contexte conversationnel principal, un ensemble d'outils configurables spécifiques à son domaine, et un system prompt personnalisé guidant son comportement. Cette isolation contextuelle permet une résolution de problèmes plus focalisée et efficace, les instructions fine-tuned améliorant les taux de succès sur tâches désignées.
Avantages Structurels
Les subagents offrent quatre bénéfices majeurs : préservation du contexte en maintenant la conversation principale focalisée sur objectifs high-level, expertise spécialisée via instructions détaillées pour domaines spécifiques améliorant performance, réutilisabilité cross-projects avec possibilité de partage team promouvant workflows consistants, et permissions flexibles avec contrôle granulaire d'accès outils par type de subagent pour sécurité renforcée.
Création et Configuration
La création s'initie via commande /agents dans Claude Code, permettant sélection entre subagents project-level ou user-level. Les utilisateurs définissent le purpose et accordent accès outils spécifiques. Les subagents sont stockés comme fichiers Markdown avec YAML frontmatter : .claude/agents/ pour project-level, ~/.claude/agents/ pour user-level. Les champs de configuration incluent name (unique identifier), description (purpose description), tools (liste comma-separated optionnelle), et model (spécification optionnelle comme sonnet, opus, haiku, ou inherit).
Exemples Pratiques et Patterns
La documentation fournit trois exemples archétypaux : Code reviewer expert en qualité et sécurité code utilisant Read, Grep, Glob, Bash; Debugger spécialisé en root cause analysis avec Read, Edit, Bash, Grep, Glob; Data scientist expert SQL et BigQuery analysis utilisant Bash, Read, Write. Ces patterns illustrent comment limiter l'accès outils au strict nécessaire améliore sécurité et focus.
Gestion et Invocation
La commande /agents offre interface interactive pour viewing, creating, editing, deleting subagents et managing tool permissions. Alternative : gestion directe fichiers. Claude Code peut déléguer automatiquement tâches aux subagents basé sur task description, subagent configuration et contexte courant. Invocation explicite possible par mention du nom.
Best Practices et Cas d'Usage Avancés
Les recommandations clés incluent : démarrer avec agents Claude-generated pour calibration initiale, designer subagents focused avec responsabilités claires, écrire system prompts détaillés, limiter accès outils au strict minimum, utiliser version control pour subagents projet. Les usages avancés comprennent chaînage de multiples subagents pour workflows complexes et leverage de sélection dynamique où Claude choisit automatiquement le subagent approprié selon contexte. Cette architecture modulaire permet composition flexible de capacités spécialisées tout en maintenant séparation des préoccupations et clarté contextuelle.