Accueil / Étendre : compétences, MCP, sous-agents, hooks, plugins

Sous-agents : déléguer dans un contexte isolé

Un sous-agent exécute une tâche dans sa propre fenêtre de contexte, séparée de la conversation principale. Quand il termine, seule sa conclusion revient dans le fil que vous suivez : les fichiers lus, les journaux parcourus et les impasses explorées restent dans son contexte à lui. Une bonne délégation donne un objectif complet et un périmètre d'écriture nommé.

Un sous-agent exécute une tâche dans sa propre fenêtre de contexte, séparée de la conversation principale. Quand il termine, seule sa conclusion revient dans le fil que vous suivez : les fichiers lus, les journaux parcourus et les impasses explorées restent dans son contexte à lui.

Ce qui charge au démarrage, et ce qui n'y arrive pas

Un sous-agent standard reçoit son propre prompt système, le message de délégation que vous avez écrit, la hiérarchie des fichiers CLAUDE.md du dépôt et un instantané du statut git lu au démarrage du sous-agent (sauf les agents Explore et Plan), le contenu de chaque skill nommée dans son champ skills, et la liste des autres agents nommés de la session quand il dispose de SendMessage. Le style de sortie de la session principale et la mémoire automatique ne l'atteignent pas.

Les limites de concurrence et le filet de sécurité

Une session ne fait pas tourner un nombre illimité de sous-agents à la fois : la limite par défaut est de vingt sous-agents simultanés, réglable par CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS, et un sous-agent ne peut en engendrer un autre qu'à trois niveaux de profondeur par défaut sous la conversation principale, réglable par CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH.

Objectif : lister les fichiers de configuration d'un dépôt fictif
et résumer en une ligne le rôle de chacun.
Périmètre d'écriture autorisé : aucun.
Interdiction explicite : aucun commit, aucun push, aucune commande destructive.
Modèle : sonnet.

Une bonne invite de délégation donne un objectif complet, un périmètre d'écriture nommé, des interdictions explicites et un modèle choisi plutôt qu'hérité : un sous-agent ne peut pas revenir vous poser une question à mi-tâche.

Claude Code scanne le rapport final d'un sous-agent avant que le modèle principal ne le lise, car une source qu'il a lue (fichier, page web, sortie de commande) peut porter une instruction adressée à la conversation principale. Aucun sous-agent n'y échappe.

Le fork, une variante qui n'isole rien

Une variante distincte, le fork, invoquée par /subtask, ne repart pas d'un contexte vide : elle hérite de toute la conversation en cours jusqu'à l'instant de l'appel. Seul son résultat final rejoint ensuite le fil principal, comme pour un sous-agent standard, mais tout ce qui précédait l'appel était déjà connu du fork dès le départ.

Un sous-agent reste une délégation que vous décidez au moment où la tâche s'y prête. Un hook, présenté dans la leçon suivante, obéit à une autre logique : contrairement à un sous-agent, il ne choisit jamais d'appeler le modèle, il réagit à un événement du cycle de vie décidé par le harnais.

Ce qui a changé en octobre 2026

L'outil Agent accepte un paramètre effort : Claude lance le sous-agent au niveau demandé, bas pour une tâche simple. Un sous-agent peut déclarer autoCompactWindow pour compacter plus tôt que la conversation principale. Les forks sont activés par défaut dans claude -p, le SDK, l'application de bureau et VS Code, et des forks lancés ensemble savent lequel est le leur. Un sous-agent n'est pas toujours le bon outil : l'article d'Anthropic du 22 octobre 2026 les réserve au contexte saturé, aux tâches parallèles et au choix d'outils.

Un sous-agent n'arrête que ses propres processus

Arrêter node ou python par leur nom, ou par un filtre sur la ligne de commande, coupe aussi les serveurs d'outils des autres sessions de la machine. Quand le brief d'un sous-agent lui fait lancer un serveur ou un navigateur, il doit dire trois choses : noter le pid de chaque processus lancé, les arrêter par ces pid, et ne jamais arrêter un processus dont le pid n'a pas été noté. Si un outil a disparu malgré tout, /mcp permet de le rétablir.