Een Subagent Maken

Claude Code wordt geleverd met ingebouwde subagents, maar je kunt ook je eigen maken. Aangepaste subagents zijn gespecialiseerd in specifieke taken -- zoals het beoordelen van code, het schrijven van tests of het controleren van documentatie. Ze worden gedefinieerd als markdown-bestanden met YAML frontmatter die Claude vertellen wanneer de subagent moet worden gebruikt en hoe deze zich moet gedragen.

De gemakkelijkste manier om een subagent te maken is met de /agents slash command. Dit opent de hoofdinterface voor het beheren van je subagents. Selecteer daar Create new agent.

Je wordt eerst gevraagd om het bereik van je subagent te kiezen:

Project-level \-- alleen beschikbaar in het huidige project
User-level \-- gedeeld over alle projecten op je machine

Vervolgens kun je kiezen hoe je het wilt maken. Je kunt de configuratie handmatig schrijven, maar de aanbevolen aanpak is om Claude het voor je te laten genereren. Beschrijf gewoon wat je wilt dat de subagent doet, en Claude zal een naam, beschrijving en system prompt voor je genereren op basis van je invoer.

Tools Aanpassen

Tijdens het maken krijg je de kans om aan te passen welke tools de subagent kan gebruiken. De toolcategorieën zijn:

Read-only tools
Edit tools
Execution tools
MCP tools
Other tools

Denk na over wat je subagent echt nodig heeft. Een code reviewer heeft waarschijnlijk geen edit tools nodig -- het moet code lezen en analyseren, niet veranderen. Je wilt echter execution tools ingeschakeld houden zodat het gemakkelijker in behandeling zijnde wijzigingen kan identificeren.

Een Model en Kleur Kiezen

Na het configureren van tools selecteer je welk Claude model de subagent aandrijft. Je opties zijn:

Haiku \-- het beste voor snelle, lichte taken
Sonnet \-- een goed evenwicht tussen snelheid en diepgang
Opus \-- het beste voor complexe analyse
Inherit \-- gebruikt welk model je hoofdgesprek ook gebruikt

Tot slot kies je een kleur. Dit verschijnt in de UI zodat je snel kunt zien welke subagent actief is. Het is een klein detail, maar het helpt wanneer je meerdere subagents tegelijk hebt draaien.

Het Configuratiebestand

Nadat het maken is voltooid, wordt het subagent-configuratiebestand opgeslagen in je project (meestal op . claude/agents/your-agent-name. md). Hier is wat een typisch subagent-configuratiebestand eruit ziet:

--- name: code-quality-reviewer description: Use this agent when you need to review recently written or modified code for quality, security, and best practice compliance. tools: Bash, Glob, Grep, Read, WebFetch, WebSearch model: sonnet color: purple ---

You are an expert code reviewer specializing in quality assurance, security best practices, and adherence to project standards. Your role is to thoroughly examine recently written or modified code and identify issues that could impact reliability, security, maintainability, or performance.

Laten we elk veld uitleggen:

name \-- Een unieke identifier voor de subagent. Dit is hoe je ernaar verwijst, ofwel door Claude rechtstreeks te vragen ofwel door @agent code-quality-reviewer in je bericht in te typen.
description \-- Bepaalt wanneer Claude besluit de subagent te gebruiken. Dit moet een enkele regel zijn (gebruik escaped newline characters \n als je onderbrekingen nodig hebt). Je kunt hier voorbeeldgesprekken opnemen om Claude te helpen begrijpen wanneer delegatie passend is.
tools \-- Geeft een lijst van tools die de subagent kan gebruiken. Dit komt overeen met wat je tijdens het genereren hebt geselecteerd, maar je kunt de lijst hier op elk moment bewerken.
model \-- Geeft aan welk Claude model moet worden gebruikt: sonnet, opus, haiku, of inherit.
color \-- De UI-kleur voor het identificeren van de subagent.

System Prompts

De inhoud van het markdown-bestand (alles onder de YAML frontmatter) is de system prompt. Dit is waar je de subagent zijn instructies geeft: waar het op moet focussen, hoe het dingen moet analyseren en hoe het bevindingen terug moet rapporteren aan de hoofdagent.

Een goed geschreven system prompt is het verschil tussen een nuttige subagent en een die het punt mist. Wees specifiek over wat de subagent moet zoeken en hoe het zijn output moet structureren.

Claude Je Subagent Automatisch Laten Gebruiken

Als je wilt dat Claude taken aan de subagent delegeert zonder dat je het expliciet vraagt, voeg je het woord "proactively" toe aan het beschrijvingsveld. Bijvoorbeeld:

description: Proactively suggest running this agent after major code changes...

Je kunt ook voorbeeldgesprekken toevoegen aan de beschrijving om Claude te helpen begrijpen welke specifieke scenario's zijn waarin de subagent moet worden gebruikt. Hoe concreter je voorbeelden, hoe beter Claude leert wanneer het werk naar je subagent moet delegeren.

Je Subagent Testen

Na het maken van je subagent test je het door enkele codewijzigingen aan te brengen en Claude te vragen deze te beoordelen.

Als de subagent niet wordt gebruikt wanneer je dat verwacht, ga je terug en controleer je de beschrijving. Het toevoegen van meer specifieke voorbeelden en triggerscenario's helpt Claude begrijpen wanneer het werk naar je subagent moet delegeren.