Claude Code Benachrichtigung bei Fertigstellung: Toast und Klang

Fertig-Toast liefert dir eine Claude Code Benachrichtigung bei Fertigstellung: Sobald ein Turn endet, der eine Weile gedauert hat, meldet ein Toast Done in 2m 14s, und ein kurzer Zwei-Ton-Klang ertönt. Endet ein Turn mit einem Fehler, heißt es stattdessen Stopped on an error after 2m 14s. Kurze Turns, abgebrochene Turns und Subagent-Turns bleiben still, sodass der Klang immer bedeutet: „Komm zurück, deine Antwort ist fertig.“

Wenn du bei langen Aufgaben in einem anderen Fenster arbeitest, schalte die Option für Systembenachrichtigungen ein: Dann erscheint dieselbe Meldung in der macOS-Mitteilungszentrale oder als notify-send-Popup unter Linux. Benötigt Claude Code 2.1.287 oder neuer.

In der Aufnahme bekommt Claude eine Aufgabe, die länger dauert als der Schwellenwert. Wenn der Turn abgeschlossen ist, erscheint unten auf dem Bildschirm der Toast mit der Dauer des Turns.

Wähle eine der Methoden im Installationsblock. Der Ton funktioniert unter macOS ohne weitere Einrichtung; Systembenachrichtigungen musst du ausdrücklich einschalten.

Die Mod hat einen einzigen Hook. Aus hooks/register.ts:

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (!shouldNotify(e, minSeconds)) return result

  const text = toastText(e, includeAnswerPreview)
  $.ui.toast(text)

  if (sound) {
    $.audio.play({ asset: 'sounds/done.wav' }).catch(() => undefined)
  }

  if (systemNotification) {
    platform ??= $.process
      .run(['uname', '-s'], { timeoutMs: 5000 })
      .then(ran => (ran.exitCode === 0 ? parseUname(ran.stdout) : undefined))
      .catch(() => undefined)
    platform
      .then(found =>
        found === undefined ? undefined : $.process.run(notificationArgv(found, 'Claude Code', text), { timeoutMs: 10000 }),
      )
      .catch(() => undefined)
  }

  return result
})

turn.complete wird ausgelöst, wenn Claude einen Turn beendet. Der Hook wartet zuerst auf next(e) und verzögert das Ergebnis des Turns daher nie. shouldNotify in hooks/format.ts gibt false zurück für Subagent-Turns (solche mit einer agentId), abgebrochene Turns und alles, was kürzer als minSeconds ist. toastText formatiert die Dauer als 45s, 2m 14s oder 1h 3m.

Der Klang ist sounds/done.wav, liegt der Mod bei und wird mit $.audio.play abgespielt. Die Mods-API hat weder ein Plattformfeld noch einen Benachrichtigungsaufruf. Sind Systembenachrichtigungen eingeschaltet, fragt die Mod deshalb einmal uname -s ab und speichert die Antwort zwischen. Anschließend führt sie unter macOS osascript -e 'display notification …' oder unter Linux notify-send aus. Die Argumente werden als argv-Array ohne Shell übergeben, sodass Anführungszeichen in Claudes Antwort nicht ausbrechen können. Ton und Benachrichtigung laufen nach dem Prinzip „abschicken und vergessen“; Fehler werden verschluckt.

Diese Optionen änderst du in /config. Für einen eigenen Ton ersetzt du sounds/done.wav im Mod-Ordner oder änderst den asset-Pfad im Hook. Der Wortlaut des Toasts stammt aus toastText in hooks/format.ts, und der Titel der Benachrichtigung 'Claude Code' ist das zweite Argument von notificationArgv.

Verändert die Oberfläche betrifft den Toast. Spielt Ton ab betrifft den Klang. Führt Befehle aus erscheint, weil $.process.run im Code vorkommt. Genutzt wird es aber nur, wenn du systemNotification einschaltest: Dann läuft einmal uname -s, gefolgt von osascript oder notify-send mit festen Argumenten. Mit den Standardeinstellungen wird kein Prozess gestartet.

Die Mod fängt keine Tool-Aufrufe ab, liest deine Prompts nicht, rührt keine Dateien an und nutzt kein Netzwerk. Deaktiviere sie mit /plugin disable cm-done-toast oder starte eine Sitzung ganz ohne Mods mit claude --safe-mode.

Getestet mit Claude Code 2.1.291 unter macOS im Terminal. Wenn beim Ende eines Turns nichts passiert:

• Prüfe, ob claude --version 2.1.287 oder neuer meldet und die Mod in /plugin aktiviert ist.
• Führe nach einer Installation über die Shell /reload-plugins aus.
• Der Turn war möglicherweise kürzer als minSeconds.
• Dass es außerhalb von macOS keinen Ton gibt, ist erwartetes Verhalten.
• Erscheint die Systembenachrichtigung unter macOS nie, erlaube in den Systemeinstellungen Mitteilungen für deine Terminal-App.
• Installiere unter Linux libnotify (notify-send) für Systembenachrichtigungen.