De ingebouwde notificaties van Claude Code: de terminal bell en preferredNotifChannel

01De snelle oplossing

Hoor je niets als Claude klaar is, voeg dit dan toe aan ~/.claude/settings.json:

{
  "preferredNotifChannel": "terminal_bell"
}

Zorg daarna dat je terminal iets met de bell doet: een geluid afspelen, het Dock-icoon laten stuiteren, het tabblad laten knipperen of een notificatie tonen. Die instelling zit in de terminal, niet in Claude Code. Op Mac, Windows en Linux hebben de meeste terminals een sectie "bell" of "alert" in hun voorkeuren.

02Alle waarden van preferredNotifChannel

Je kunt de instelling in elk settings-bestand zetten: user (~/.claude/settings.json), project (.claude/settings.json) of local (.claude/settings.local.json). Oudere versies bewaarden hem in ~/.claude.json, en Claude Code leest een waarde die daar nog staat nog steeds.

03Wanneer de ingebouwde notificatie afgaat

Volgens de documentatie van Anthropic heeft de ingebouwde melding dezelfde timing als de Notification-hook. In een terminalsessie:

• Permission prompt: nadat de prompt zo'n zes seconden zonder toetsaanslag heeft gewacht. Elke toets die je indrukt start het wachten opnieuw.
• Klaar: ongeveer 60 seconden nadat Claude stopt, en alleen als je sindsdien niets hebt getypt en er geen background agent meer draait.

De ingebouwde "klaar"-melding is dus bewust niet direct. Hij is bedoeld om je te bereiken als je bent weggelopen, niet om je te pingen terwijl je zit te kijken. Wil je een melding zodra een beurt eindigt, gebruik dan een Stop-hook (zie de guide over de Stop hook).

04Per terminal

iTerm2 (macOS)

iTerm2 krijgt standaard een desktopnotificatie, maar iTerm2 toont die pas als je het toestaat:

1. Open Settings > Profiles > Terminal.
2. Vink Notification Center Alerts aan.
3. Klik op Filter Alerts en zet Send escape sequence-generated alerts aan.

Controleer ook of iTerm2 notificaties mag tonen in System Settings > Notifications.

Apple Terminal (macOS)

Apple Terminal krijgt geen desktopnotificatie. Met "auto" stuurt Claude Code alleen een stille bell als Audible bell uit staat in het profiel van het voorste venster. De bell verschijnt dan als een flits van het venster, of als stuiterend Dock-icoon terwijl Terminal op de achtergrond staat, als Visual bell of de Dock-bounce-optie in het profiel aan staat.

Let op één detail. Als je de terminal-setupprompt bij de eerste start van Claude Code hebt geaccepteerd, is /terminal-setup uitgevoerd, en die zet de audible bell in je Apple Terminal-profiel uit. Wil je een geluid horen, stel dan "terminal_bell" in en zet Audible bell weer aan onder Settings > Profiles > Advanced.

Ghostty en Kitty (macOS en Linux)

Beide krijgen zonder setup een desktopnotificatie en sturen die door naar het notificatiecentrum van je besturingssysteem.

Alle andere terminals

Windows Terminal, GNOME Terminal, Konsole, Alacritty, WezTerm, Warp en IDE-terminals krijgen standaard niets. Stel "terminal_bell" in en zet de bell-afhandeling van de terminal zelf aan, of gebruik een hook. IDE-terminals hebben hun eigen eigenaardigheden; die staan in de gids voor VS Code, Cursor en JetBrains.

05Via SSH en binnen tmux

De desktopmelding is een escape sequence die de terminal op je eigen computer interpreteert, dus hij komt ook aan als Claude Code via SSH op een externe server draait. Ghostty en Kitty sturen hem zonder extra configuratie door. iTerm2 heeft de meldingsinstellingen hierboven nodig.

Binnen tmux wordt de sequence opgeslokt, tenzij je passthrough toestaat. Zet dit in ~/.tmux.conf en voer tmux source-file ~/.tmux.conf uit:

set -g allow-passthrough on

Detached sessies zijn een ander verhaal: als er geen terminal gekoppeld is, kan niets de melding tonen. Zie de tmux-gids en meldingen via SSH.

06De ingebouwde melding en hooks samen

Notification-hooks draaien naast de ingebouwde melding; ze vervangen hem niet. De documentatie van Anthropic zegt expliciet dat hooks ook afgaan met "notifications_disabled": de instelling bepaalt alleen hoe Claude Code je waarschuwt, niet of je hook draait. Zo krijg je een nette verdeling:

• Houd "auto" of "terminal_bell" aan voor de melding achter je bureau.
• Voeg een hook toe voor al het andere, zoals een systeemgeluid, een desktopmelding in een terminal die er geen krijgt, of een push naar je telefoon met ntfy.
• Toont een hook al een desktopmelding, stel dan "notifications_disabled" in zodat je er niet twee ziet.

Dit speelt bijvoorbeeld op macOS een geluid af zodra Claude aandacht nodig heeft, in elke terminal:

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

De varianten voor Linux en Windows staan in de Linux-gids en de Windows-gids.

07Beperkingen van de ingebouwde opties

• Het blijft op de computer. De bell of melding komt van de terminal op je scherm. Loop je naar de keuken, dan mis je hem.
• Het hangt af van de terminal. Veel populaire terminals krijgen niets totdat je een instelling aanpast.
• Je kunt er niet op reageren. Je hoort dat Claude wacht, maar je moet nog steeds terug naar je toetsenbord.

Remote Control van Anthropic, met de mobiele app van Claude, is de officiële manier om pushmeldingen op je telefoon te krijgen. De vergelijkingsgids zet het naast de andere opties.

08Waar Claude Code Notifier in past

Werk je achter je bureau, dan is de ingebouwde melding plus "terminal_bell" misschien alles wat je nodig hebt. Claude Code Notifier is voor als je niet achter je bureau zit. De command line tool, ccn, draait als Claude Code-hook, dus hij werkt in elke terminal op Mac, Windows en Linux, met of zonder bell-instellingen. Op zichzelf toont hij een desktopmelding als Claude klaar is, een toestemming nodig heeft of een vraag stelt. Met een gekoppelde telefoon kun je toestemmingen toestaan of weigeren, vragen van Claude beantwoorden en de volgende instructie vanaf je telefoon sturen. Heb je in de laatste 30 seconden getypt, dan wacht er helemaal niets op je telefoon. Zie de ccn-pagina.

09FAQ