# Bonnes pratiques — Sous-agents

![Last Updated](https://img.shields.io/badge/Last_Updated-Jun%2002%2C%202026%2011%3A37%20AM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.160-blue?style=flat&labelColor=555)<br>
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-subagents-implementation.md)

Sous-agents Claude Code — champs de frontmatter et types d'agents intégrés officiels.

<table width="100%">
<tr>
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
</tr>
</table>

---

## 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` |

---

## ![Official](../../!/tags/official.svg) **(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)
