---
## Champs de frontmatter (16)
| Champ | Type | Requis | Description |
|-------|------|----------|-------------|
| `name` | string | Oui | Identifiant unique en lettres minuscules et tirets |
| `description` | string | Oui | Quand l'invoquer. Utilise `"PROACTIVELY"` pour une auto-invocation par Claude |
| `tools` | string/list | Non | Liste d'autorisation d'outils séparés par des virgules (par ex. `Read, Write, Edit, Bash`). Hérite de tous les outils si omis. Supporte la syntaxe `Agent(agent_type)` pour restreindre les sous-agents instanciables ; l'ancien alias `Task(agent_type)` fonctionne toujours |
| `disallowedTools` | string/list | Non | Outils à refuser, retirés de la liste héritée ou spécifiée |
| `model` | string | Non | Modèle à utiliser : `sonnet`, `opus`, `haiku`, un ID de modèle complet (par ex. `claude-opus-4-6`), ou `inherit` (défaut : `inherit`) |
| `permissionMode` | string | Non | Mode de permissions : `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, ou `plan` |
| `maxTurns` | integer | Non | Nombre maximum de tours agentiques avant que le sous-agent ne s'arrête |
| `skills` | list | Non | Noms de skills à précharger dans le contexte de l'agent au démarrage (contenu complet injecté, pas seulement rendu disponible) |
| `mcpServers` | list | Non | Serveurs MCP pour ce sous-agent — chaînes de noms de serveurs ou objets `{name: config}` inline |
| `hooks` | object | Non | Hooks de cycle de vie limités à ce sous-agent. Tous les événements de hook sont supportés ; `PreToolUse`, `PostToolUse` et `Stop` sont les plus courants |
| `memory` | string | Non | Portée de la mémoire persistante : `user`, `project`, ou `local` |
| `background` | boolean | Non | Mets `true` pour toujours s'exécuter comme tâche en arrière-plan (défaut : `false`) |
| `effort` | string | Non | Surcharge du niveau d'effort quand ce sous-agent est actif : `low`, `medium`, `high`, `xhigh`, `max` (Opus 4.6 uniquement). Défaut : hérité de la session |
| `isolation` | string | Non | Mets `"worktree"` pour s'exécuter dans un worktree git temporaire (auto-nettoyé si aucun changement) |
| `initialPrompt` | string | Non | Auto-soumis comme premier tour utilisateur quand cet agent s'exécute comme agent de la session principale (via `--agent` ou le réglage `agent`). Les commandes et skills sont traités. Préfixé à tout prompt fourni par l'utilisateur |
| `color` | string | Non | Couleur d'affichage du sous-agent dans la liste des tâches et le transcript : `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, ou `cyan` |
---
##  **(5)**
| # | Agent | Modèle | Outils | Description |
|---|-------|-------|-------|-------------|
| 1 | `general-purpose` | inherit | Tous | Tâches complexes en plusieurs étapes — le type d'agent par défaut pour la recherche, la recherche de code et le travail autonome |
| 2 | `Explore` | haiku | Lecture seule (pas de Write, Edit) | Recherche et exploration rapides du codebase — optimisé pour trouver des fichiers, chercher du code et répondre à des questions sur le codebase |
| 3 | `Plan` | inherit | Lecture seule (pas de Write, Edit) | Recherche de pré-planification en mode plan — explore le codebase et conçoit des approches d'implémentation avant d'écrire du code |
| 4 | `statusline-setup` | sonnet | Read, Edit | Configure le réglage de la barre d'état Claude Code de l'utilisateur |
| 5 | `claude-code-guide` | haiku | Glob, Grep, Read, WebFetch, WebSearch | Répond aux questions sur les fonctionnalités de Claude Code, l'Agent SDK et l'API Claude |
---
## Sources
- [Créer des sous-agents personnalisés — Documentation Claude Code](https://code.claude.com/docs/en/sub-agents)
- [Référence CLI — Documentation Claude Code](https://code.claude.com/docs/en/cli-reference)
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
