Theuws.com / tools Inventarisatie

Hoor wat Claude Code doet.

Een geluid als Claude klaar is, een ander als er iets misgaat, en een seintje als het op jou wacht. Je kunt wegkijken van je scherm en toch weten waar het staat. Een paar hooks en een klein script, geen app. Gratis.

Lees de instructie
Platform
macOS
Nodig
Node.js en Claude Code
Werkt via
Hooks van Claude Code
Afhankelijkheden
Geen externe pakketten
Hoe het werkt

Claude meldt, het script speelt af.

  1. Claude Code meldt een gebeurtenisBij het starten van een sessie, na een bewerking, bij een fout of als het klaar is, roept een hook het script aan.
  2. Het script kiest een geluidHet kijkt of het geluid aanstaat, of het niet te snel na het vorige komt, en kiest bij meerdere varianten er willekeurig een.
  3. Je Mac speelt het afVia afplay, op de achtergrond. Het script stopt meteen, dus Claude wacht nooit op het geluid.
Wanneer je iets hoort

Acht momenten, elk met een eigen geluid.

Elk moment zet je los aan of uit. Wil je alleen horen dat Claude klaar is, dan zet je de rest uit.

MomentHookGeluid
Sessie startSessionStartready
Je stuurt een opdrachtUserPromptSubmitacknowledge
Claude bewerkt een bestandPostToolUsework
Claude voert een commando uitPostToolUsecommand
Er gaat iets misPostToolUseFailureerror
Claude is klaarStopdone
Claude vraagt toestemmingNotificationalert
Claude wacht op jouNotificationidle
Wat het kan

Klein, en het zit je niet in de weg.

Meteen bruikbaar
Het standaardpakket gebruikt de systeemgeluiden van macOS. Er hoeft niets gedownload te worden.
Eigen geluiden
Een map met geluidsbestanden en een pack.json is een eigen pakket. MP3, WAV, AIFF en M4A werken allemaal.
Variatie
Geef een moment meerdere geluiden, dan kiest het script er elke keer willekeurig een. Zo went het niet.
Per terminal
Met CLAUDE_SOUND_PACK geef je elke terminal een eigen pakket. Handig als er meerdere sessies tegelijk lopen.
Geen herrie
Een wachttijd per moment voorkomt dat snelle bewerkingen achter elkaar een spervuur van geluid geven.
Breekt niets
Ontbreekt een bestand of klopt de instelling niet, dan blijft het stil. Claude Code merkt er niets van.
Installeren

Laat Claude het doen.

De instructie is geschreven voor Claude Code. Kopieer hem, plak hem in een sessie en Claude maakt de mappen, de instellingen, het script en de hooks aan. Daarna herstart je Claude Code.

Snelste weg

Kopieer en plak

Eén klik zet de hele instructie op je klembord. Plak hem in Claude Code en lees mee wat er gebeurt.

Zelf doen

Stap voor stap

Liever zelf? De instructie heeft acht stappen met alle bestanden erin. Alleen de hulpcommando's voor de terminal laat je Claude erbij schrijven.

Testen of het werkt

# Moet een geluid geven
echo '{"hook_event_name":"SessionStart"}' | node ~/.claude/sounds/claude-sounds.js

Let op: Claude Code vult geen ~ in bij hooks. Zet in settings.json het volledige pad naar het script, bijvoorbeeld /Users/jouwnaam/.claude/sounds/claude-sounds.js.

Eigen pakket

Je eigen geluiden in drie stappen.

Maak een map onder ~/.claude/sounds/packs/, zet je geluiden erin en beschrijf ze in pack.json. Een lijst geeft willekeurige varianten, een enkele naam altijd hetzelfde geluid. Momenten die je weglaat, blijven stil.

# ~/.claude/sounds/packs/mijn-pakket/pack.json
{
  "name": "Mijn pakket",
  "sounds": {
    "ready": ["hallo-1.mp3", "hallo-2.mp3"],
    "error": "oeps.mp3",
    "done":  ["klaar-1.wav", "klaar-2.wav"]
  }
}

Pakket kiezen

# Voor alle terminals: zet in soundpack.json
"activePack": "mijn-pakket"

# Alleen voor deze terminal
export CLAUDE_SOUND_PACK=mijn-pakket
claude

Houd geluiden kort, onder de drie seconden, en kies ze zo dat je zonder te kijken hoort wat er gebeurde. Wil je niet alleen een seintje maar ook horen wát er gebeurde? Dan is VOX de volgende stap: die leest het antwoord voor.

Aan de slag

Volgende keer hoor je het gewoon.

Kopieer de instructie, plak hem in Claude Code en herstart. Bij de volgende sessie hoor je Claude beginnen.

Meer open source