Claude Code bildirimleri çalışmıyor mu? Kontrol listesi

011. Claude Code'un hook'u yüklediğini kontrol edin

Claude Code prompt'una /hooks yazın. Bu, Claude Code'un yüklediği tüm hook'ları gösteren salt okunur bir tarayıcıdır ve her birinin nereden geldiğini belirtir: kullanıcı ayarları, proje ayarları, yerel ayarlar, bir plugin veya mevcut oturum. Tam komutu ve tanımlandığı dosyayı görmek için bir hook seçin.

Hook'unuz listede yoksa:

• JSON geçersizdir. Ayar dosyaları katı JSON'dur. Sondaki bir virgül veya // yorumu dosyayı bozar ve Claude Code bir sonraki açılışta Settings Error bildirir. Claude Code'un reddettiği girdileri görmek için claude doctor komutunu çalıştırın.
• Dosya yanlış yerdedir. Kişisel hook'lar ~/.claude/settings.json dosyasına (Windows'ta %USERPROFILE%\.claude\settings.json) yazılır. Proje hook'ları projenin içindeki .claude/settings.json dosyasına yazılır. Hangi dosyaların yüklendiğini görmek için /status çalıştırıp Setting sources satırına bakın.
• Event adı yanlıştır. Event adları büyük/küçük harfe duyarlıdır: Notification, Stop, PermissionRequest. Bilinmeyen bir event adı Settings Warning olarak gösterilir ve atlanır.
• Hook'lar kapatılmıştır. Herhangi bir ayar dosyasındaki "disableAllHooks": true tüm hook'ları kapatır. /hooks Only hooks from managed settings run here diyorsa, kuruluşunuz allowManagedHooksOnly ayarını etkinleştirmiştir ve kendi hook'larınız çalışmaz.
• Değişiklik algılanmamıştır. Claude Code normalde ayarları kendiliğinden yeniden yükler. Hook birkaç saniye içinde görünmezse oturumu yeniden başlatın.

022. Çalışma alanı güvenini onaylayın

Etkileşimli bir oturumda Claude Code, siz klasör için çalışma alanı güven iletişim kutusunu onaylayana kadar kendi ~/.claude/settings.json dosyanız dahil tüm ayar dosyalarındaki hook'ları bekletir. Bu iletişim kutusunu kapattıysanız veya Claude Code'u daha önce hiç açmadığınız bir klasördeyseniz, hook'larınız orada çalışmaz. O klasörde claude başlatın ve iletişim kutusunu onaylayın.

033. Event'in sandığınız anda tetiklendiğinden emin olun

"Bozuk" görünen bildirimlerin çoğu aslında zamanlama meselesidir. Anthropic'in hooks referansına göre:

Yani terminalde yazarken bir Notification hook'unu test ederseniz hiç tetiklenmeyebilir. Başka bir pencereye geçip bekleyin. Bir tur biter bitmez uyarı almak için Stop kullanın; ayrıntılar Stop hook rehberinde.

İzin modunuzu da kontrol edin. Claude Code'un yeni sürümleri etkileşimli oturumları, bir sınıflandırıcının çoğu işlemi sormadan onayladığı auto modda başlatır. Prompt yoksa permission_prompt bildirimi ve PermissionRequest hook'u da yoktur. İzin uyarılarını test etmek için durum çubuğunda manual mod görünene kadar Shift+Tab tuşuna basın, ardından Claude'dan onay gerektiren bir şey yapmasını isteyin. Ayrıntılar için İzin modları açıklaması'na bakın.

Matcher'lar da büyük/küçük harfe duyarlıdır. bash değerindeki bir PermissionRequest matcher'ı Bash aracıyla eşleşmez.

044. Hook komutunu kendiniz çalıştırın

Komutu /hooks üzerinden kopyalayın ve örnek girdiyle bir terminalde çalıştırın:

echo '{"hook_event_name":"Stop","cwd":"/tmp","last_assistant_message":"done"}' | ./my-hook.sh
echo $?

Sık görülen hatalar:

• command not found: betiğin mutlak yolunu, proje içindeki betikler için de ${CLAUDE_PROJECT_DIR} kullanın.
• Betik hiçbir şey yapmıyor: chmod +x ./my-hook.sh ile çalıştırılabilir yapın.
• jq: command not found: jq kurun ya da JSON'u Python veya Node.js ile ayrıştırın.

055. Debug log'u okuyun

Claude Code'u claude --debug ile başlatın. Terminalde fazladan bir şey yazdırılmaz; log ~/.claude/debug/<session-id>.txt dosyasına gider. Yolu kendiniz seçmek için claude --debug-file /tmp/claude.log kullanın ve başka bir terminalde tail -f /tmp/claude.log çalıştırın. Oturum zaten açıksa /debug log'u açar ve nerede olduğunu söyler.

Hooks: ile başlayan satırlara bakın. Her biri event'i, komutu, nasıl sonlandığını (finished with status 0, timed out, failed to start) ve ne kadar sürdüğünü gösterir. Eşleşme hakkında daha fazla ayrıntı için CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose ayarlayın.

İki sorun yalnızca burada ortaya çıkar:

• Shell profiliniz bir şey yazdırıyor. ~/.bashrc veya ~/.zshrc bir echo çalıştırıyorsa ve shell bunu source ediyorsa, bu metin hook'unuzun JSON çıktısının önüne eklenir ve Claude Code çıktıyı düz metin olarak değerlendirir. Log'da Hook output does not start with { ifadesini arayın. Profil çıktısını if [[ $- == *i* ]]; then ... fi içine alın ki yalnızca etkileşimli shell'lerde çalışsın.
• Yazılacak terminal yok. Mac ve Linux'ta command hook'ları kontrol eden bir terminal olmadan çalışır. Zil çaldırmaya veya /dev/tty'ye escape kodu yazmaya çalışan bir hook sessizce başarısız olur. Bunun yerine bir masaüstü bildirim komutu ya da Claude Code'un kendi preferredNotifChannel ayarını kullanın; bu konu terminal zili rehberinde anlatılıyor.

066. İşletim sistemini kontrol edin

Debug log hook'un 0 durum koduyla bittiğini söylüyor ama yine de hiçbir şey görmediyseniz, bildirimi işletim sistemi gizlemiştir. Bildirimi gönderen uygulamanın bildirim gösterme izni olduğunu ve Odak (Mac), Rahatsız etmeyin (Windows) ya da Linux masaüstünüzdeki rahatsız etmeyin seçeneğinin kapalı olduğunu kontrol edin. Linux'ta ayrıca bir bildirim daemon'ının çalışıyor olması gerekir.

Platforma özel komutları macOS, Windows ve Linux rehberlerinde bulabilirsiniz.

07Claude Code Notifier kullanıyorsanız

Claude Code Notifier, küçük bir programı (ccn) Claude Code hook'ları olarak kuran bağımsız bir araçtır (Anthropic tarafından geliştirilmemiştir). ccn de diğerleri gibi bir hook olduğu için yukarıdakilerin hepsi geçerliliğini korur. Önce aracın kendi kontrolleriyle başlayın:

1. ccn doctor hook'ları, kimlik bilgilerini, sunucu bağlantısını ve varlık algılamayı kontrol eder. Önce bildirdiği sorunları giderin.
2. ccn test bir test bildirimi gönderir. Bildirim ulaşıyorsa sorun altyapıda değil, olayda ya da bir ayardadır.
3. ccn devices bu bilgisayarla eşleştirilmiş telefonları listeler. Hiçbiri listelenmiyorsa ccn pair ile yeniden eşleştirin; eşleştirme rehberi adım adım anlatıyor.
4. ccn config show geçerli ayarları yazdırır. notify_on_done, notify_on_permission ve notify_on_question ayarlarının açık olduğunu ve quiet_hours aralığının şu anki saati kapsamadığını kontrol edin. Telefonda değiştirilen ayarlar bilgisayara ccn sync ile aktarılır.

Bazı davranışlar hata gibi görünse de aslında bilerek böyle tasarlanmıştır:

• Klavyenin başındasınız. Son 30 saniye içinde bir şey yazdıysanız telefon beklenmez ve terminal her zamanki gibi sorar. quiet_when_present açıkken (varsayılan), Claude'un çalıştığı terminalin başındaysanız telefona hiçbir şey gitmez; başka bir uygulamada aktifseniz bir bilgi kartı gider.
• Mac'te yinelenen veya eksik bildirimler. Eski Mac menü çubuğu uygulamasını ve ccn'i aynı Mac'te birlikte çalıştırmayın.
• Uzun süre kullanmamak. Bir telefon veya bilgisayar 60 gün kullanılmazsa sunucu eşleştirmesini siler; bu durumda yeniden eşleştirmeniz gerekir.

Telefonun kendisinde, uygulama için bildirimlere izin verildiğini ve Odak (iPhone) ya da Rahatsız Etmeyin (Android) modunun bildirimleri susturmadığını kontrol edin. Android'de pil optimizasyonu bazı uygulamaların bildirimlerini geciktirebilir; bildirimler geç geliyorsa uygulamanın pil ayarlarından kısıtlamasız çalışmasına izin verin. settings.json dosyasını elle düzenlediyseniz ccn doctor hook'larının hâlâ yerinde olup olmadığını söyler. ccn upgrade en son sürüme günceller.

08SSS