Richte deine Benachrichtigung für Claude Code, Codex und Gemini CLI mit dem Generator ein.
Ein Hook ist ein kurzer Befehl, den dein KI-Agent zu einem festgelegten Zeitpunkt ausführt, etwa wenn er eine Antwort fertiggestellt hat. Dieses kostenlose Tool schreibt den Hook oder die integrierte Einstellung für deine Benachrichtigung.
Wähle deinen Agenten, die gewünschten Ereignisse (er ist fertig oder braucht dein OK) und wie du davon erfahren möchtest. Diese Seite erstellt den genauen Codeabschnitt, nennt die zugehörige Datei und kann ihn in eine Kopie dieser Datei einfügen. Für Claude Code werden Stop- und Notification-Hooks erstellt, für Codex und Gemini CLI die jeweils eigenen Hooks. Keine deiner Eingaben verlässt deinen Browser.
Cowork Island
macOS 14 oder neuer.
Apple-Chip und Intel.
Für den kostenlosen Plan ist kein Konto nötig.
Wähle deine Benachrichtigung.
Für die Auswahl unten brauchst du JavaScript. Ohne JavaScript zeigt diese Seite die gängigste Konfiguration: ein Mac-Banner von Claude Code, wenn es fertig ist oder dich braucht.
Deine Konfiguration.
Wähle mindestens ein Ereignis: wenn der Agent fertig ist oder wenn er dich braucht.
Für ein Mac-Banner brauchst du möglicherweise keinen Hook. Für eine Handy-Benachrichtigung, eine gesprochene Meldung oder eine Benachrichtigung nur per Ton nutze den unten erstellten Hook. In iTerm2, Ghostty und Kitty zeigt Claude Code bereits eine Desktop-Benachrichtigung, wenn es fertig ist oder dich braucht und du offenbar gerade nicht im Terminal arbeitest. Öffne in iTerm2 außerdem Settings > Profiles > Terminal, aktiviere Notification Center Alerts, klicke auf Filter Alerts und schalte Send escape sequence-generated alerts ein. Hooks laufen zusätzlich zu dieser integrierten Benachrichtigung. Wenn du beides nutzt, erhältst du daher möglicherweise zwei Benachrichtigungen.
Für ein Mac-Banner brauchst du möglicherweise keinen Hook. Für eine Handy-Benachrichtigung, eine gesprochene Meldung oder eine Benachrichtigung nur per Ton nutze den unten erstellten Hook. Die eigenen Terminal-Benachrichtigungen von Codex sind standardmäßig eingeschaltet. Laut Codex-Dokumentation verwenden sie eine Escape-Sequenz, die manche Terminal-Apps als Desktop-Benachrichtigung anzeigen. Möglicherweise erscheinen sie also bereits in deiner Terminal-App. Um sie auf die gewählten Ereignisse zu beschränken, verwende die Zeilen unter [tui] unten. Diese Einstellungen steuern Benachrichtigungen auf deinem Mac. Sie ersetzen keinen Hook für Handy-Benachrichtigungen.
Für ein Mac-Banner brauchst du möglicherweise keinen Hook. Für eine Handy-Benachrichtigung, eine gesprochene Meldung oder eine Benachrichtigung nur per Ton nutze den unten erstellten Hook. Die integrierten Benachrichtigungen von Gemini CLI erscheinen in iTerm2, WezTerm, Ghostty und Kitty als Desktop-Benachrichtigungen. Sie sind experimentell und standardmäßig ausgeschaltet. Schalte sie in Gemini CLI unter /settings > General > Enable Notifications ein. Nutze entweder diese Funktion oder die Hooks unten. Wenn du beides nutzt, erhältst du zwei Benachrichtigungen.
Die integrierten Benachrichtigungen von Codex mit Terminalglocke.
Optional: die integrierten Mac-Benachrichtigungen von Codex.
In ~/.codex/config.toml
Wenn die Datei bereits einen Abschnitt [tui] enthält, füge die Zeile [tui] nicht erneut hinzu. Ändere unter der vorhandenen Zeile die Werte der hier aufgeführten Schlüssel, die bereits enthalten sind. Ergänze nur die fehlenden Schlüssel. Eine zweite Abschnittsüberschrift [tui] oder ein doppelt eingetragener Schlüssel verhindert, dass Codex die Datei lesen kann.
Was die Terminalglocke bewirkt, hängt von deiner Terminal-App ab. Öffne in Terminal Settings > Profiles > Advanced > Bell, um einen Ton, eine Markierung am Symbol oder ein hüpfendes Dock-Symbol auszuwählen.
Hooks für deine gewählte Benachrichtigung.
In ~/.claude/settings.json~/.codex/hooks.json~/.gemini/settings.json
Füge diese Einträge im Objekt "hooks" der Datei neben den vorhandenen Einträgen hinzu. Ersetze die Datei nicht: Sie kann weitere Einstellungen und Hooks anderer Tools enthalten. Einstellungsdateien müssen strikt dem JSON-Format entsprechen, also ohne Kommentare und ohne Kommas nach dem letzten Eintrag. Einfacher geht es, wenn du deine aktuelle Datei unten in das Feld zum Zusammenführen einfügst.
Füge sie als neue Einträge in die Datei ein. Auch Cowork Island und andere Tools können in dieselbe Datei schreiben. Überschreibe sie daher nie. Das Feld zum Zusammenführen unten übernimmt das Ergänzen für dich. Öffne danach Codex, gib /hooks ein und bestätige jeden neuen Eintrag als vertrauenswürdig. Bis dahin überspringt Codex neue oder geänderte Hooks.
Füge diese Einträge im Objekt "hooks" der Datei neben den vorhandenen Einträgen hinzu oder nutze das Feld zum Zusammenführen unten. Hooks von Gemini CLI dürfen nur JSON ausgeben. Deshalb gibt jeder Befehl zum Abschluss {} aus.
Füge diese Einstellung neben den vorhandenen Einträgen in die Datei ein oder nutze das Feld zum Zusammenführen unten.
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Glass\"' -e 'end run' 'Claude Code finished' 'Claude Code' \"${PWD##*/}\""
}
]
}
],
"Notification": [
{
"matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
"hooks": [
{
"type": "command",
"command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Funk\"' -e 'end run' 'Claude Code needs you' 'Claude Code' \"${PWD##*/}\""
}
]
}
]
}
}
- Bei Claude Code erscheinen Benachrichtigungen zu Berechtigungsanfragen und Eingabeaufforderungen verbundener Tools etwa 6 Sekunden nach der Aufforderung. Wenn du tippst, werden sie weiter verzögert. So funktioniert der Notification-Hook von Claude Code. Andere Fragen lösen diesen Hook möglicherweise nicht aus.
- Die Benachrichtigung bei Abschluss verwendet Stop. Dieses Ereignis wird jedes Mal ausgelöst, wenn Claude eine Antwort fertigstellt, nicht nur am Ende einer längeren Aufgabe. Wenn du Claude unterbrichst, wird es nicht ausgelöst.
- Claude Code führt Hooks in einem Ordner erst aus, nachdem du im Vertrauensdialog für den Arbeitsbereich zugestimmt hast. Auf einem Arbeits-Mac erlaubt deine Organisation möglicherweise nur ihre eigenen Hooks.
- Hier wird die integrierte Einstellung von Claude Code verwendet, kein Hook. Sie deckt beide Ereignisse ab: eine abgeschlossene Aufgabe und eine wartende Berechtigungsanfrage. Du kannst sie auch in Claude Code unter
/config> Local notifications einstellen. Was die Terminalglocke bewirkt, hängt von deiner Terminal-App ab. Öffne in Terminal Settings > Profiles > Advanced > Bell. - Damit werden die experimentellen, integrierten Benachrichtigungen von Gemini CLI eingeschaltet und die Terminalglocke angefordert. Sie decken beide Ereignisse ab: Eine Aktion ist erforderlich oder die Sitzung ist abgeschlossen.
- Der Eintrag PermissionRequest läuft im Hintergrund und trifft keine Entscheidung. Codex zeigt weiterhin seine normale Genehmigungsanfrage.
- Nutze entweder diese Hooks oder die integrierten Benachrichtigungen von Gemini CLI (Enable Notifications unter
/settings). Wenn du beides nutzt, erhältst du zwei Benachrichtigungen. - Laut Dokumentation von Gemini CLI wurden Nutzer des kostenlosen Tarifs und von Google One am 18. Juni 2026 auf Antigravity CLI umgestellt. Diese Einstellungen gelten für Gemini CLI.
- Wenn eine bereits geöffnete Sitzung die Änderung nicht übernimmt, starte sie neu.
Optional: stattdessen ein Banner über die Einstellung notify von Codex.
Die Einstellung notify von Codex führt nach jeder abgeschlossenen Dialogrunde ein Programm aus. Bei Genehmigungsanfragen wird es nie ausgeführt. Wenn du diese Einstellung nutzt, lass den Stop-Eintrag oben weg. Sonst erhältst du zwei Banner für dieselbe Antwort.
1. Speichere dies als ~/.codex/notify-macos.js
Codex löst ~ in dieser Einstellung nicht auf. Deshalb muss der Pfad vollständig sein. In Terminal zeigt dir echo $HOME diesen Pfad.
2. Füge diese Zeile in ~/.codex/config.toml ein
Gib oben deinen Benutzernamen ein. Bis dahin steht in der Zeile YOUR_NAME.
- Pro Datei ist nur eine Zeile mit
notifyerlaubt. Wenn deine Datei bereits eine enthält, füge keine zweite hinzu: Die Datei ließe sich dann nicht mehr laden. Nutze stattdessen den Stop-Hook oben. - Setze die Zeile weit oben ein, vor der ersten Zeile, die mit
[beginnt. Unter einer Abschnittsüberschrift wie[tui]liest Codex sie als Teil dieses Abschnitts und ignoriert sie. - Cowork Island verwendet
notifynie. Diese Zeile und die App kommen sich daher nicht in die Quere.
Teste es in Terminal:
Dein ntfy-Thema mit zufälligem Namen.
Themen auf ntfy.sh sind öffentlich. Wer den Namen eines Themas kennt oder errät, kann die dorthin gesendeten Nachrichten lesen. Behandle ihn deshalb wie ein Passwort. Daher besteht dieser Themenname aus 32 zufälligen Zeichen, die dein Browser erzeugt. Deshalb sendet der Hook auch nur eine feste Meldung wie „Claude Code ist fertig“, niemals die Antwort des Agenten oder den Inhalt deiner Dateien.
Installiere die ntfy-App auf deinem Handy und abonniere dieses Thema. ntfy.sh ist ein kostenloser Dienst eines Drittanbieters mit eigenen täglichen Nachrichtenlimits.
Teste es.
Füge diese Zeile in Terminal ein und drücke die Eingabetaste. Sie führt denselben Befehl aus wie später der Hook und sendet damit eine Testnachricht an dein Thema.
/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name "Glass"' -e 'end run' 'Claude Code finished' 'Claude Code' "${PWD##*/}"
Teste die Terminalglocke.
Füge diese Zeile in Terminal ein und drücke die Eingabetaste:
printf '\a'
Erlaube dem Skripteditor, Mitteilungen anzuzeigen. Diese Banner kommen von der macOS-App Skripteditor. macOS fragt vorher nicht nach deiner Erlaubnis. Solange du sie nicht erteilst, erscheint nichts, und du erfährst auch nicht, warum. Führe die Testzeile einmal aus. Öffne dann Systemeinstellungen > Mitteilungen, suche den Skripteditor und schalte „Mitteilungen erlauben“ ein.
Führe die Einträge mit deiner aktuellen Datei zusammen.
Füge hier deine gesamte aktuelle Datei ein. Diese Seite ergänzt die neuen Einträge. Bereits vorhandene Hook-Einträge bleiben unverändert, auch die anderer Tools und von Cowork Island. Wenn du eine integrierte Einstellung gewählt hast, ersetzt ihr neuer Wert den bisherigen. Die Seite zeigt dir, welche Einstellung geändert wurde. Wenn du dieselbe Auswahl zweimal zusammenführst, wird nichts doppelt hinzugefügt. Was du einfügst, bleibt auf dieser Seite.
Zum Zusammenführen brauchst du JavaScript. Ohne JavaScript fügst du die Einträge wie oben beschrieben von Hand hinzu.
Bei dieser Auswahl gibt es nichts zusammenzuführen: Die Einstellung gehört wie oben gezeigt in ~/.codex/config.toml.
Öffne die Datei in einem Texteditor, wähle den gesamten Inhalt aus, kopiere ihn und füge ihn hier ein. Wenn die Datei noch nicht existiert, lass das Feld leer.
Wenn du auch Cowork Island nutzt.
Cowork Island ist die Mac-App vom Entwickler dieses Tools. Wenn sie sich mit Claude Code, Codex oder Gemini CLI verbindet, fügt sie eigene Einträge in dieselben Dateien ein. Diese Einträge stehen neben deinen vorhandenen Hooks. Die App betrachtet einen Eintrag als ihren eigenen, wenn sein Befehl an irgendeiner Stelle /.perch/ enthält, unabhängig von der Groß- und Kleinschreibung. Sie entfernt und ergänzt dabei ganze Einträge, keine einzelnen Befehle.
- Jeder hier erstellte Codeabschnitt ist ein eigener Eintrag und verweist nie auf einen Pfad innerhalb von
~/.perch/. Wenn du Cowork Island neu installierst oder ausschaltest, bleibt er daher unverändert. - Füge keinen dieser Befehle in einen Eintrag von Cowork Island ein und speichere deine eigenen Skripte nicht in
~/.perch/: Die App würde sie als ihre eigenen behandeln. - Lösche die Einträge von Cowork Island nicht von Hand, solange die Integration eingeschaltet ist. Die App fügt sie beim nächsten Start wieder hinzu.
- Beide laufen nebeneinander. Claude Code und Codex führen alle passenden Hooks gleichzeitig aus, und Gemini CLI wartet auf alle.
- Bei Claude Code verwendet die Benachrichtigung über eine Berechtigungsanfrage das Ereignis Notification, niemals einen PermissionRequest-Hook. Sie kann daher nie eine Anfrage für dich beantworten.
- Für Gemini CLI erstellt dieses Tool AfterAgent- und Notification-Hooks, niemals BeforeTool-Hooks.
Was diese Seite mit deinen Eingaben macht.
Alles geschieht in deinem Browser. Der Generator stellt keine Netzwerkanfragen, speichert nichts und setzt keine Cookies. Nichts, was du auswählst, eingibst oder einfügst, verlässt diese Seite. „Kopieren“ schreibt erst dann in deine Zwischenablage, wenn du darauf klickst. Das ntfy-Thema wird mit dem integrierten Zufallszahlengenerator deines Browsers erstellt. Wie auf jeder Seite dieser Website wird der Besuch selbst gezählt, wie in der Datenschutzerklärung (auf Englisch) beschrieben.
Die Option ohne Einrichtung.
Cowork Island ist eine Mac-App vom Entwickler dieses Tools. Sie bündelt deine KI-Agenten-Sitzungen in einem Panel unter der Notch und zeigt den Status jeder einzelnen. So siehst du auf einen Blick, welche dich braucht. Sie funktioniert mit oder ohne Notch.
- Claude Code und die Tools, die die App auf deinem Mac findet, verbinden sich von selbst. Codex bleibt ausgeschaltet, bis du es in den Einstellungen einschaltest und die Hooks von Cowork Island in Codex erlaubst.
- Jede Sitzung zeigt ihren Status und „Braucht dich“, wenn sie auf dich wartet. Standardmäßig öffnet sich die Insel dann von selbst, sofern das Terminal oder die App dieser Sitzung nicht bereits im Vordergrund ist.
- Wenn eine Sitzung fertig ist, öffnet sich die Insel standardmäßig für 5 Sekunden.
- Bei Claude Code kannst du eine Aktion erlauben oder ablehnen oder eine Multiple-Choice-Frage auf der Insel beantworten. Das Antworten auf der Insel ist kostenlos. Bei anderen Tools musst du unter Umständen direkt in deren App oder Terminal antworten.
- Töne sind ausgeschaltet, bis du sie einschaltest. Der Ton „Genehmigung erforderlich“ ist kostenlos. Der Abschlusston „Sitzung abgeschlossen“ ist Teil von Pro. Die App zeigt keine eigenen macOS-Banner.
Der kostenlose Plan zeigt jeweils eine Sitzungskarte. Pro zeigt alle deine Sitzungen. Der Sprung zurück zum Fenster, Tab oder Terminalbereich einer Sitzung ist Teil von Pro. Automatisch startet eine 7-tägige Pro-Testphase, einmal pro Mac und ohne Zahlungsdaten. Sieh dir die Pläne und die Installationsanleitung an.
Kostenlos herunterladenQuellen.
- Claude-Code-Dokumentation: Hook-Referenz
- Claude-Code-Dokumentation: Anleitung zu Hooks
- Claude-Code-Dokumentation: Terminal-Konfiguration
- Claude-Code-Dokumentation: Einstellungsreferenz
- Codex-Dokumentation: Hooks
- Codex-Dokumentation: Erweiterte Konfiguration
- Codex-Dokumentation: Konfigurationsreferenz
- Gemini-CLI-Dokumentation: Hook-Referenz
- Gemini-CLI-Dokumentation: Benachrichtigungen
- Gemini-CLI-Dokumentation: Konfigurationsreferenz
- Leitfaden zur Mac-Automatisierung mit Skripten: Mitteilungen anzeigen
- Terminal-Benutzerhandbuch: Erweiterte Einstellungen
- ntfy-Dokumentation: Nachrichten veröffentlichen
- Cowork Island FAQ und Installationsanleitung
Quellen geprüft am 18. Oktober 2026. Dieses Tool stammt vom Entwickler von Cowork Island. Für Korrekturen schreib an support@coworkisland.com oder eröffne ein Issue auf GitHub.