Meldingen van Claude Code: hoor wanneer het wacht en wanneer het klaar is

“Een sessie die vastzit, ziet er precies zo uit als een sessie die klaar is, dus ik open eerst de verkeerde.” Die zin uit een featureverzoek voor Claude Code vat het samen. Zo krijg je voor elk van beide een ander signaal.

Door Aslan, Pet Island-team · Bijgewerkt op 26 okt. 2026 · 4 min lezen

KORT ANTWOORD

Claude Code geeft al een melding als het klaar is of op toestemming wacht terwijl je weg bent, maar alleen Ghostty, Kitty en iTerm2 tonen die standaard als bureaubladmelding. Stel elders "preferredNotifChannel": "terminal_bell" in. Voor twee verschillende geluiden gebruik je een Notification-hook met de matcher permission_prompt voor “heeft je nodig” en een Stop-hook voor “klaar”.

Wat Claude Code zelf doet

Als Claude een taak afrondt of pauzeert voor een toestemmingsprompt, en je lijkt niet bij de terminal te zijn, activeert het een notification-event. Standaard maakt het daar alleen in Ghostty, Kitty en iTerm2 een bureaubladmelding van. In Windows Terminal, de terminal van VS Code, Warp en de rest gebeurt er niets zichtbaars, tenzij je het instelt.

De eenvoudigste oplossing is de terminalbel:

~/.claude/settings.jsonKopiëren

{

"preferredNotifChannel": "terminal_bell"

}

Wat de bel doet, hangt af van je terminal. In Windows Terminal kan de instelling bellStyle audible (de standaard), window, taskbar, all of none zijn. Met all speelt Windows Terminal een geluid af en knippert het pictogram op de taakbalk.

iTerm2: Settings → Profiles → Terminal → vink “Notification Center Alerts” aan, en schakel daarna onder Filter Alerts “Send escape sequence-generated alerts” in.
tmux: voeg set -g allow-passthrough on toe aan ~/.tmux.conf, anders bereiken meldingen de buitenste terminal nooit.
Via SSH: de bureaubladmelding gaat terug naar je lokale machine, dus externe sessies kunnen je nog steeds waarschuwen.

Het featureverzoek voor systeemmeldingen (#26581, 34 upvotes) werd gesloten als al beschikbaar, met een verwijzing naar precies deze ingebouwde melding. Het verzoek om een ander signaal voor “wacht” en “klaar” (#94373) staat nog open. Daar komen hooks in beeld.

Twee events: Notification en Stop

Notification gaat af als Claude Code een melding verstuurt. De matcher is het meldingstype. De twee die ertoe doen zijn permission_prompt (Claude heeft je goedkeuring nodig voor het gebruik van een tool en de prompt wacht al ongeveer zes seconden) en idle_prompt (Claude is ongeveer 60 seconden geleden klaar met antwoorden en je hebt sindsdien niets getypt).
Stop gaat af telkens als Claude klaar is met antwoorden. Het gaat niet af als je onderbreekt; bij API-fouten gaat in plaats daarvan StopFailure af.

Hooks draaien naast de ingebouwde melding in plaats van die te vervangen, dus je kunt beide houden.

Windows: twee verschillende geluiden

Op Windows draaien hooks in Git Bash, of in PowerShell als Git Bash niet is geïnstalleerd. Met "shell": "powershell" haal je het giswerk weg. Deze configuratie speelt een hoge dubbele piep als Claude toestemming nodig heeft en een lage piep als het klaar is:

%USERPROFILE%\.claude\settings.jsonKopiëren

{

"hooks": {

"Notification": [

{

"matcher": "permission_prompt",

"hooks": [

{ "type": "command", "shell": "powershell",

"command": "[Console]::Beep(1320, 150); [Console]::Beep(1320, 150)" }

]

}

"Stop": [

{

"hooks": [

{ "type": "command", "shell": "powershell",

"command": "[Console]::Beep(660, 300)" }

]

}

]

}

Console.Beep neemt een frequentie in hertz en een duur in milliseconden, en wacht tot de piep voorbij is. De hookshandleiding van Anthropic toont ook een Windows-voorbeeld dat een berichtvenster opent met System.Windows.Forms; volgens hun eigen opmerking is dat een dialoogvenster en geen melding, en het kan achter je terminal openen.

macOS en Linux

De documentatie van Anthropic gebruikt afplay op macOS:

~/.claude/settings.jsonKopiëren

{

"hooks": {

"Notification": [

{

"matcher": "permission_prompt",

"hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]

}

"Stop": [

{

"hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Pop.aiff" }]

}

]

}

Voor een zichtbare melding gebruik je osascript -e 'display notification "Claude needs you" with title "Claude Code"' op macOS, of notify-send "Claude Code" "Claude needs you" op Linux.

Details die je een avond besparen

Stop gaat vaak af. Het gaat af telkens als Claude klaar is met antwoorden, niet alleen als een hele taak klaar is. Is dat te veel, gebruik dan in plaats daarvan de melding idle_prompt. Die wacht ongeveer een minuut en gaat alleen af als je niets hebt getypt.
Lees het event als je het nodig hebt. De invoer van Notification bevat message, title en notification_type, zodat een script het echte verzoek kan tonen.
Agent view. Draai je achtergrondsessies met claude agents, dan meldt het je via dezelfde preferredNotifChannel wanneer een sessie invoer nodig heeft, klaar is of mislukt, en laat het de Notification-hook afgaan met het type agent_needs_input of agent_completed.
Terminalstatus. Terminals die het statusprotocol OSC 7501 ondersteunen, kunnen tonen of elke Claude Code-sessie bezig is, wacht of klaar is. Claude Code v2.1.295 of later meldt dit automatisch.
Gaat een hook niet af op Windows? Zie Claude Code-hooks werken niet op Windows. Het ligt bijna altijd aan de shell.

Zien welke sessie het is en antwoorden

Een geluid vertelt je dat er iets is gebeurd. Het vertelt je niet uit welke van je drie terminals het kwam, of wat Claude wil uitvoeren. Pet Island geeft elke Claude Code-sessie een plek op een klein eiland bovenaan je scherm: bezig, wacht op jou of klaar. Een toestemmingsverzoek komt binnen met het commando of de diff, en je staat het daar meteen toe of weigert het; vragen en plannen werken op dezelfde manier. Met één klik spring je naar precies de juiste terminal als je beter wilt kijken.

VEELGESTELDE VRAGEN

Heeft Claude Code meldingen?

Ja. Als het klaar is of op toestemming wacht terwijl je weg bent, geeft het een melding. Ghostty, Kitty en iTerm2 tonen die standaard als bureaubladmelding; zet in andere terminals preferredNotifChannel op "terminal_bell" of voeg een Notification-hook toe.

Hoe krijg ik een geluid als Claude Code klaar is?

Voeg een Stop-hook toe die een geluid afspeelt, bijvoorbeeld afplay op macOS of [Console]::Beep in PowerShell op Windows.

Hoe onderscheid ik “heeft toestemming nodig” van “klaar”?

Gebruik een Notification-hook met de matcher permission_prompt voor het ene geluid en een Stop-hook voor het andere.

Waarom krijg ik geen meldingen in Windows Terminal of VS Code?

Claude Code verstuurt standaard alleen bureaubladmeldingen in Ghostty, Kitty en iTerm2. Zet preferredNotifChannel op "terminal_bell" of gebruik een hook.

Werken meldingen in tmux?

Ja, nadat je set -g allow-passthrough on hebt toegevoegd aan ~/.tmux.conf.

Bronnen

Elke instelling en elk gedrag op deze pagina is op 26 oktober 2026 gecontroleerd aan de hand van deze pagina’s. Agents veranderen snel; klopt er iets niet meer, dan geldt de officiële pagina.

VERDER LEZEN

Windows