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.
- Platform
- macOS
- Nodig
- Node.js en Claude Code
- Werkt via
- Hooks van Claude Code
- Afhankelijkheden
- Geen externe pakketten
Claude meldt, het script speelt af.
- 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.
- 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.
- Je Mac speelt het afVia
afplay, op de achtergrond. Het script stopt meteen, dus Claude wacht nooit op het geluid.
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.
| Moment | Hook | Geluid |
|---|---|---|
| Sessie start | SessionStart | ready |
| Je stuurt een opdracht | UserPromptSubmit | acknowledge |
| Claude bewerkt een bestand | PostToolUse | work |
| Claude voert een commando uit | PostToolUse | command |
| Er gaat iets mis | PostToolUseFailure | error |
| Claude is klaar | Stop | done |
| Claude vraagt toestemming | Notification | alert |
| Claude wacht op jou | Notification | idle |
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.jsonis 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_PACKgeef 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.
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.
Kopieer en plak
Eén klik zet de hele instructie op je klembord. Plak hem in Claude Code en lees mee wat er gebeurt.
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.
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.
Volgende keer hoor je het gewoon.
Kopieer de instructie, plak hem in Claude Code en herstart. Bij de volgende sessie hoor je Claude beginnen.