Zo krijg je een melding als Claude Code of Codex klaar is

Hoe agents laten weten dat ze klaar zijn

Beide tools kunnen op het juiste moment een commando van jou uitvoeren. Meer is een melding niet: Claude Code noemt het een hook, Codex noemt het notify. Wat het commando ook doet (een geluid spelen, een banner tonen, het scherm laten oplichten), het gebeurt als de agent stopt of om invoer vraagt.

Claude Code: de ingebouwde melding

Als Claude Code klaar is, of wacht op een toestemmingsvraag, kan hij zelf een bureaubladmelding sturen. Volgens de documentatie van Anthropic werkt dat direct in Ghostty en Kitty. In iTerm2 zet je het één keer aan:

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

Draai je Claude Code in tmux? Zet set -g allow-passthrough on in ~/.tmux.conf, anders bereikt de melding je terminal nooit. In de /config-instellingen van Claude Code kun je ook kiezen hoe hij je waarschuwt (bijvoorbeeld met een terminalbel).

Bron: Claude Code-documentatie: terminal instellen

Claude Code: een hook die een geluid speelt

In Terminal van Apple, VS Code of elke andere terminal regelt een hook het. Hooks staan in ~/.claude/settings.json (voor elk project) of .claude/settings.json (één project). Twee events zijn belangrijk:

• Stop: Claude is klaar met zijn antwoord.
• Notification: Claude heeft je nodig (een toestemmingsvraag, of hij wacht al een tijdje op invoer).

Dit speelt een macOS-geluid voor allebei. Voeg het samen met je instellingenbestand (laat staan wat er al in staat):

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

Liever een banner? Gebruik dan dit commando (hetzelfde als het voorbeeld van Anthropic):

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

Typ /hooks in Claude Code om te zien wat er is ingesteld. Nieuwe hooks gelden voor sessies die je na het opslaan start. De geluiden in /System/Library/Sounds/ mag je gratis gebruiken: Glass, Ping, Pop, Purr, Submarine en meer.

Bronnen: hooks-naslag · hooks-gids

Codex: de notify-instelling

De Codex CLI voert na elke beurt een programma van jou uit, ingesteld met notify in ~/.codex/config.toml. Codex geeft een JSON-beschrijving van de beurt mee als laatste argument (het type is agent-turn-complete), die een simpel geluidscommando kan negeren:

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify is een sleutel op het hoogste niveau: zet hem boven elke [sectie] in het bestand. Codex heeft ook ingebouwde meldingen in zijn terminalinterface (notifications onder [tui]) die de eigen melding of bel van de terminal gebruiken; of je een banner ziet, hangt af van je terminal.

notify van Codex gaat af als een beurt klaar is. Er is geen apart “heeft je goedkeuring nodig”-event zoals de Notification-hook van Claude Code.

Bron: Codex-documentatie: geavanceerde configuratie

Agentmeldingen van Clacky: hetzelfde, zonder configuratie

Wil je liever geen JSON en TOML bewerken, dan heeft Clacky (een menubalk-app voor de Mac) Agentmeldingen. Het gebruikt dezelfde hooks als hierboven, dus niets kijkt mee op je scherm of leest je terminal:

1. Open het dashboard van Clacky → Agentmeldingen.
2. Klik naast Claude Code of Codex op Instellen…. Clacky laat precies zien welke regels het toevoegt; klik op Hooks toevoegen. Het bewaart een reservekopie van je bestand ernaast (settings.json.clacky-backup).
3. Klik op Testmelding sturen om beide geluiden te horen.

Wat je krijgt:

• Een ander geluid voor klaar (een stijgend akkoord) en heeft je nodig (twee tikjes en een vraag), met vijf stemmen om uit te kiezen per agent.
• Een optionele zachte gloed langs de schermrand, ongeveer een seconde lang. Je kunt erdoorheen klikken en hij komt nooit in opnames.
• Stil als hij vooraan staat (stil zolang de terminal van de agent de actieve app is) en Stil tijdens gesprekken (stil zolang de microfoon in gebruik is), allebei standaard aan.
• Een stipje per sessie in de menubalk: bezig, wachtend of klaar. Klik erop om de terminal naar voren te halen.
• Wakker houden → Tot mijn agent klaar is, zodat een lange run niet stopt omdat je Mac in slaap viel.

Claude Code werkt in elke terminal en in het Code-tabblad van de Claude-app. Codex werkt met de CLI en krijgt het klaar-geluid (Codex stuurt geen “heeft je nodig”-event). Staat er in je Codex-config al een notify-regel, dan laat Clacky die met rust en zegt het je, in plaats van hem te vervangen. Verwijderen… haalt alleen de regels van Clacky weg.

Als er niets gebeurt

• Start de sessie opnieuw. Hooks worden gelezen als een sessie start, dus een sessie die al liep geeft geen melding.
• Controleer of het bestand klopt. Eén ontbrekende komma in settings.json legt alle hooks stil. Plak het in een willekeurige JSON-checker.
• Test het commando los. Voer afplay /System/Library/Sounds/Glass.aiff uit in Terminal. Geen geluid? Controleer je uitvoerapparaat en volume.
• Geen banners? Kijk in Systeeminstellingen → Berichtgeving bij je terminal (of Scripteditor, voor osascript), en bij je focusmodi.
• Twee geluiden tegelijk? Je hebt twee opstellingen (bijvoorbeeld je eigen hook en die van Clacky). Hou er één.