---
title: "Claude Code-hooks: uitleg en toepassing | Bombos"
description: "Hooks draaien op vaste momenten in Claude Code. Gebruik PreToolUse om een toolaanroep te blokkeren; CLAUDE.md geeft het model instructies en projectcontext."
image: "https://bombos.ai/assets/og-v2.png"
---

# Wat zijn hooks in Claude Code en wanneer gebruik je ze in plaats van CLAUDE.md?

Kort antwoord

Hooks zijn handlers die Claude Code automatisch draait op vaste momenten: voor een tool-aanroep (PreToolUse), erna (PostToolUse), bij het versturen van een prompt, als Claude stopt, en meer. Gebruik ze voor wat altijd moet of nooit mag. CLAUDE.md is context die Claude meestal volgt; een PreToolUse-hook die met exitcode 2 stopt, houdt de actie echt tegen.

*Piet Baudoin · gepubliceerd 16 november 2026 · 16 november 2026*

## CLAUDE.md vraagt, een hook regelt

Het verschil zit in wie beslist. Een regel in CLAUDE.md komt in de context; het model leest hem en weegt hem mee. Meestal gaat dat goed. Maar in een lange sessie, na het samenvatten van de context of bij een lastige taak kan “nooit de map migrations aanpassen” het verliezen. De documentatie over het geheugen van Claude Code zegt het zelf: instructies zijn context, geen afdwinging, en om iets te blokkeren gebruik je een PreToolUse-hook.

Een hook is code die draait. Hij krijgt bij elk moment een stuk JSON binnen, bijvoorbeeld welke tool Claude wil gebruiken en met welke invoer, en beslist dan zelf.

| Zet het in CLAUDE.md als… | Maak er een hook van als… |
| --- | --- |
| Het om stijl of aanpak gaat | Het altijd moet gebeuren, zonder uitzondering |
| Een uitzondering soms prima is | Een fout schade doet: data, geheimen, productie |
| Claude het in de context moet afwegen | Je het met een script kunt controleren |
| Voorbeeld: “schrijf tests met pytest” | Voorbeeld: “nooit `git push --force`” |
| Voorbeeld: “gebruik onze API-conventies” | Voorbeeld: “na elke wijziging de formatter draaien” |

## De belangrijkste momenten

1.  **SessionStart**: een sessie begint of wordt hervat. Extra context laden.
2.  **UserPromptSubmit**: je verstuurt een prompt. Context toevoegen of een verzoek tegenhouden.
3.  **PreToolUse**: voordat een tool draait. De enige plek om een actie vooraf te blokkeren.
4.  **PostToolUse**: nadat een tool slaagde. Formatter of linter op gewijzigde bestanden.
5.  **Stop**: Claude wil zijn beurt afronden. Met exitcode 2 laat je hem doorwerken.
6.  **PreCompact en PostCompact**: rond het samenvatten van de context.
7.  **InstructionsLoaded**: een CLAUDE.md of rules-bestand wordt geladen. Zo zie je welke instructies meedoen.

Er zijn er meer, zoals Notification, PermissionRequest, SubagentStart en SessionEnd.

## Zo stel je er een in

1.  **Kies het bestand.** `.claude/settings.json` in de repo voor het team, `~/.claude/settings.json` voor jezelf, `.claude/settings.local.json` voor lokale uitzonderingen.
2.  **Schrijf het script.** Het leest JSON van stdin, met onder meer `tool_name` en `tool_input`.
3.  **Koppel het aan een moment en een matcher.** Onder `hooks` zet je het moment, bijvoorbeeld `PreToolUse`, een `matcher` zoals `Bash` of `Edit|Write`, en de handler met `"type": "command"` en het pad naar je script.
4.  **Laat de exitcode beslissen.** 0 is goed. 2 is een blokkerende fout: de tool-aanroep gaat niet door en wat je script naar stderr schrijft gaat terug naar Claude, zodat het een andere weg zoekt. Andere codes zijn fouten die standaard niet blokkeren; zet bij een kritieke hook `onFailure` op `"block"`, dan blokkeert hij ook bij een fout of time-out. Wil je fijner sturen, eindig dan met 0 en geef JSON terug met `hookSpecificOutput.permissionDecision` op `allow`, `deny` of `ask` (`defer` werkt alleen in niet-interactieve `-p`\-sessies).
5.  **Controleer met `/hooks`** en probeer de actie die je wilde tegenhouden.

Twee valkuilen uit de handleiding voor hooks. Een hook die bestanden beschermt, zoals een PreToolUse-hook op `.env`, houdt de bewerkingen van Claude tegen, maar Claude kan die bestanden nog steeds met shell-commando’s veranderen. Een `Edit`\-deny-regel onder `permissions.deny`, bijvoorbeeld `Edit(/.env)`, vangt een deel daarvan af; wie shell-commando’s echt wil inperken, zet volgens Anthropic sandboxing aan. En een Stop-hook die Claude laat doorwerken wordt overschreven na acht blokkades achter elkaar zonder tool-aanroep ertussen: lees `stop_hook_active` uit de JSON en stop vroeg als die `true` is.

## Het misverstand: hooks vervangen CLAUDE.md

Ze vullen elkaar aan. Een hook weet niets over hoe jullie code eruitziet of waarom een keuze gemaakt is; hij kent alleen de gebeurtenis en wat zijn script kan opzoeken. Wie alles in hooks gaat vangen, krijgt een agent die vaak tegen een muur loopt zonder te weten waarom. Zet de reden in CLAUDE.md en het slot in een hook.

## Wat dit betekent voor een team

Een hook in een gecommitte `.claude/settings.json` geeft elke ontwikkelaar dezelfde configuratie, en omdat het code is en geen tekst die geïnterpreteerd wordt, is het de plek voor de harde regels van het team. Of hij echt draait, hangt nog af van ieders instellingen, het script en de shell, en een projecthook kan iemand uitzetten. Wat niemand mag omzeilen, zet IT in managed settings. Maar hooks horen bij Claude Code: dezelfde ontwikkelaar in Cursor of ChatGPT valt er niet onder. En een hook kent alleen wat iemand in het script zette, niet wat het team vorige week in een mail besloot. Zie ook [hoe het geheugen van Claude Code werkt](https://bombos.ai/vragen/claude-code/claude-code-geheugen/) en [hoe je context deelt met je team](https://bombos.ai/vragen/claude-code/claude-code-context-delen-team/).

## Waar Bombos past

Hooks dwingen regels af die al zijn opgeschreven. Bombos is een plugin die Claude Code en de andere AI-tools van het team een gedeeld geheugen geeft waar die regels vandaan komen: wat het team geleerd heeft, wat in mail en documenten besloten is, en regels die de agent klaarzet voor de volgende vraag, terug te volgen naar hun bron. Eén ontwikkelaar kan het eerst zelf proberen op zijn eigen agents.

## Vragen die hierbij horen

Waar zet ik een hook zodat het hele team hem heeft?

In .claude/settings.json in de repo, en die commit je. Een hook in ~/.claude/settings.json geldt alleen voor jou.

Hoe zie ik welke hooks actief zijn?

Typ /hooks in Claude Code. Je ziet de hooks uit alle bronnen, ook uit plugins en beheerd beleid.

Kan een hook iets anders zijn dan een shellcommando?

Ja. De soorten handlers zijn command, http, prompt, agent (experimenteel) en mcp\_tool.

Wat doet exitcode 2 bij een Stop-hook?

Claude stopt dan niet en gaat verder met het gesprek. Handig om door te laten werken tot bijvoorbeeld de tests slagen.

## Bronnen

1.  [Claude Code docs: Hooks reference](https://code.claude.com/docs/en/hooks)
2.  [Claude Code docs: How Claude remembers your project](https://code.claude.com/docs/en/memory)
3.  [Claude Code docs: Automate actions with hooks (guide)](https://code.claude.com/docs/en/hooks-guide)

## Wat vergeet jullie AI?

1.  01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
2.  02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
3.  03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**Je spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa

## Meer vragen over Claude Code

-   [Wat zijn skills in Claude Code en wanneer maak je er een?](https://bombos.ai/vragen/claude-code/claude-code-skills-uitgelegd/)
-   [Wat zijn subagents in Claude Code en wanneer zet je ze in?](https://bombos.ai/vragen/claude-code/claude-code-subagents-uitgelegd/)
-   [Wat is Claude Code en hoe installeer ik het?](https://bombos.ai/vragen/claude-code/wat-is-claude-code/)
-   [Claude Code of Cursor voor ons ontwikkelteam?](https://bombos.ai/vragen/claude-code/claude-code-of-cursor/)
-   [Is Claude Code veilig voor bedrijfscode?](https://bombos.ai/vragen/claude-code/is-claude-code-veilig-voor-bedrijfscode/)
-   [Wat kost Claude Code en welk abonnement heb ik nodig?](https://bombos.ai/vragen/claude-code/claude-code-prijs/)
-   [Hoe deel je CLAUDE.md en context met je hele ontwikkelteam?](https://bombos.ai/vragen/claude-code/claude-code-context-delen-team/)
-   [Onthoudt Claude Code wat ik eerder zei? Hoe werkt het geheugen?](https://bombos.ai/vragen/claude-code/claude-code-geheugen/)

[Alle vragen over Claude Code →](https://bombos.ai/vragen/claude-code/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is de geheugenlaag onder elke AI die je team gebruikt. Eén gedeeld geheugen voor Claude, ChatGPT, Copilot, Cursor en je eigen agents, dat leert hoe jullie werken.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"Wat zijn hooks in Claude Code en wanneer gebruik je ze in plaats van CLAUDE.md?","description":"Hooks draaien op vaste momenten in Claude Code. Gebruik PreToolUse om een toolaanroep te blokkeren; CLAUDE.md geeft het model instructies en projectcontext.","abstract":"Hooks zijn handlers die Claude Code automatisch draait op vaste momenten: voor een tool-aanroep (PreToolUse), erna (PostToolUse), bij het versturen van een prompt, als Claude stopt, en meer. Gebruik ze voor wat altijd moet of nooit mag. CLAUDE.md is context die Claude meestal volgt; een PreToolUse-hook die met exitcode 2 stopt, houdt de actie echt tegen.","datePublished":"2026-11-16T00:00:00.000Z","dateModified":"2026-11-16T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-v2.png","mainEntityOfPage":"https://bombos.ai/vragen/claude-code/claude-code-hooks-uitgelegd/","inLanguage":"nl-NL","isPartOf":{"@type":"CollectionPage","name":"Claude Code","url":"https://bombos.ai/vragen/claude-code/"},"citation":[{"@type":"CreativeWork","name":"Claude Code docs: Hooks reference","url":"https://code.claude.com/docs/en/hooks"},{"@type":"CreativeWork","name":"Claude Code docs: How Claude remembers your project","url":"https://code.claude.com/docs/en/memory"},{"@type":"CreativeWork","name":"Claude Code docs: Automate actions with hooks (guide)","url":"https://code.claude.com/docs/en/hooks-guide"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/"},{"@type":"ListItem","position":2,"name":"Vragen","item":"https://bombos.ai/vragen/"},{"@type":"ListItem","position":3,"name":"Claude Code","item":"https://bombos.ai/vragen/claude-code/"},{"@type":"ListItem","position":4,"name":"Wat zijn hooks in Claude Code en wanneer gebruik je ze in plaats van CLAUDE.md?","item":"https://bombos.ai/vragen/claude-code/claude-code-hooks-uitgelegd/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Waar zet ik een hook zodat het hele team hem heeft?","acceptedAnswer":{"@type":"Answer","text":"In .claude/settings.json in de repo, en die commit je. Een hook in ~/.claude/settings.json geldt alleen voor jou."}},{"@type":"Question","name":"Hoe zie ik welke hooks actief zijn?","acceptedAnswer":{"@type":"Answer","text":"Typ /hooks in Claude Code. Je ziet de hooks uit alle bronnen, ook uit plugins en beheerd beleid."}},{"@type":"Question","name":"Kan een hook iets anders zijn dan een shellcommando?","acceptedAnswer":{"@type":"Answer","text":"Ja. De soorten handlers zijn command, http, prompt, agent (experimenteel) en mcp_tool."}},{"@type":"Question","name":"Wat doet exitcode 2 bij een Stop-hook?","acceptedAnswer":{"@type":"Answer","text":"Claude stopt dan niet en gaat verder met het gesprek. Handig om door te laten werken tot bijvoorbeeld de tests slagen."}}]}
```
