Claude Code Push-Benachrichtigungen: wissen, wann eine Aufgabe fertig ist

Claude Code arbeitet gerne zwanzig Minuten allein vor sich hin. Das Problem ist die andere Seite dieser zwanzig Minuten: Entweder sitzt du vor dem Terminal und schaust zu, oder du gehst weg und kommst zurück, nur um festzustellen, dass es seit der dritten Minute auf eine Berechtigungsabfrage wartet.
Hooks lösen beides. Claude Code führt an festen Punkten seines Lebenszyklus einen Shell-Befehl aus, und drei dieser Punkte willst du auf deinem Handy haben:
- Stop: Claude hat die Antwort beendet. Die Aufgabe ist erledigt, oder es hat eine Rückfrage.
- Notification: Claude braucht dich. Eine Berechtigungsabfrage oder es wartet im Leerlauf auf Eingaben.
- StopFailure: Der Durchlauf endete mit einem API-Fehler, etwa einem Rate-Limit oder einem Abrechnungsproblem.
Diese Anleitung verbindet alle drei mit Pocket Alert über ein einziges Skript. Die Einrichtung dauert etwa fünf Minuten.
Was du brauchst
- Claude Code, eine beliebige aktuelle Version.
jqundcurl. Beide sind in den meisten Linux-Distributionen dabei; auf macOS mitbrew install jq.- Ein Pocket-Alert-Konto und einen API-Schlüssel aus API-Schlüssel. Der kostenlose Tarif reicht.
- Die Pocket-Alert-App auf deinem iPhone oder Android-Handy, angemeldet.
Schritt 1: Das Hook-Skript
Claude Code übergibt jedem Hook ein JSON-Objekt über stdin. Du brauchst die Felder hook_event_name, cwd, bei Stop last_assistant_message, bei Notification message und bei StopFailure error. Das Skript macht daraus eine Push-Benachrichtigung:
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.cwd' <<<"$payload")")
case "$(jq -r '.hook_event_name' <<<"$payload")" in
Stop)
title="Claude finished · $project"
message=$(jq -r '.last_assistant_message // "Task complete"' <<<"$payload")
level=default ;;
Notification)
title="Claude needs you · $project"
message=$(jq -r '.message' <<<"$payload")
level=high ;;
StopFailure)
title="Claude stopped · $project"
message=$(jq -r '"API error: " + (.error // "unknown")' <<<"$payload")
level=high ;;
*) exit 0 ;;
esac
jq -n --arg t "$title" --arg m "${message:0:300}" --arg l "$level" \
'{title: $t, message: $m, level: $l}' |
curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
-H "Token: $POCKETALERT_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- >/dev/null || true
exit 0
Speichere es als ~/.claude/hooks/pocketalert.sh und mach es ausführbar:
mkdir -p ~/.claude/hooks
chmod +x ~/.claude/hooks/pocketalert.sh
Zwei Zeilen darin sind wichtiger, als sie aussehen:
jq -nbaut das JSON. Claudes letzte Nachricht ist voller Anführungszeichen, Backticks und Zeilenumbrüche. Wer sie von Hand in einen JSON-String einfügt, scheitert am ersten Anführungszeichen;jqmaskiert alles korrekt.exit 0am Ende und|| truenach curl. Bei einem Stop-Hook bedeutet Exit-Code 2 „nicht anhalten, weitermachen“. Ein Benachrichtigungs-Hook darf Claude niemals blockieren, auch wenn dein Netzwerk ausgefallen ist.
Oder mit der Pocket-Alert-CLI
Wenn du die Pocket-Alert-CLI in Version 2.0 oder neuer installiert hast, schrumpft der curl-Block auf einen Befehl. Die CLI maskiert den Text selbst und liest den Schlüssel aus POCKETALERT_API_KEY (der env-Block unten setzt ihn) oder aus pocketalert auth:
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
Verwende -t und -m statt Positionsargumenten: Eine Antwort, die mit einem Bindestrich beginnt, etwa eine Markdown-Liste, würde sonst als Option gelesen.
Schritt 2: Die Hooks registrieren
Ergänze die Hooks in ~/.claude/settings.json, damit sie für jedes Projekt gelten. Wenn die Datei schon einen hooks-Schlüssel hat, füge diese Einträge dort ein:
{
"env": {
"POCKETALERT_API_KEY": "YOUR_API_KEY"
},
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"Notification": [
{
"matcher": "permission_prompt|idle_prompt",
"hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }]
}
]
}
}
Der env-Block gibt den API-Schlüssel an den Hook weiter, ohne ihn in dein Shell-Profil zu schreiben. Wenn du POCKETALERT_API_KEY bereits anderswo exportierst, lass den Block weg.
Der matcher bei Notification filtert nach Benachrichtigungstyp. permission_prompt greift, wenn eine Berechtigungsabfrage etwa sechs Sekunden ohne Antwort geblieben ist, und idle_prompt etwa eine Minute, nachdem Claude fertig ist, falls du seitdem nichts getippt hast. In einer Terminal-Sitzung feuern beide erst, wenn es so aussieht, als wärst du weg. So summt dein Handy nicht, während du zusiehst. Stop hat keinen Matcher: Der Hook feuert jedes Mal, wenn Claude eine Antwort beendet.
Um die Hooks auf ein einzelnes Repository zu beschränken, trage denselben hooks-Block stattdessen in .claude/settings.json in diesem Repository ein, oder in .claude/settings.local.json, damit er nicht in Git landet.
Schritt 3: Testen
Claude Code übernimmt Änderungen an der Settings-Datei normalerweise selbst (starte eine neue Sitzung, falls /hooks sie noch nicht auflistet). Gib ihm etwas Kleines:
> List the files in this directory and stop.
Wenn Claude fertig ist, zeigt dein Handy Claude finished · your-project mit dem Anfang seiner Antwort. Falls nichts ankommt, führe /hooks in Claude Code aus, um die registrierten Hooks zu sehen.
Um das Skript allein zu testen, füttere es mit einem gefälschten Ereignis:
echo '{"hook_event_name":"Stop","cwd":"/tmp/demo","last_assistant_message":"Hook test"}' \
| POCKETALERT_API_KEY=YOUR_API_KEY ~/.claude/hooks/pocketalert.sh
Was auf deinem Handy ankommt
| Ereignis | Titel | Text | Level |
|---|---|---|---|
| Aufgabe erledigt | Claude finished · api | Die ersten 300 Zeichen von Claudes letzter Antwort | default |
| Berechtigungsabfrage | Claude needs you · api | Claude needs your permission | high |
| Wartet auf Eingabe | Claude needs you · api | Claude is waiting for your input | high |
| API-Fehler | Claude stopped · api | API error: rate_limit | high |
high kommt auf dem iPhone als zeitkritisch an. Eine Berechtigungsabfrage kommt also auch durch den Fokus, während Routine-Meldungen wie „fertig“ still bleiben. Jede Push-Benachrichtigung bleibt außerdem im Verlauf der App und im Web-Dashboard, sodass du nachschauen kannst, was Claude über Nacht gemacht hat.
Passe es an
Nur wenn du weg bist. Stop feuert nach jeder Antwort, auch nach den kurzen, bei denen du zusiehst. Ergänze oben im Skript einen Schalter:
[ -f ~/.claude/away ] || exit 0
Dann touch ~/.claude/away, wenn du den Schreibtisch verlässt, und rm ~/.claude/away, wenn du zurückkommst. Berechtigungsabfragen sind so oder so wichtig, also kannst du die Prüfung auf den Stop)-Zweig beschränken.
Nach Projekt gruppieren. Lege in Pocket Alert pro Projekt eine Anwendung an und ergänze application_id im JSON. Die App filtert dann nach Projekt, und du kannst jeder Anwendung eine eigene Standardstufe geben.
Claude gar nicht blockieren. Ergänze "async": true neben "type": "command", dann läuft der Hook im Hintergrund. Lass ihn bei Headless-Läufen (claude -p) weg: Hintergrund-Hooks werden beendet, sobald die Sitzung endet, und die Push-Benachrichtigung geht womöglich nie raus.
Vom Handy aus fortsetzen. Mit einem kostenpflichtigen Tarif kannst du über einen copy-Aktionsbutton mit der Sitzungs-ID claude --resume <id> vom Handy kopieren und es zurück am Schreibtisch einfügen.
Oder lass Claude es per MCP senden
Hooks sind deterministisch: Sie feuern, ob Claude dich im Gedächtnis hat oder nicht. Der andere Weg ist, Claude ein Benachrichtigungs-Tool zu geben und es entscheiden zu lassen, wann es es nutzt. Füge den Pocket-Alert-MCP-Server hinzu:
claude mcp add --transport http pocketalert https://mcp.pocketalert.app/mcp \
--scope user --header "Authorization: Bearer YOUR_API_KEY"
Jetzt kannst du sagen: „Führe die Migration aus und schick mir die Zeilenanzahl, wenn sie fertig ist“, und Claude ruft create_message mit einer Nachricht auf, die es dafür schreibt. Das Tool nimmt außerdem level und actions entgegen, und list_messages lässt Claude nachlesen, was es zuvor gesendet hat.
Nutze beides: Hooks für das garantierte „fertig“ und „du bist gefragt“, MCP für Nachrichten mit echtem Inhalt. Für Freigaben vor riskanten Schritten siehe Human-in-the-loop-Benachrichtigungen.
Wenn nichts ankommt
- Prüfe den Schlüssel. Führe den Testbefehl von oben aus. Ein
401von curl bedeutet, dass der API-Schlüssel falsch ist; entferne>/dev/null, um die Antwort zu sehen. - Prüfe, ob die Hooks geladen sind. Führe
/hooksaus. Änderungen an der Settings-Datei werden normalerweise innerhalb von Sekunden übernommen; wenn die Hooks nicht aufgelistet werden, starte Claude Code neu. - Prüfe, ob
jqim PATH liegt, den Claude Code verwendet. Hooks laufen mit Claudes Umgebung, und ein aus der grafischen Oberfläche gestarteter Editor sieht/opt/homebrew/binvon Homebrew womöglich nicht. - Prüfe das Tageslimit. Der kostenlose Tarif erlaubt 50 Nachrichten am Tag. Eine lange Sitzung mit vielen kurzen Durchläufen kann das aufbrauchen; der Weg-Schalter von oben hilft.
FAQ
Funktioniert das mit den Erweiterungen für VS Code und JetBrains?
Ja. Die Erweiterungen laufen mit Claude Code im Hintergrund und lesen dieselbe ~/.claude/settings.json, daher feuern die Hooks dort ebenfalls.
Kann Claude den API-Schlüssel sehen?
Nicht im Gespräch: Hooks laufen außerhalb davon, und ihre Ausgabe bei Stop und Notification wird dem Modell nicht angezeigt. Der env-Block gilt aber für die ganze Sitzung, daher könnte ein Bash-Befehl, den Claude ausführt, die Variable lesen. Wenn das ein Problem ist, bewahre den Schlüssel in einer Datei auf, die nur du lesen kannst, etwa ~/.config/pocketalert/key mit Modus 600, und verwende stattdessen -H "Token: $(cat ~/.config/pocketalert/key)" im Skript.
Wie unterscheidet sich das vom Terminal-Signalton?
Signalton und Desktop-Benachrichtigungen erfordern, dass du am Computer sitzt. Eine Push-Benachrichtigung erreicht dein Handy, egal wo du bist, behält einen Verlauf und lässt sich so einstellen, dass sie für die Abfragen, die Claude blockieren, den Fokus durchbricht.
Kann ich die ganze Antwort bekommen, nicht nur 300 Zeichen?
Eine Push-Benachrichtigung trägt bis zu etwa 3.000 Zeichen Text. Erhöhe das Limit 0:300, aber eine Push-Benachrichtigung dient dazu zu entscheiden, ob du an den Schreibtisch zurückgehst, nicht dazu, die ganze Antwort zu lesen.
Ist es kostenlos?
Ja. Hooks sind Teil von Claude Code, und der kostenlose Tarif von Pocket Alert umfasst 50 Nachrichten am Tag auf einem Gerät. Kostenpflichtige Tarife bieten mehr Nachrichten, Geräte und Aktionsbuttons.
API-Schlüssel holen, das Skript einfügen und dich von Claude sagen lassen, wann du dran bist.