Skills, CLAUDE.md, subagents, hooks, of MCP, wanneer je welke moet gebruiken

Claude Code heeft vijf aanpassingslagen. CLAUDE.md, Skills, subagents, hooks en MCP-servers. Kies de verkeerde en je krijgt een Skill die nooit wordt geactiveerd, een hook die subagentwerk doet, of een CLAUDE.md die zo opgeblazen is dat hij de helft van je context opslokt voordat je iets typt.

Hier lees je waar elk van hen thuishoort.

CLAUDE.md

Wordt geladen in elk gesprek. Gebruik het voor regels die je nooit wilt overslaan, zoals "TypeScript strikte modus" of "raak nooit het databaseschema aan".

Als een regel slechts soms belangrijk is, hoort hij hier niet thuis. Je betaalt er tokens voor bij elke prompt.

De vuistregel van Anthropic is om CLAUDE.md onder de 200 regels te houden. Vraag je bij elke regel af of het verwijderen ervan Claude daadwerkelijk fouten zou laten maken. Zo niet, verwijder hem dan. Een opgeblazen CLAUDE.md zorgt er niet voor dat Claude meer regels volgt, maar dat Claude de helft ervan negeert omdat de belangrijke regels verloren gaan in de ruis.

Als het toch meer dan 200 regels wordt, is de officiële richtlijn om referentiemateriaal naar Skills te verplaatsen of op te splitsen in .claude/rules/ bestanden die alleen worden geladen wanneer Claude werkt aan overeenkomende paden.

Skills

Markdown-bestanden die Claude automatisch laadt wanneer een verzoek overeenkomt met de beschrijving in hun frontmatter. De juiste plek voor PR-review-checklists, releaseprocedures, bibliotheekspecifieke conventies, alles taakspecifiek.

De beschrijving moet twee dingen dekken, wat de skill doet en wanneer deze te gebruiken. Sla het "wanneer" over en Claude laadt de skill nooit, hoe goed de body ook is. Plaats het belangrijkste gebruiksscenario eerst, aangezien de beschrijving beperkt is tot 1.536 tekens in de skill-lijst.

De body heeft zijn eigen limiet. Anthropic raadt aan om SKILL.md onder de 500 regels te houden en lang referentiemateriaal te verplaatsen naar aparte bestanden waarnaar de skill linkt. Zodra een skill is geladen, blijft de inhoud ervan in de context voor de rest van de sessie, dus elke regel is een terugkerende tokenkosten.

Subagents

Draaien in hun eigen contextvenster. Je geeft er een taak aan, het werkt onafhankelijk met zijn eigen tokenbudget, en je krijgt het resultaat terug.

Het beste voor parallel onderzoek, het isoleren van rommelig werk, of taken die tools nodig hebben die je niet in je hoofd-sessie wilt hebben. Het coördineren van meerdere tegelijk vereist enige zorg, aangezien ze geen staat delen.

Subagents kunnen ook Skills gebruiken, maar je moet ze expliciet bedraden met het skills frontmatter-veld. In tegenstelling tot de hoofd-sessie, worden skill-beschrijvingen niet automatisch geladen in de subagent, dus activeren op basis van beschrijvingsmatch gebeurt niet vanzelf.

Hooks

CLAUDE.md-instructies zijn adviserend, Claude beslist of hij ze volgt. Hooks zijn deterministisch. Het event wordt geactiveerd, de hook wordt uitgevoerd, geen oordeel bij betrokken. Ze zijn de enige van de vijf die het model volledig omzeilen.

De events waar de meeste mensen op inhaken zijn PreToolUse (een tool-aanroep valideren of blokkeren voordat deze wordt uitgevoerd), PostToolUse (reageren na een tool-aanroep, zoals het linten van bestanden die Claude zojuist heeft bewerkt), UserPromptSubmit (onderscheppen wat naar Claude wordt gestuurd) en SessionStart (context één keer per sessie laden).

Daarom zijn hooks de juiste plek voor guardrails. "Bewerk nooit .env" in CLAUDE.md of een Skill is een verzoek. Een PreToolUse hook die de bewerking blokkeert, is handhaving.

Als je regel is "voer X uit elke keer dat Claude Y doet", dan is dat een hook. Linters, formatters, validators, audit logging.

MCP servers

De andere vier vormen hoe Claude denkt. MCP geeft Claude nieuwe dingen te doen, zoals praten met API's, databases of interne systemen. Soms is een CLI voldoende, soms heb je echt een MCP-server nodig.

Hoe ze combineren

• CLAUDE.md voor harde regels
• Skills voor procedures en domeinkennis
• Subagents voor gedelegeerd werk
• Hooks voor automatische neveneffecten
• MCP servers voor de buitenwereld

De valkuil is alles in Skills dumpen. Een beperking die altijd geldt, hoort nog steeds in CLAUDE.md. Een neveneffect bij het opslaan van een bestand hoort nog steeds in een hook.

Voor de lange versie, de gratis Introduction to Agent Skills cursus van Anthropic op Skilljar behandelt de hele rubric, en de drie minuten durende video behandelt het in de tijd die het kost om koffie te zetten.