Subagent

Een subagent is een gespecialiseerde assistent die een specifiek type taak afhandelt in zijn eigen context-window, met een aangepaste systeemprompt, specifieke tooltoegang en onafhankelijke permissies. Gebruik er een wanneer een neventaak uw hoofdconversatie zou overspoelen met zoekresultaten, logs of bestandsinhoud waarnaar u niet opnieuw zult verwijzen; de subagent handelt dat werk af in zijn eigen context en retourneert alleen de samenvatting. Claude gebruikt het description veld van elke subagent om te beslissen wanneer te delegeren.

Subagents worden gedefinieerd in .agent.md bestanden. Geverifieerde locaties voor deze bestanden zijn .claude/agents/ (voor het huidige project, opgenomen in versiebeheer) en ~/.claude/agents/ (voor al uw projecten). Claude Code scant beide directories recursief. De identiteit van een subagent komt uitsluitend van zijn name frontmatter veld, dat uniek, kleine letters en met koppeltekens gescheiden moet zijn; de bestandsnaam of submap pad draagt niet bij aan zijn identiteit.

Vereiste frontmatter velden zijn onder andere name en description. De description vertelt Claude wanneer taken aan deze subagent moeten worden gedelegeerd. Optioneel kunt u tools specificeren om toegang te verlenen tot specifieke tools (het weglaten van dit veld verleent toegang tot alle beschikbare tools). Het model veld kan specificeren welk Claude model te gebruiken (bijv. sonnet, opus, haiku, fable, of een volledige model-ID) of de standaard overerven. Een skills veld kan worden gebruikt om specifieke skills voor te laden in de context van de subagent.

Plugin subagents ondersteunen geen hooks, mcpServers, of permissionMode om veiligheidsredenen. Claude Code monitort beide agent directories, dus wijzigingen in subagent definities worden binnen enkele seconden toegepast zonder een herstart te vereisen. De /agents commando opent geen creatiewizard meer; het vraagt de gebruiker om Claude te vragen of de .agent.md bestanden direct te bewerken.

Skills zoals Sub-Agents kunnen externe CLI AI's spawnen als gescoopte subagents, terwijl Create Custom Agent deze .agent.md bestanden scaffoldt. Voor complexe workflows kan Multi-Agent Coordinator taken verdelen over subagents, en Agent Orchestration Advisor helpt bij het ontwerpen van deze multi-agent systemen, mogelijk gebruikmakend van progressive-disclosure patronen.