Zum Inhalt springen
claudemods

Claude Code Benachrichtigungs-Mods: Toasts, Töne und Hinweise

Claude Code Benachrichtigungs-Mods melden per Toast, Ton oder Desktop-Hinweis, wenn ein langer Turn endet, ein Limit naht oder etwas scheitert.

Fertig-Toast in Claude Code

Fertig-Toast

Toast „Done in 2m 14s“ und kurzer Klang, wenn ein langer Claude-Turn endet, optional mit Desktop-Benachrichtigung.

  • Toast
  • Führt Befehle aus
  • Verändert die Oberfläche
  • Spielt Ton ab

getestet mit v2.1.291

Claude Code Benachrichtigungs-Mods sagen dir, dass etwas passiert ist, während du woanders hingeschaut hast: Ein langer Turn ist fertig, das Kontextfenster ist fast voll, ein Befehl wurde blockiert oder ein Testlauf ist fehlgeschlagen. Sie nutzen kurze Toasts innerhalb von Claude Code, optional einen Ton und manchmal eine Systembenachrichtigung, damit du es auch aus einem anderen Fenster mitbekommst.

Wie funktionieren Claude Code Benachrichtigungs-Mods?

Die meisten hören auf turn.complete. Dieses Event feuert, wenn Claude einen Turn beendet, und liefert die Dauer des Turns, ob er abgebrochen wurde, den Stop-Grund und bei Subagent-Turns eine agentId. Die Mod ruft dann $.ui.toast('...') für eine Meldung in der App und $.audio.play(...) für einen mitgelieferten Soundclip auf. Warnungen zu Limits stammen meist aus $.session.usage(), das nach einem Turn gelesen wird, und eine Sicherheits-Mod zeigt vielleicht direkt aus ihrem tool.call-Hook einen Toast, wenn sie einen Befehl ablehnt.

In der Mods-API gibt es keinen eigenen Aufruf für Desktop-Benachrichtigungen. Eine Mod, die das macOS-Benachrichtigungszentrum oder ein Linux-libnotify-Popup nutzen will, führt osascript oder notify-send mit $.process.run aus. Wer die Argumente als argv-Array statt als Shell-String übergibt, vermeidet Probleme mit Anführungszeichen im Antworttext von Claude.

Was solltest du vor der Installation prüfen?

Eine reine Toast-Mod sollte Verändert die Oberfläche und eventuell Spielt Ton ab zeigen. Siehst du zusätzlich Führt Befehle aus, prüfe, dass sie nur ein Benachrichtigungsprogramm aufruft und das nur, wenn du Systembenachrichtigungen eingeschaltet hast. Übernimmt eine Mod einen Teil von Claudes Antwort in die Benachrichtigung, bedenke, dass dieser Text danach im Benachrichtigungsverlauf deines Betriebssystems steht.

Sieh dir danach den Schwellenwert an. Eine gute Benachrichtigungs-Mod bleibt bei kurzen, unterbrochenen und Subagent-Turns still und lässt dich die Mindestdauer in /config ändern.

Toast, Ton oder Systembenachrichtigung?

Nimm einen Toast, wenn du ohnehin im Terminal bist. Ergänze einen Ton, wenn du während langer Turns in den Browser wechselst. Schalte Systembenachrichtigungen ein, wenn du über mehrere Desktops oder mit Vollbild-Apps arbeitest und das Terminal gar nicht sehen würdest. Die meisten Leute lassen nur die ersten beiden eingeschaltet.

FAQ

Gibt es eine API für Desktop-Benachrichtigungen in Claude Code Mods?
Nein. Die Mods-API bietet $.ui.toast für Toasts in der App und $.audio für Töne. Eine Mod, die eine Benachrichtigung unter macOS oder Linux auslöst, führt osascript oder notify-send über $.process.run aus, und deshalb zeigt sie das Badge „Führt Befehle aus“.
Wie lange bleibt ein Toast auf dem Bildschirm?
Standardmäßig etwa vier Sekunden. Toasts sind für kurze Fakten gedacht, etwa "Fertig in 2m 14s", nicht für etwas, das du zweimal lesen musst.
Löst eine Benachrichtigungs-Mod auch bei Subagent-Turns aus?
Nur wenn sie dafür geschrieben ist. Das Event turn.complete enthält bei Subagent-Turns eine agentId, und gute Benachrichtigungs-Mods überspringen diese, sodass du einen Hinweis pro Antwort hörst und nicht einen pro Subagent.