Windows'ta Claude Code bildirimleri (PowerShell ve WSL)

01Doğrudan Windows mı, WSL mi: hook'larınız nerede çalışır

Claude Code ya doğrudan Windows üzerinde ya da WSL içinde çalışır ve bildirim hook'unun nasıl çalışacağını bu belirler.

• Doğrudan Windows. Ayarlar %USERPROFILE%\.claude\settings.json dosyasındadır. Anthropic'in hooks referansına göre komut hook'ları varsayılan olarak Git Bash'te, Git Bash kurulu değilse PowerShell'de çalışır. Tek bir hook için "shell": "powershell" ile PowerShell'i zorunlu kılabilirsiniz; bu durumda Claude Code bulursa pwsh.exe (PowerShell 7), bulamazsa powershell.exe (Windows PowerShell 5.1) kullanır.
• WSL. claude'u WSL terminalinde kurup çalıştırırsınız; dolayısıyla ayar dosyası Linux tarafındaki, dağıtımınızın içindeki ~/.claude/settings.json dosyasıdır ve hook'lar bir Linux shell'inde çalışır. Oradaki notify-send genellikle Windows masaüstüne ulaşmaz. Bunun yerine Windows programlarını çağırın.

02Hızlı test: terminal zili

En zahmetsiz sinyal zildir. Ayar dosyanıza şunu ekleyin:

{
  "preferredNotifChannel": "terminal_bell"
}

Bundan sonra Claude Code işini bitirdiğinde veya sizi beklediğinde bir zil karakteri gönderir. Windows Terminal'de zilin ne yapacağı, kendi settings.json dosyasındaki bellStyle ile profil bazında ayarlanır. "bellStyle": ["window", "taskbar"] ses çalmak yerine pencereyi ve görev çubuğu düğmesini yanıp söndürür. Bu yöntem hakkında daha fazlası terminal zili rehberinde. Yalnızca terminal görünür durumdayken işe yarar.

03PowerShell ile bir Notification hook

Bu, Anthropic'in hooks rehberindeki Windows örneğidir. Hiçbir şey kurmadan çalışır:

{
  "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')\""
          }
        ]
      }
    ]
  }
}

Ekranın köşesinde bir toast değil, bir iletişim kutusu açar ve bu kutu terminalinizin arkasında açılabilir. Komutu önce PowerShell'de test edin. Hook'un yüklendiğini kontrol etmek için Claude Code'da /hooks yazın.

Boş matcher her bildirim türünde tetiklenir; buna permission_prompt (bir onay yaklaşık altı saniyedir bekliyor) ve idle_prompt (Claude yaklaşık 60 saniye önce bitirdi) da dahildir. Zamanlamanın ayrıntıları Notification hook rehberinde.

04BurntToast ile gerçek bir toast

BurntToast, Windows toast bildirimleri için yaygın olarak kullanılan, topluluk tarafından geliştirilen bir PowerShell modülüdür. Kullanıcınız için bir kez kurun:

Install-Module -Name BurntToast -Scope CurrentUser

Ardından çalıştığını kontrol edin:

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

Bir hook içinde kullanın. Bu sürüm PowerShell'i profil olmadan başlatır ve yalnızca bu çağrı için execution policy'yi atlar; böylece Git Bash'ten de PowerShell'den de aynı şekilde çalışır:

{
  "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
          }
        ]
      }
    ]
  }
}

Stop hook her turun sonunda çalışır, bu yüzden biten bir görevden bir dakika sonra değil hemen haberiniz olur; Stop hook rehberine bakın. "async": true hook'u arka planda çalıştırır, böylece PowerShell'in yavaş açılması Claude Code'u bekletmez.

Toast'lar hiç görünmüyorsa Ayarlar > Sistem > Bildirimler bölümünü kontrol edin: bildirimler açık, Rahatsız Etmeyin kapalı olmalıdır. BurntToast toast'ları orada genellikle Windows PowerShell altında görünür; onun bildirimlerine de izin verilmiş olmalıdır.

05WSL'den: Windows'u interop ile çağırın

WSL içinde hook Linux'ta çalışır, ancak WSL Windows programlarını .exe adlarıyla başlatabilir. Anthropic'in rehberi, powershell.exe'nin Windows interop aracılığıyla PATH'inizde olması gerektiğini belirtir. Bu varsayılan durumdur ve /etc/wsl.conf dosyasının [interop] bölümündeki appendWindowsPath ile kontrol edilir. WSL shell'inizden kontrol edin:

command -v powershell.exe

BurntToast Windows tarafında kuruluysa, WSL'deki ~/.claude/settings.json dosyanızdaki hook da aynı komuttur:

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

WSL'den Windows PowerShell'i başlatmak bir saniye veya daha uzun sürebilir; bu da "async": true kullanmak için bir neden daha.

06Claude Code Notifier'ın yeri

Yukarıdaki hook'lar masanızın başındaysanız yeterlidir. Uzaklaştığınızda işe yaramazlar ve bir toast Claude için bir komutu onaylayamaz.

Claude Code Notifier, Claude Code'un hook'ları üzerine kurulmuş bağımsız bir araçtır (Anthropic tarafından değil, TouchTap tarafından geliştirilmiştir). Ücretsiz komut satırı aracı ccn; Mac, Windows ve Linux'ta çalışır; Windows desteği beta aşamasındadır. Doğrudan Windows'ta PowerShell'den kurun:

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

Hook kayıtlarını Claude Code ayarlarınıza ekler, dosyanın geri kalanına dokunmaz ve bir yedek tutar. Claude işini bitirdiğinde, izin gerektiğinde veya bir soru sorduğunda hemen bir Windows toast'ı gösterir; telefon ya da ağ gerekmez. Terminale değil Claude Code'a bağlandığı için Windows Terminal, PowerShell ve IDE terminallerinde aynı şekilde çalışır.

Claude Code WSL'de çalışıyorsa ccn'i Linux satırıyla WSL içine kurun, çünkü Claude Code ve ayarları oradadır:

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

Ardından ccn test çalıştırın. WSL içinden gönderilen bir masaüstü bildiriminin Windows masaüstünüze ulaşıp ulaşmayacağı WSL kurulumunuza bağlıdır; bu yüzden WSL için güvenilir yol telefondur. Eşleştirilmiş bir telefonla olaylar push bildirimi olarak gelir; telefondan bir izne bir kez veya oturum boyunca izin verebilir ya da reddedebilir, Claude'un sorularını yanıtlayabilir ve bir sonraki talimatı gönderebilirsiniz. Telefon uygulamaları için telefon eşleştirme, ccn sayfası ve fiyatlandırma bölümlerine bakın.

ccn'i kurarsanız, yinelenen bildirimlerden kaçınmak için kendi toast hook'larınızı kaldırın.

07SSS