So merkst du, wann Claude Code oder Codex fertig ist
Du startest eine lange Aufgabe in Claude Code oder Codex, machst etwas anderes und kommst zehn Minuten später zurück, nur um zu sehen: Nach zwei Minuten hat es angehalten und wartet auf ein Ja. Ein Sound oder eine Mitteilung, wenn der Agent fertig ist oder dein OK braucht, löst das.
Beide Tools können das kostenlos, eingebaut oder mit ein, zwei Zeilen Config. Diese Anleitung zeigt jeden Weg Schritt für Schritt.
Kurz gesagt
- Claude Code kann dich in Ghostty, Kitty und iTerm2 schon von selbst benachrichtigen (iTerm2 braucht eine Einstellung). In anderen Terminals fügst du einen Hook hinzu.
- Ein Claude-Code-Hook auf Stop feuert, wenn es fertig ist; einer auf Notification, wenn es dich braucht. Lass ihn
afplayfür einen Sound oderosascriptfür eine Mitteilung ausführen. - Codex: Füg eine
notify-Zeile in~/.codex/config.tomlein oder schalte die eingebauten Terminal-Mitteilungen ein. - Es passiert nichts? Starte die Session neu: Hooks werden beim Start einer Session gelesen.
Wie Agents dir sagen, dass sie fertig sind
Beide Tools können im richtigen Moment einen Befehl von dir ausführen. Mehr ist eine Benachrichtigung nicht: Claude Code nennt das Hook, Codex nennt es notify. Was der Befehl tut (einen Sound spielen, ein Banner zeigen, den Bildschirm aufblitzen lassen), passiert, wenn der Agent anhält oder nach einer Eingabe fragt.
Ein schönerer Mac, während dein Agent arbeitet
Clacky macht den Mac selbst schöner, während Agents arbeiten: Klick- und Tastatursounds und ein Bildschirmrecorder, wenn du zeigen willst, was der Agent gebaut hat. Einmalig $4.99 für 1 Mac.
Claude Code: die eingebaute Mitteilung
Wenn Claude Code fertig ist oder auf eine Berechtigungsfrage wartet, kann es von selbst eine Mitteilung auf dem Desktop senden. Laut Anthropics Doku klappt das in Ghostty und Kitty ohne Einrichtung. In iTerm2 schaltest du es einmal ein:
- iTerm2 → Settings → Profiles → Terminal.
- Notification Center Alerts anhaken.
- Auf Filter Alerts klicken und Send escape sequence-generated alerts aktivieren.
Läuft Claude Code in tmux? Dann füg set -g allow-passthrough on in ~/.tmux.conf ein, sonst kommt die Mitteilung nie bei deinem Terminal an. Wie Claude Code dich benachrichtigt (zum Beispiel mit der Terminal-Glocke), kannst du auch in seinen /config-Einstellungen wählen.
Claude Code: ein Hook, der einen Sound spielt
Im Terminal von Apple, in VS Code oder jedem anderen Terminal erledigt das ein Hook. Hooks stehen in ~/.claude/settings.json (für alle Projekte) oder .claude/settings.json (für ein Projekt). Zwei Events zählen:
- Stop: Claude hat seine Antwort fertig.
- Notification: Claude braucht dich (eine Berechtigungsfrage, oder es wartet schon eine Weile auf deine Eingabe).
Das hier spielt für beide einen macOS-Sound. Füg es in deine Einstellungsdatei ein (was schon drinsteht, bleibt):
{
"hooks": {
"Stop": [{ "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }] }],
"Notification": [{ "matcher": "", "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" }] }]
}
}Lieber ein Banner? Dann nimm stattdessen diesen Befehl (derselbe wie in Anthropics Beispiel):
osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'Tipp /hooks in Claude Code, um zu sehen, was eingerichtet ist. Neue Hooks gelten für Sessions, die du nach dem Speichern startest. Die Sounds in /System/Library/Sounds/ darfst du frei nutzen: Glass, Ping, Pop, Purr, Submarine und mehr.
Quellen: Hooks-Referenz · Hooks-Anleitung
Codex: die notify-Einstellung
Die Codex CLI führt nach jedem Durchgang ein Programm von dir aus, festgelegt mit notify in ~/.codex/config.toml. Codex hängt eine JSON-Beschreibung des Durchgangs als letztes Argument an (ihr type ist agent-turn-complete), die ein einfacher Sound-Befehl ignorieren kann:
notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]notify ist ein Schlüssel auf oberster Ebene: Schreib ihn über jede [section] in der Datei. Codex hat außerdem eingebaute Mitteilungen in seiner Terminal-Oberfläche (notifications unter [tui]), die die Mitteilung oder Glocke des Terminals nutzen; ob du ein Banner siehst, hängt von deinem Terminal ab.
Codex’ notify feuert, wenn ein Durchgang abgeschlossen ist. Ein eigenes Event für „braucht deine Freigabe“, wie den Notification-Hook von Claude Code, gibt es nicht.
Wenn nichts passiert
- Starte die Session neu. Hooks werden beim Start einer Session gelesen, eine schon laufende Session meldet sich also nicht.
- Prüf, ob die Datei gültig ist. Ein fehlendes Komma in
settings.jsonlegt alle Hooks lahm. Kopier sie in einen beliebigen JSON-Checker. - Teste den Befehl allein. Führ
afplay /System/Library/Sounds/Glass.aiffim Terminal aus. Kein Sound? Prüf dein Ausgabegerät und die Lautstärke. - Keine Banner? Schau in Systemeinstellungen → Mitteilungen nach deinem Terminal (oder dem Skripteditor, für
osascript) und nach deinen Fokus-Modi. - Zwei Sounds auf einmal? Du hast zwei Setups (etwa einen Hook in
~/.claude/settings.jsonund einen weiteren in der.claude/settings.jsondes Projekts). Behalte eins.
Fragen
Hat Claude Code einen eingebauten Benachrichtigungston?
Es kann in Ghostty, Kitty und iTerm2 von selbst eine Mitteilung auf dem Desktop senden (in iTerm2 muss Send escape sequence-generated alerts an sein). Für einen Sound in jedem Terminal fügst du einen Stop- oder Notification-Hook hinzu, der afplay ausführt.
Was ist der Unterschied zwischen dem Stop- und dem Notification-Hook?
Stop läuft, wenn Claude mit der Antwort fertig ist. Notification läuft, wenn Claude dich braucht: eine Berechtigungsfrage, oder es wartet schon eine Weile auf deine Eingabe. Die meisten wollen beide, mit unterschiedlichen Sounds.
Kann Codex mir sagen, wenn es eine Freigabe braucht?
Das notify-Programm von Codex läuft, wenn ein Durchgang abgeschlossen ist (agent-turn-complete). Ein eigenes Freigabe-Event gibt es dafür derzeit nicht, du hörst es also am Ende des Durchgangs.
Funktionieren diese Meldungen mit Claude Code im Web (claude.ai/code in Chrome)?
Heute nicht. Claude Code im Web läuft in der Cloud von Anthropic, deshalb laufen auch seine Hooks dort und erreichen deinen Mac nie. Ein afplay- oder osascript-Hook hört nur Sitzungen, die auf deinem Mac laufen: im Terminal oder im Code-Tab der Claude-App. Für Hinweise zu einer Web-Sitzung setze sie mit claude --teleport im Terminal auf deinem Mac fort.
Weitere Anleitungen
- Mac wach halten, Deckel zuClamshell-Modus, caffeinate, pmset und Apps, und was jedes davon wirklich tut.
- Tastatur- & Klick-Sounds auf dem MacWie sie funktionieren, welche Berechtigung sie brauchen, die Apps und Lösungen.
- Mausklicks auf dem Mac zeigenDie eingebaute Option, Editoren und ein Live-Klickkreis mit Sound.
- Klick-Sound auf dem MacKeine eingebaute Einstellung: so geht es, und welche Berechtigung es braucht.
- Beste Tastatursound-Apps17 kostenlose und bezahlte Apps im Vergleich, und welche zu dir passt.
- Tastatursounds zum FokussierenWeiche Tippgeräusche zum Lernen, Schreiben und Coden, in deinen Kopfhörern.
- Tastatursounds erklärtWas Thock, cremig, klackig und poppig heißen und wie jedes klingt.
- Gemütliche Mac-AppsIdle-Spiele, Umgebungsgeräusche, Haustiere und weiche Klicks, die beim Arbeiten laufen.
- Beste Cursor-Highlighter-AppsSpotlights, Klickwellen und Klick-Sounds für Demos, Anrufe und Aufnahmen.
- Tastatursounds funktionieren nichtEingabeüberwachung, Secure Input, das Ausgabegerät und Ruhe-Einstellungen.
- Teleprompter auf dem MacLies dein Skript unter der Kamera, und halt es aus der Aufnahme raus.
- Klicks zeigen und Klick-Sounds aufnehmenDie Klick-Welle und den Klick-Sound in jede Bildschirmaufnahme auf dem Mac bringen.
- Tipptest mit TastatursoundsEin 30-Sekunden-Tipptest, den du hörst, direkt im Browser.
Neu bei Clacky? Eine gemütliche Menüleisten-App für den Mac mit Klick- und Tastatursounds, Bildschirmrecorder, Screenshots und einer kleinen Hafenstadt, die wächst, während du arbeitest. Alle Tools ansehen · Hör die Sounds in deinem Browser
Geprüft am 22. Oktober 2026. Hat sich etwas geändert, oder stimmt hier etwas nicht? Schreib an hello@clacky.app.