57 lines
4.5 KiB
Markdown
57 lines
4.5 KiB
Markdown
# Bonnes pratiques — Sous-agents
|
|
|
|
 <br>
|
|
[](../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` |
|
|
|
|
---
|
|
|
|
##  **(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)
|