Ruhezeiten und Nicht stören für Claude Code-Benachrichtigungen

01Was „ruhig“ bei Claude Code bedeuten sollte

Bevor du etwas einrichtest, überleg dir, was mit einer Anfrage während der Ruhezeit passieren soll. Es gibt drei Arten von Hinweisen:

• Claude ist fertig. Kann problemlos warten. Du liest es, wenn du nachschaust.
• Claude braucht eine Berechtigung. Claude Code wartet am Prompt, bis jemand antwortet. Erreicht dich nichts, bleibt die Session stehen, bis du zurück bist.
• Claude hat eine Frage gestellt. Wie bei einer Berechtigung: Die Session wartet.

Ruhezeiten tauschen also Schlaf gegen Fortschritt. Startest du vor dem Schlafengehen eine lange Aufgabe, willst du vielleicht „Fertig“-Hinweise stummschalten, eine wartende Anfrage aber morgens noch sehen. Soll Claude über Nacht ohne Rückfragen weiterarbeiten, ist das eine Frage des Berechtigungsmodus, nicht der Benachrichtigungen.

02Ruhezeiten in einem selbstgebauten Hook

Claude Code führt deinen Hook-Befehl bei jedem Event aus. Für Ruhezeiten prüfst du am Anfang des Skripts die Uhrzeit und beendest es vorzeitig. Das klappt mit jedem Hook, egal ob er eine Desktop-Benachrichtigung, einen ntfy-Push oder eine Chat-Nachricht schickt.

Unter Mac und Linux speicherst du das als ~/.claude/hooks/notify.sh und machst es mit chmod +x ausführbar:

#!/bin/sh
# Quiet between 22:00 and 08:00, local time
hour=$(date +%H)
if [ "$hour" -ge 22 ] || [ "$hour" -lt 8 ]; then
  exit 0
fi

# Your real notification command goes here, for example:
notify-send "Claude Code" "Claude has finished"

Auf dem Mac ersetzt du die letzte Zeile durch einen osascript-Befehl; der macOS-Guide hat einen. Dann verweist du den Hook in ~/.claude/settings.json auf das Skript:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/notify.sh" }
        ]
      }
    ]
  }
}

Wichtig ist, mit Code 0 zu beenden. Jeder andere Code zeigt einen Hook-Fehler im Transkript, und Exit-Code 2 bei einem Stop-Hook sagt Claude, weiterzuarbeiten – das willst du hier nicht.

Unter Windows machst du denselben Check in PowerShell mit (Get-Date).Hour. Der Windows-Guide zeigt einen vollständigen PowerShell-Hook.

Hooks komplett pausieren

Für eine einmalige ruhige Session startest du Claude Code mit allen Hooks deaktiviert:

claude --settings '{"disableAllHooks": true}'

Das gilt nur für diese Session. "disableAllHooks": true in einer Settings-Datei schaltet Hooks ab, bis du es wieder entfernst. Beachte, dass damit jeder Hook aus ist, auch solche, die Code formatieren oder Befehle blockieren – also mit Bedacht einsetzen.

Die eigenen Hinweise von Claude Code

Die eingebauten Terminal-Benachrichtigungen von Claude Code steuerst du über preferredNotifChannel. Setzt du den Wert auf "notifications_disabled", hören diese Hinweise auf. Deine Hooks laufen aber weiterhin. Die anderen Werte findest du im Guide zur Terminal-Glocke.

03Fokus und Nicht stören auf dem Handy

Wenn deine Benachrichtigungen aufs Handy gehen, sind dessen eigene Ruhemodi die einfachste Ebene – und sie funktionieren unabhängig davon, welches Tool die Benachrichtigung schickt.

• iPhone: Fokus (Einstellungen › Fokus) schaltet Mitteilungen nach Zeitplan stumm. Du kannst festlegen, welche Apps trotzdem durchkommen. Willst du Claude Code-Benachrichtigungen auch nachts, füg die App zur Liste der erlaubten Apps hinzu; willst du Ruhe, lass sie weg – dann warten die Mitteilungen in der Mitteilungszentrale.
• Android: Bitte nicht stören (je nach Gerät in den Einstellungen unter Benachrichtigungen oder Ton) funktioniert genauso, mit Zeitplan und App-Ausnahmen. In den Benachrichtigungseinstellungen jeder App kannst du außerdem Ton oder Vibration nur für diese App abschalten.

Der Vorteil der Handy-Ebene: Es geht nichts verloren, die Benachrichtigungen kommen trotzdem an und warten auf dich. Der Nachteil: Sie gilt für alles auf dem Handy, du stellst sie also einmal für den ganzen Abend ein und nicht nur für Claude Code.

04Ruhe am Computer

Am Computer schalten Fokus auf dem Mac, Nicht stören unter Windows und der Nicht-stören-Schalter der meisten Linux-Desktops die Desktop-Benachrichtigungen von Hooks stumm. Das ist praktisch beim Screensharing, wenn ein Banner mit Projektname oder Befehl das Letzte ist, was du auf dem Bildschirm haben willst.

05Ruhezeiten mit Claude Code Notifier

Claude Code Notifier ist ein unabhängiges Tool und stammt nicht von Anthropic. Das Kommandozeilen-Tool ccn läuft als Claude Code-Hooks auf Mac, Windows und Linux und schickt Benachrichtigungen an ein gekoppeltes iPhone oder Android-Handy. Ruhe-Einstellungen sind eingebaut, du musst also kein Skript bearbeiten:

ccn config set quiet_hours 22:00-08:00

Während der Ruhezeiten schickt ccn nichts ans Handy, und dort wartet auch nichts: Claude Code fragt wie gewohnt im Terminal, und die Anfrage ist noch da, wenn du zurückkommst. Auch Desktop-Benachrichtigungen auf dem Computer werden in dieser Zeit zurückgehalten. Mit ccn config set quiet_hours off schaltest du den Zeitplan wieder aus.

Weitere hilfreiche Einstellungen:

Mit ccn config set notify_on_done off behältst du zum Beispiel nur die Benachrichtigungen, bei denen Claude blockiert ist. Die meisten Einstellungen kannst du auch pro Computer in der Handy-App ändern – praktisch, wenn du einen Arbeitslaptop und einen Desktop zu Hause mit unterschiedlichen Zeiten hast. Mit ccn config show siehst du, was gerade gilt, und ccn sync holt Änderungen vom Handy.

Willst du das Gegenteil – einen ruhigen Abend, an dem Claude trotzdem weiterarbeitet –, zeigt dir der Walk-away-Workflow, wie du eine Session laufen lässt und sie vom Handy aus beantwortest, wann du willst.

06FAQ