Claude Code sendet eine Benachrichtigung, wenn eine Aufgabe beendet ist oder es bei einer Berechtigungsabfrage anhält, während Sie abwesend zu sein scheinen. Sie können dies als Desktop-Benachrichtigung, Terminal-Glockensignal oder über alles anzeigen lassen, was ein Notification-Hook ausführen kann. Welcher Weg der richtige ist, hängt von Ihrem Terminal und der Anzahl Ihrer gleichzeitigen Sitzungen ab.

1. Desktop-Benachrichtigungen
In Ghostty, Kitty und iTerm2 erscheinen die Benachrichtigungen von Claude Code ohne jede Konfiguration als Desktop-Benachrichtigungen.
Wenn sie in iTerm2 nicht angezeigt werden, öffnen Sie Settings > Profiles > Terminal, aktivieren Sie Notification Center Alerts und erlauben Sie unter Filter Alerts durch Escape-Sequenzen erzeugte Meldungen. Prüfen Sie außerdem in Ihren Systemeinstellungen, ob die Terminal-App die Berechtigung für Benachrichtigungen besitzt.
Diese Benachrichtigungen erreichen Sie auch aus einer Remote-Sitzung über SSH.
In der Claude-Desktop-App sendet der Code-Tab eine eigene Desktop-Benachrichtigung, wenn eine Sitzung eine Aufgabe beendet, während Sie sie nicht ansehen. Eine Sitzung, die Sie über Dispatch auf Ihrem Smartphone starten, sendet dorthin eine Push-Benachrichtigung, wenn sie beendet ist oder Ihre Bestätigung benötigt.
Wenn Ihr Terminal das Programmstatusprotokoll OSC 7501 implementiert, meldet Claude Code ab Version 2.1.295 zudem ohne weitere Konfiguration, ob jede interaktive Sitzung arbeitet, auf Sie wartet oder fertig ist. Die Dokumentation Ihres Terminals verrät, ob es das Protokoll unterstützt und wo es den Status anzeigt.
2. Das Terminal-Glockensignal
Andere Terminals wie Apple Terminal, Warp oder das VS-Code-Terminal erhalten keine Desktop-Benachrichtigung. Fordern Sie stattdessen ein Glockensignal an. Fügen Sie dies zu ~/.claude/settings.json hinzu:
{
"preferredNotifChannel": "terminal_bell"
}Wenn Sie tmux verwenden, fügen Sie set -g allow-passthrough on zu ~/.tmux.conf hinzu, damit die Benachrichtigung das äußere Terminal erreicht.
Wenn Ihre Sitzungen im Windows-Subsystem für Linux laufen, siehe Claude Code WSL notifications: get alerts on Windows für Einstellungen zur Windows-Terminal-Glocke und PowerShell-Hooks.
3. Ein Notification-Hook
Ein Hook führt Ihren eigenen Befehl aus, wenn Claude Sie braucht: ein Ton, ein Desktop-Banner, eine Nachricht an Ihr Smartphone. Er läuft parallel zur integrierten Benachrichtigung. Auf dem Mac spielt dies einen Ton ab:
{
"hooks": {
"Notification": [
{
"hooks": [
{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }
]
}
]
}
}Das Notification-Ereignis bietet Typen zum Filtern, darunter permission_prompt und idle_prompt, sodass Sie "Bestätigung erforderlich" anders behandeln können als "wartet auf Ihre nächste Nachricht". Ein separater Stop-Hook läuft, wenn Claude mit der Antwort fertig ist. Keiner der Typen deckt Claudes Multiple-Choice-Fragen ab. Siehe Know when Claude Code asks you a question or wants a plan approved für den passenden Hook.
Wenn Sie Hintergrund-Sitzungen ausführen, benachrichtigt Sie Agent View (claude agents, eine Research Preview) im geöffneten Zustand ebenfalls, wenn eine davon Eingaben benötigt, fertig ist oder fehlschlägt. Es löst den Notification-Hook mit dem Typ agent_needs_input oder agent_completed aus, sodass ein Hook-Skript auch darauf reagieren kann. Siehe Claude Code Agent View: Hintergrund-Sitzungen ausführen und überwachen zum Starten von Hintergrund-Sitzungen und Antworten darauf.
Wie sich Notification neben PreToolUse, PostToolUse, Stop und den weiteren Hook-Ereignissen einfügt, lesen Sie unter Claude Code hooks: events, matchers, settings and handlers.
Welcher Weg zu wählen ist
| You run | Use |
|---|---|
| Eine Sitzung, Ghostty, Kitty oder iTerm2 | Integrierte Desktop-Benachrichtigungen |
| Eine Sitzung, ein anderes Terminal | terminal_bell |
| Sie möchten einen Ton oder eine eigene Aktion | Ein Notification-Hook |
| Mehrere Sitzungen gleichzeitig | Ein Display, das anzeigt, welche Sitzung wartet |
Wenn Benachrichtigungen nicht mehr ausreichen
Eine Benachrichtigung besagt, dass eine Sitzung Sie braucht. Bei vier geöffneten Sitzungen müssen Sie immer noch suchen, welche es ist, und sobald das Banner weggeklickt ist, ist es fort.
Einen umfassenderen Vergleich von tmux, Hooks, Agent View, IDE-Panels und Status-Pads finden Sie unter How to monitor multiple Claude Code sessions.
Orbtile zeigt jede Sitzung als eigene Kachel auf einem iPhone oder Android-Smartphone oder dem Logitech MX Creative Keypad an. Eine wartende Sitzung leuchtet in der Alarmfarbe ihres Agenten auf und rückt nach vorne, die Kachel zeigt die Anfrage, und Sie können unterstützte Aktionen direkt über das Pad beantworten: Ablehnen per Antippen, Erlauben durch 0,6 Sekunden langes Gedrückthalten. Es nutzt die Hooks von Claude Code über ein eigenes Plugin, sodass Ihre Benachrichtigungen wie bisher weiter funktionieren.
Wenn Sie auch Kimi Code ausführen, siehe Kimi Code notifications: hooks, NotifyUser and TUI settings zur Funktionsweise dessen Hooks und Status-Updates.
FAQ
Why don't I get notifications in the VS Code terminal?
Es empfängt die Desktop-Benachrichtigung von Claude Code nicht. Setzen Sie preferredNotifChannel auf terminal_bell oder fügen Sie einen Notification-Hook hinzu.
Can I get notified only for permission prompts?
Ja. Vergeben Sie für den Notification-Hook einen Matcher von permission_prompt.
Does Orbtile change my Claude Code settings?
Es installiert sein Plugin über die eigene Befehlszeile von Claude Code. Schlägt dies fehl, bearbeitet es ~/.claude/settings.json und legt zuvor ein datiertes Backup an. Das Entfernen des Plugins in den Orbtile-Einstellungen hebt die Registrierung wieder auf.