Erhalte auf dem Mac eine Benachrichtigung, wenn Claude Code fertig ist oder dich braucht.

Die integrierte Benachrichtigung von Claude Code wird ausgelöst, wenn Claude eine Aufgabe abschließt oder für eine Berechtigungsanfrage pausiert und du offenbar gerade nicht am Terminal bist. Ob diese Benachrichtigung als Banner erscheint, hängt von der Terminal-App ab.

Claude Code hat dafür eine Einstellung: preferredNotifChannel. Gib in Claude Code /config ein und öffne Local notifications. Der Standardwert ist auto. Die weiteren Optionen sind terminal_bell, iterm2, iterm2_with_bell, kitty, ghostty und notifications_disabled.

Die Terminal-Glocke ist ein kurzer Ton oder ein Aufblinken im Terminal, wenn ein Programm deine Aufmerksamkeit braucht. Um sie in Terminal.app, Warp oder VS Code zu nutzen, kannst du auch diese Zeile in eine Einstellungsdatei von Claude Code einfügen, etwa in ~/.claude/settings.json, innerhalb der äußeren geschweiften Klammern:

"preferredNotifChannel": "terminal_bell"

• iTerm2: Öffne Settings > Profiles > Terminal, aktiviere Notification Center Alerts, klicke auf Filter Alerts und schalte Send escape sequence-generated alerts ein.
• Terminal.app: Damit du die Terminal-Glocke leichter bemerkst, öffne Settings > Profiles > Advanced. Wähle unter Bell, dass das Dock-Symbol eine Markierung anzeigen oder hüpfen soll, wenn Terminal im Hintergrund ist. Wenn du beim ersten Start die Terminal-Einrichtung von Claude Code angenommen hast, wurde der hörbare Signalton von Terminal ausgeschaltet. Aktiviere dort Audible bell, wenn du ihn hören möchtest.
• In jedem Terminal: Die Terminal-App selbst braucht unter Systemeinstellungen > Mitteilungen die Erlaubnis, Mitteilungen anzuzeigen.

Ältere Beiträge empfehlen den Befehl claude config set. Diesen Befehl gibt es nicht mehr. Nutze /config oder bearbeite die Einstellungsdatei.

Ein Hook ist ein Shell-Befehl, den Claude Code zu einem festgelegten Zeitpunkt ausführt. Hooks trägst du in einer Einstellungsdatei ein. Sie funktionieren in jedem Terminal, weil das Terminal an ihrer Ausführung nicht beteiligt ist.

Anthropics eigene Anleitung zum Einrichten von Benachrichtigungen nutzt das Ereignis Notification. Dieses Ereignis meldet den Abschluss von Claude nur über idle_prompt, etwa 60 Sekunden später und nur, wenn du seitdem nichts eingegeben hast. Für eine Benachrichtigung genau dann, wenn Claude aufhört, nutze Stop.

Endet ein Antwortdurchgang mit einem API-Fehler, etwa wegen einer Ratenbegrenzung, wird StopFailure statt Stop ausgelöst. Notification-Hooks können nichts blockieren: Sie führen lediglich deinen Befehl aus.

Jeder der folgenden Codeabschnitte gehört in ~/.claude/settings.json. Diese Datei gilt für alle deine Projekte. Jeder Codeabschnitt wurde auf gültige JSON- und Shell-Syntax geprüft und benötigt keine zusätzliche Software.

Ein Mac-Banner, wenn Claude fertig ist.

In ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code\" sound name \"Glass\"' -e 'end run' \"Finished in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Ein Mac-Banner, wenn Claude dein OK braucht.

In ~/.claude/settings.json

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code needs you\" sound name \"Ping\"' -e 'end run' \"Waiting for your OK in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Beide Banner nennen den Ordner, in dem die Sitzung läuft.

Erlaube dem Skripteditor, die Banner anzuzeigen.

Auf dem Mac stammen Banner von osascript aus der integrierten App Skripteditor. Solange der Skripteditor keine Mitteilungen anzeigen darf, schlägt der Befehl ohne Fehlermeldung fehl. macOS fragt dich dabei nicht nach deiner Erlaubnis.

1. Führe diesen Befehl einmal in Terminal aus:

osascript -e 'display notification "test"'

2. Öffne Systemeinstellungen > Mitteilungen, suche den Skripteditor und schalte Mitteilungen erlauben ein.

Ein Ton statt eines Banners.

In ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" } ] }
    ]
  }
}

Eine gesprochene Benachrichtigung.

In ~/.claude/settings.json

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "say \"Claude has finished\"", "async": true } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "say \"Claude needs your permission\"", "async": true } ] }
    ]
  }
}

Mit "async": true kann Claude Code weiterarbeiten, während der Mac spricht.

Wenn du für ein Ereignis ein Banner und für das andere einen Ton möchtest, nutze den Generator für Benachrichtigungs-Hooks zweimal. Wähle jedes Mal ein Ereignis und die gewünschte Benachrichtigungsart. Füge anschließend beide Ergebnisse über das Feld zum Zusammenführen in deine Datei ein. Der Generator zeigt dir, in welche Datei der jeweilige Codeabschnitt gehört. Alles läuft in deinem Browser.

• Vertraue dem Ordner. Claude Code führt keinen Hook aus, auch nicht aus ~/.claude/settings.json, bis du im Vertrauensdialog für den Arbeitsbereich bestätigt hast, dass du diesem Ordner vertraust.
• Sieh nach, was geladen ist. Gib in Claude Code /hooks ein. Der Befehl listet deine Hooks und ihre jeweilige Quelldatei auf, kann aber keine Hooks hinzufügen. Normalerweise übernimmt Claude Code deine Änderungen von selbst. Falls nicht, starte die Sitzung neu.
• Firmen-Macs. Eine Organisation kann ausschließlich ihre eigenen zentral verwalteten Hooks zulassen. Dann zeigt /hooks die Meldung „Only hooks from managed settings run here“, und persönliche Hooks werden nicht ausgeführt.
• Zwei Benachrichtigungen gleichzeitig. Hooks aus allen Einstellungsebenen werden zusammen ausgeführt. Ein Benachrichtigungs-Hook in einer Projektdatei und ein anderer in deiner Benutzerdatei werden daher beide ausgelöst. Derselbe Hook in mehreren Dateien läuft nur einmal. Hooks laufen außerdem zusätzlich zur integrierten Benachrichtigung. Wenn du beides erhältst, stelle Local notifications auf notifications_disabled und behalte den Hook.
• Zu viele Benachrichtigungen. Stop wird nach jedem Antwortdurchgang ausgelöst, nicht erst, wenn eine ganze Aufgabe abgeschlossen ist.
• Wenn du auch Cowork Island nutzt. Halte jeden deiner Hooks in einem eigenen Eintrag, wie in den Codeabschnitten oben, und außerhalb von ~/.perch/. Die App behandelt nur Befehle, die /.perch/ enthalten, als ihre eigenen. Sie ersetzt ganze Einträge. Ein Befehl innerhalb eines ihrer Einträge würde deshalb zusammen mit diesem entfernt.

• Claude-Code-Dokumentation: Terminal-Konfiguration
• Claude-Code-Dokumentation: Hook-Referenz
• Claude-Code-Dokumentation: Anleitung zu Hooks
• Claude-Code-Dokumentation: Einstellungsreferenz
• Claude-Code-Dokumentation: Einstellungen
• Änderungsprotokoll von Claude Code
• Terminal-Benutzerhandbuch: Erweiterte Einstellungen
• Anleitung zur Mac-Automatisierung mit Skripten: Mitteilungen anzeigen
• Cowork Island FAQ und Installationsanleitung

Quellen geprüft am 18. Oktober 2026. Diese Anleitung stammt vom Entwickler von Cowork Island. Für Korrekturen schreib an support@coworkisland.com oder eröffne ein Issue auf GitHub.