So merkst du, wann Claude Code oder Codex fertig ist

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.

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

Clackys Agent Alerts: dasselbe, ohne Config

Wenn du lieber kein JSON und TOML bearbeitest: Clacky (eine Menüleisten-App für den Mac) hat Agent Alerts (Agent-Meldungen). Es nutzt dieselben Hooks wie oben, also beobachtet nichts deinen Bildschirm oder liest dein Terminal:

1. Öffne Clackys Dashboard → Agent Alerts.
2. Klick neben Claude Code oder Codex auf Set Up…. Clacky zeigt dir genau die Zeilen, die es hinzufügt; klick auf Add Hooks. Eine Sicherung deiner Datei landet direkt daneben (settings.json.clacky-backup).
3. Klick auf Send a Test Alert, um beide Sounds zu hören.

Das bekommst du:

• Einen eigenen Sound für fertig (ein aufsteigender Akkord) und braucht dich (zwei Taps und eine Frage), mit fünf Stimmen zur Auswahl pro Agent.
• Auf Wunsch ein sanftes Leuchten am Bildschirmrand für etwa eine Sekunde. Es lässt Klicks durch und taucht nie in Aufnahmen auf.
• Quiet when it’s in front (still, solange das Terminal des Agents die aktive App ist) und Quiet during calls (still, solange das Mikrofon benutzt wird), beide standardmäßig an.
• Einen Punkt pro Session in der Menüleiste: arbeitet, wartet oder fertig. Ein Klick darauf holt das passende Terminal nach vorn.
• Keep Awake → Until My Agent Is Done, damit ein langer Lauf nicht abbricht, weil dein Mac eingeschlafen ist.

Claude Code funktioniert in jedem Terminal und im Code-Tab der Claude-App. Codex funktioniert mit der CLI und bekommt den fertig-Sound (Codex sendet kein „braucht dich“-Event). Hat deine Codex-Config schon eine notify-Zeile, lässt Clacky sie in Ruhe und sagt dir Bescheid, statt sie zu ersetzen. Remove… entfernt nur Clackys Zeilen.

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 deinen eigenen Hook und Clackys). Behalte eins.