Wil je een melding als Claude Code klaar is, voeg dan een Stop-hook toe aan ~/.claude/settings.json die het notificatiecommando van je systeem uitvoert. Stop gaat af zodra Claude klaar is met antwoorden. Voor "Claude heeft mijn input nodig" voeg je ook een Notification-hook toe: die gaat af als een permissieprompt zo'n zes seconden heeft gewacht, of als Claude ongeveer een minuut idle is. Beide werken op Mac, Windows en Linux, en een tool als Claude Code Notifier kan dezelfde meldingen naar je telefoon sturen.
01Wat Claude Code zelf al doet
Claude Code probeert je al te waarschuwen als je niet bij de terminal lijkt te zijn. Standaard stuurt het een desktopmelding in iTerm2, Ghostty en Kitty, laat het mogelijk een bell-teken horen in Apple Terminal en doet het niets in andere terminals. In iTerm2 moet je ook eerst de meldingsinstellingen aanzetten voordat je iets ziet.
Gebruik je dus de terminal van VS Code, Warp, Windows Terminal of de meeste Linux-terminals, dan krijg je meestal niets. Je kunt een terminal bell afdwingen met de instelling preferredNotifChannel, zie de gids over de terminal bell. Voor een echte desktopmelding in elke terminal heb je een hook nodig.
02De twee hooks die je nodig hebt
Hooks zijn commando's die Claude Code op vaste momenten in een sessie uitvoert. Twee daarvan zijn hier belangrijk:
StopAls Claude klaar is met antwoorden (niet als je hem onderbreekt)"Claude is klaar"Notification met matcher permission_promptEen permissieprompt heeft zo'n zes seconden gewacht zonder dat je iets typte"Claude wacht op goedkeuring"Notification met matcher idle_promptOngeveer 60 seconden nadat Claude klaar was, als je sindsdien niets hebt getyptEen herinnering dat jij aan de beurt bentStop is de snelle. Die draait direct aan het eind van elke beurt. De Notification-types gaan alleen af als je wegkijkt: elke toetsaanslag stelt ze uit, dus je krijgt geen ping terwijl je meekijkt. Wil je een signaal op het moment dat Claude om toestemming vraagt, gebruik dan de PermissionRequest-hook, beschreven in de PermissionRequest-gids.
Hoe hooks in het algemeen werken (events, matchers, settingsbestanden, exitcodes) lees je in Claude Code-hooks uitgelegd.
03Een werkende setup op macOS
Open ~/.claude/settings.json (maak het aan als het nog niet bestaat) en voeg dit toe. Staat er al een hooks-object in het bestand, voeg Stop en Notification dan als keys daarin toe in plaats van het te vervangen.
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude has finished\" with title \"Claude Code\"'"
}
]
}
],
"Notification": [
{
"matcher": "permission_prompt|idle_prompt",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
}
]
}
]
}
}Stop heeft geen matcher, dus die gaat bij elke beurt af. De Notification-matcher beperkt hem tot de twee types die "kom terug" betekenen.
Verschijnt er niets, dan blokkeert macOS misschien Script Editor, dat osascript gebruikt om meldingen te tonen. Voer osascript -e 'display notification "test"' één keer uit in Terminal, open dan System Settings > Notifications, zoek Script Editor en zet Allow Notifications aan.
04Dezelfde setup op Linux en Windows
Houd de JSON-structuur hierboven aan en vervang alleen de command-strings.
Linux (vereist een desktop-notificatiedaemon, dus niet op een headless server):
"command": "notify-send 'Claude Code' 'Claude has finished'"Ontbreekt notify-send? Installeer dan libnotify-bin op Debian en Ubuntu, of het equivalent voor je distributie. Voor SSH- en serversetups, zie notificaties via SSH.
Windows (PowerShell). Het voorbeeld van Anthropic zelf opent een berichtvenster in plaats van een toast in de hoek:
"command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude has finished', 'Claude Code')\""Het venster kan achter je terminalvenster openen, dus test het commando eerst in PowerShell. Onder WSL moet powershell.exe bereikbaar zijn via Windows-interop. De Windows-gids behandelt andere opties.
05Controleer of het werkt
- Typ
/hooksin Claude Code. Je hooks zouden onderStopenNotificationmoeten staan. - Stel Claude een korte vraag. Zodra er antwoord komt, zou de
Stop-notificatie moeten verschijnen. - Vraag iets waarvoor toestemming nodig is, schakel naar een ander venster en wacht. De
permission_prompt-notificatie komt na ongeveer zes seconden.
Wijzigingen in settings.json worden normaal direct opgepikt. Staat een hook niet in /hooks? Controleer dan of het bestand geldige JSON is (geen komma's aan het eind, geen commentaar). Start Claude Code met claude --debug om te zien wat elke hook deed. Meer oplossingen vind je in de troubleshooting-checklist.
06De melding op je telefoon krijgen
Een desktopnotificatie heb je alleen iets aan als je achter je bureau zit. Loop je weg, dan wil je de melding ergens anders. Er zijn drie gangbare routes:
- Een pushdienst die je zelf draait, zoals ntfy, aangeroepen met
curlvanuit dezelfde hooks. Goedkoop en flexibel. Zie de ntfy-gids. - Een chat-webhook voor Telegram, Slack of Discord. Handig als je toch al de hele dag in de chat zit. Zie de gids over chat-webhooks.
- Claude Code Notifier, dat de hooks voor je regelt en waarmee je vanaf je telefoon kunt antwoorden.
De DIY-routes zijn prima als je alleen een ping wilt. Hun beperking is dat ze eenrichtingsverkeer zijn. Je weet dat Claude wacht, maar je moet nog steeds terug naar je toetsenbord om iets goed te keuren.
Claude Code Notifier is een onafhankelijke tool (niet gemaakt door Anthropic) die uit twee delen bestaat: ccn, een gratis commandlinetool voor Mac, Windows en Linux, en apps voor iPhone en Android. Installeren doe je met één regel:
curl -fsSL https://claudecodenotifier.com/install.sh | shGebruik op Windows irm https://claudecodenotifier.com/install.ps1 | iex in PowerShell (Windows-ondersteuning is in bèta). Andere opties, waaronder Homebrew, npx @touchtap/ccn en de Claude Code-plugin, vind je op de ccn-pagina.
De installatie voegt zeven hook-entries toe die elk ccn hook uitvoeren, laat de rest van je settings.json ongemoeid en slaat er eenmalig een backup naast op. Ook zonder telefoon toont ccn een desktopnotificatie op je computer wanneer Claude klaar is, toestemming nodig heeft of een vraag stelt. Dat deel is gratis en werkt zonder netwerk.
Koppel een telefoon met ccn pair en je krijgt daarnaast:
- een push "Claude is klaar" zodra een beurt eindigt;
- toestemmingsverzoeken die je eenmalig of voor de hele sessie kunt toestaan, of kunt weigeren;
- de meerkeuzevragen van Claude, te beantwoorden vanaf je telefoon;
- een invoerveld om Claude direct na afloop zijn volgende instructie te sturen.
Heb je in de afgelopen 30 seconden getypt, dan wacht er niets op je telefoon en vraagt de terminal het gewoon zoals altijd. De apps vereisen een abonnement of een lifetime-aankoop; zie prijzen. Een telefoon koppelen loopt de setup stap voor stap door.
07FAQ
Waarom duurt het zo lang voordat mijn Notification hook afgaat?
Het type permission_prompt wacht tot de prompt ongeveer zes seconden in beeld staat zonder dat je typt, en idle_prompt wacht ongeveer 60 seconden nadat Claude klaar is. Die vertraging is bewust, zodat je geen ping krijgt terwijl je zit te kijken. Gebruik een Stop-hook voor een directe melding dat het klaar is, en een PermissionRequest-hook voor een directe melding dat er goedkeuring nodig is.
Gaat de Stop hook af als ik op Esc druk om Claude te onderbreken?
Nee. Stop draait niet als de beurt eindigt omdat jij hem onderbrak. Hij draait ook niet als de beurt eindigt met een API-fout, zoals een rate limit. Claude Code vuurt daarvoor een apart StopFailure-event af, waar je op dezelfde manier een hook aan kunt hangen.
Gaat een Stop hook af na elk bericht, of pas als de hele taak klaar is?
Na elke beurt. Claude Code weet niet wanneer je hele taak af is, alleen wanneer het gestopt is met antwoorden. Bij een lang heen-en-weer krijg je dus één melding per antwoord. Is dat te veel, gebruik dan de idle_prompt-notificatie, die pas afgaat als je ongeveer een minuut weg bent.
Werkt dit in de terminal van VS Code of JetBrains?
Ja. Hooks worden door Claude Code zelf uitgevoerd, niet door de terminal, dus ze werken in elke terminal, ook in IDE-terminals. Alleen de ingebouwde notificaties zijn afhankelijk van de terminal. Zie de gids over IDE-terminals.
Kan ik meldingen op mijn telefoon krijgen zonder er iets op te installeren?
Deels. Een hook die naar ntfy of een chat-webhook post, kan een app bereiken die je al hebt. Die kan je alleen laten weten dát er iets gebeurd is. Wil je vanaf je telefoon goedkeuren of antwoorden, dan heb je iets nodig dat je antwoord terugstuurt naar de hook, en dat is precies wat de apps van Claude Code Notifier doen.