MacPipDeine nächste Mac-App wartet hier.macpip.com →

So merkst du, wann Claude Code oder Codex fertig ist

Aktualisiert am 22. Oktober 2026

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 afplay für einen Sound oder osascript für eine Mitteilung ausführen.
  • Codex: Füg eine notify-Zeile in ~/.codex/config.toml ein 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

Claude Code oder Codexfertig oder braucht dich
Hook / notifyführt deinen Befehl aus
Du hörst esSound · Banner · Glocke
Jeder Weg auf dieser Seite funktioniert gleich: Der Agent führt im richtigen Moment einen Befehl aus.

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:

  1. iTerm2 → Settings → Profiles → Terminal.
  2. Notification Center Alerts anhaken.
  3. 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.

Quelle: Claude-Code-Doku: Terminal-Einrichtung

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.

Quelle: Codex-Doku: erweiterte Konfiguration

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.json legt alle Hooks lahm. Kopier sie in einen beliebigen JSON-Checker.
  • Teste den Befehl allein. Führ afplay /System/Library/Sounds/Glass.aiff im 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.json und einen weiteren in der .claude/settings.json des 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.

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.