Claude Code-Benachrichtigungen unter Windows (PowerShell und WSL)

01Natives Windows oder WSL: Wo deine Hooks laufen

Claude Code läuft entweder nativ unter Windows oder in WSL, und davon hängt ab, wie ein Benachrichtigungs-Hook funktioniert.

• Natives Windows. Die Einstellungen liegen in %USERPROFILE%\.claude\settings.json. Laut der Hooks-Referenz von Anthropic laufen Command-Hooks standardmäßig in Git Bash oder, wenn Git Bash nicht installiert ist, in PowerShell. Mit "shell": "powershell" erzwingst du PowerShell für einen einzelnen Hook; Claude Code nutzt dann pwsh.exe (PowerShell 7), falls vorhanden, sonst powershell.exe (Windows PowerShell 5.1).
• WSL. Du installierst und startest claude im WSL-Terminal, die Einstellungsdatei ist also die von Linux, ~/.claude/settings.json in deiner Distribution, und Hooks laufen in einer Linux-Shell. notify-send erreicht von dort meist nicht den Windows-Desktop. Ruf stattdessen Windows-Programme auf.

02Der schnelle Test: die Terminal-Glocke

Das einfachste Signal ist die Glocke. Füg das in deine Einstellungsdatei ein:

{
  "preferredNotifChannel": "terminal_bell"
}

Claude Code sendet dann ein Bell-Zeichen, wenn es fertig ist oder auf dich wartet. In Windows Terminal legst du pro Profil über bellStyle in dessen settings.json fest, was die Glocke tut. "bellStyle": ["window", "taskbar"] lässt Fenster und Taskleisten-Button aufblinken, statt einen Ton abzuspielen. Mehr dazu im Guide zur Terminal-Glocke. Das hilft allerdings nur, solange das Terminal sichtbar ist.

03Ein Notification hook mit PowerShell

Das ist das Windows-Beispiel aus dem Hooks-Guide von Anthropic. Es funktioniert ohne Installation:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Es öffnet ein Dialogfenster, keinen Toast in der Bildschirmecke, und der Dialog kann hinter deinem Terminal aufgehen. Teste den Befehl zuerst in PowerShell. Tipp /hooks in Claude Code, um zu prüfen, ob der Hook geladen ist.

Der leere Matcher greift bei jedem Benachrichtigungstyp, auch bei permission_prompt (eine Freigabe wartet seit etwa sechs Sekunden) und idle_prompt (Claude ist seit etwa 60 Sekunden fertig). Das Timing erklärt der Notification hook-Guide.

04Ein echter Toast mit BurntToast

BurntToast ist ein weit verbreitetes, von der Community gepflegtes PowerShell-Modul für Windows-Toast-Benachrichtigungen. Installier es einmalig für deinen Benutzer:

Install-Module -Name BurntToast -Scope CurrentUser

Dann prüf, ob es funktioniert:

New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'

Jetzt im Hook verwenden. Diese Variante startet PowerShell ohne Profil und umgeht die Execution Policy für diesen einen Aufruf, damit es sich aus Git Bash und PowerShell gleich verhält:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'\""
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

Der Stop-Hook läuft am Ende jedes Turns, du erfährst also sofort von einer erledigten Aufgabe und nicht erst eine Minute später; siehe den Stop hook-Guide. "async": true führt den Hook im Hintergrund aus, damit ein langsamer PowerShell-Start Claude Code nicht ausbremst.

Wenn nie Toasts erscheinen, schau unter Einstellungen > System > Benachrichtigungen: Benachrichtigungen müssen an und „Nicht stören“ muss aus sein. BurntToast-Toasts tauchen dort meist unter Windows PowerShell auf, dessen Benachrichtigungen ebenfalls erlaubt sein müssen.

05Aus WSL: Windows per Interop aufrufen

In WSL läuft der Hook unter Linux, aber WSL kann Windows-Programme über ihren .exe-Namen starten. Laut dem Guide von Anthropic muss powershell.exe dafür über Windows-Interop in deinem PATH liegen. Das ist Standard und wird über appendWindowsPath im Abschnitt [interop] von /etc/wsl.conf gesteuert. Prüf es in deiner WSL-Shell:

command -v powershell.exe

Ist BurntToast auf der Windows-Seite installiert, nutzt der Hook in deiner WSL-~/.claude/settings.json denselben Befehl:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

Der Start von Windows PowerShell aus WSL kann eine Sekunde oder länger dauern, ein weiterer Grund für "async": true.

06Wo Claude Code Notifier ins Spiel kommt

Die Hooks oben reichen, solange du am Schreibtisch sitzt. Sobald du weg bist, bringen sie nichts, und über einen Toast kannst du keinen Befehl für Claude freigeben.

Claude Code Notifier ist ein unabhängiges Tool (von TouchTap, nicht von Anthropic), das auf den Hooks von Claude Code aufsetzt. Das kostenlose Kommandozeilen-Tool ccn läuft auf Mac, Windows und Linux; die Windows-Unterstützung ist noch Beta. Unter nativem Windows installierst du es aus PowerShell:

irm https://claudecodenotifier.com/install.ps1 | iex

Es trägt seine Hooks in deine Claude Code-Einstellungen ein, lässt den Rest der Datei unangetastet und legt ein Backup an. Ab sofort zeigt es einen Windows-Toast, wenn Claude fertig ist, eine Berechtigung braucht oder eine Frage stellt, ganz ohne Handy und Netzwerk. Da es sich in Claude Code einklinkt und nicht ins Terminal, funktioniert es in Windows Terminal, PowerShell und IDE-Terminals gleich.

Läuft Claude Code in WSL, installier ccn mit der Linux-Zeile innerhalb von WSL, denn dort liegen Claude Code und seine Einstellungen:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

Führ dann ccn test aus. Ob eine Desktop-Benachrichtigung aus WSL deinen Windows-Desktop erreicht, hängt von deinem WSL-Setup ab, bei WSL ist das Handy also der zuverlässige Weg. Mit gekoppeltem Handy kommen Events als Push-Benachrichtigungen an, und du kannst eine Berechtigung einmal oder für die Session erlauben oder ablehnen, die Fragen von Claude beantworten und die nächste Anweisung vom Handy schicken. Siehe Handy koppeln, die ccn-Seite und Preise für die Handy-Apps.

Wenn du ccn installierst, entferne deine eigenen Toast-Hooks, damit du keine doppelten Benachrichtigungen bekommst.

07FAQ