Subagent

Un sous-agent est un assistant spécialisé qui gère un type de tâche spécifique dans sa propre fenêtre de contexte, avec une invite système personnalisée, un accès spécifique aux outils et des permissions indépendantes. Utilisez-en un lorsqu'une tâche secondaire inonderait votre conversation principale de résultats de recherche, de logs ou de contenu de fichiers que vous ne référencerez plus ; le sous-agent gère ce travail dans son propre contexte et ne renvoie que le résumé. Claude utilise le champ description de chaque sous-agent pour décider quand déléguer.

Les sous-agents sont définis dans des fichiers .agent.md. Les emplacements vérifiés pour ces fichiers sont .claude/agents/ (pour le projet actuel, intégré au contrôle de version) et ~/.claude/agents/ (pour tous vos projets). Claude Code scanne les deux répertoires récursivement. L'identité d'un sous-agent provient uniquement de son champ name dans le frontmatter, qui doit être unique, en minuscules et séparé par des tirets ; le nom du fichier ou le chemin du sous-dossier ne contribue pas à son identité.

Les champs de frontmatter requis incluent name et description. La description indique à Claude quand déléguer des tâches à ce sous-agent. Facultativement, vous pouvez spécifier tools pour accorder l'accès à des outils spécifiques (omettre ce champ accorde l'accès à tous les outils disponibles). Le champ model peut spécifier quel modèle Claude utiliser (par exemple, sonnet, opus, haiku, fable, ou un identifiant de modèle complet) ou hériter de la valeur par défaut. Un champ skills peut être utilisé pour précharger des compétences spécifiques dans le contexte du sous-agent.

Les sous-agents de plugins ne prennent pas en charge hooks, mcpServers ou permissionMode pour des raisons de sécurité. Claude Code surveille les deux répertoires d'agents, donc les modifications apportées aux définitions de sous-agents sont appliquées en quelques secondes sans nécessiter de redémarrage. La commande /agents n'ouvre plus d'assistant de création ; elle invite l'utilisateur à demander à Claude ou à modifier directement les fichiers .agent.md.

Des compétences comme Sous-Agents peuvent lancer des IA CLI externes comme sous-agents circonscrits, tandis que Créer un Agent Personnalisé génère ces fichiers .agent.md. Pour les flux de travail complexes, Coordinateur Multi-Agents peut diviser les tâches entre les sous-agents, et Conseiller en Orchestration d'Agents aide à concevoir ces systèmes multi-agents, potentiellement en tirant parti des modèles de divulgation progressive.