macOS'ta Claude Code bildirimleri

01Claude Code kendiliğinden ne yapar

Claude Code, bir görevi bitirdiğinde veya izin beklediğinde ve siz terminalden uzakta görünüyorsanız bir bildirim olayı tetikler. Anthropic'in terminal rehberine göre ne göreceğiniz terminale bağlıdır:

iTerm2 için Settings > Profiles > Terminal bölümünü açın, Notification Center Alerts seçeneğini işaretleyin, ardından Filter Alerts'e tıklayıp Send escape sequence-generated alerts seçeneğini açın. Ayrıca Sistem Ayarları > Bildirimler bölümünde iTerm2'nin bildirim göndermesine izin verildiğini kontrol edin.

Apple Terminal'de en azından ses alabilirsiniz. ~/.claude/settings.json dosyasında "preferredNotifChannel": "terminal_bell" ayarını yapın ve Settings > Profiles > Advanced altında Audible bell seçeneğini açın. Bu yöntem terminal zili rehberinde ayrıntılı olarak anlatılıyor.

Yerleşik uyarının sınırları var. Yalnızca Claude Code sizin uzakta olduğunuzu düşündüğünde tetiklenir, sadece bir şey olduğunu söyler ve asla bilgisayarın dışına çıkmaz.

02osascript ile bildirim hook'u

Hook, IDE terminalleri dahil her terminalde çalışır. Bu, Anthropic'in hooks rehberindeki macOS örneğidir. Mevcut diğer anahtarları koruyarak ~/.claude/settings.json dosyasına ekleyin:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Notification altında listelendiğini doğrulamak için Claude Code'da /hooks yazın.

Script Editor izni

osascript bildirimleri Script Editor adına gönderir. Script Editor'ın bildirim izni yoksa komut sessizce başarısız olur ve macOS izin istemez. Terminal'de bunu bir kez çalıştırın:

osascript -e 'display notification "test"'

İlk seferde hiçbir şey görünmez. Sistem Ayarları > Bildirimler'i açın, Script Editor'ı bulun ve Bildirimlere İzin Ver'i açın. Komutu tekrar çalıştırdığınızda test bildirimi görünmelidir.

Ne zaman tetiklenir

Boş matcher her bildirim türünde tetiklenir. En çok ilgilendiğiniz iki tür permission_prompt (Claude yaklaşık altı saniyedir onay bekliyor ve siz bir şey yazmadınız) ve idle_prompt'tur (Claude yaklaşık 60 saniye önce bitirdi ve o zamandan beri bir şey yazmadınız). Notification hook rehberi tüm türleri ve zamanlamalarını listeler.

03Claude bitirdiği anda haberdar olun

idle_prompt bir dakika bekler. Hemen haber almak için Claude turunu bitirdiğinde çalışan bir Stop hook'u ekleyin. Stop matcher almaz:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude has finished\" with title \"Claude Code\" sound name \"Glass\"'"
          }
        ]
      }
    ]
  }
}

sound name, /System/Library/Sounds içindeki herhangi bir sesi kabul eder; örneğin Glass, Ping veya Hero. Yalnızca ses istiyorsanız komut olarak afplay /System/Library/Sounds/Glass.aiff kullanabilirsiniz. Bu olayla ilgili daha fazlası Stop hook rehberinde.

04Gerçek mesajı gösterin

Hook'lar standart girdiden JSON alır. Notification girdisinde "Claude needs your permission" gibi bir message alanı bulunur. Küçük bir script bu metni bildirime koyabilir. Bunu ~/.claude/hooks/notify-mac.sh olarak kaydedin:

#!/bin/bash
msg=$(jq -r '.message // "Claude Code needs your attention"')
osascript -e 'on run argv' \
  -e 'display notification (item 1 of argv) with title "Claude Code"' \
  -e 'end run' "$msg"

Metni AppleScript dizesinin içine değil, argüman olarak geçirmek, mesajdaki tırnakların komutu bozmasını engeller. chmod +x ~/.claude/hooks/notify-mac.sh ile çalıştırılabilir yapın ve hook komutunu ~/.claude/hooks/notify-mac.sh olarak ayarlayın. Script jq gerektirir (jq --version başarısız olursa brew install jq).

05terminal-notifier: tıklayınca terminalinize dönün

osascript bildirimine tıklandığında Script Editor açılır; gitmek istediğiniz yer bu değildir. terminal-notifier öne gelecek uygulamayı seçmenize olanak tanır:

brew install terminal-notifier
terminal-notifier -title "Claude Code" -message "Claude has finished" -sound default -activate com.googlecode.iterm2

Apple Terminal için com.apple.Terminal veya editörünüzün bundle ID'sini kullanın. Aynı komut hook'un command alanına girer. İlk seferde Sistem Ayarları'nda terminal-notifier'a bildirim izni verin.

06Odak ve Rahatsız Etme

Bunların hepsi sıradan macOS bildirimleridir, dolayısıyla bir Odak modu bunları gizleyebilir. Belirli saatlerde kayboluyorlarsa Sistem Ayarları > Odak'ı kontrol edin ve bildirimleri gönderen uygulamaya (Script Editor, terminal-notifier veya terminaliniz) izin verin. Bunun yerine kendi saatlerinize uyan bildirimler için sessiz saatler ve Rahatsız Etme sayfasına bakın.

07Claude Code Notifier'ın yeri

Mac'inizin başındaysanız ve yalnızca bir hatırlatma istiyorsanız yukarıdaki hook'lar iyi bir çözümdür. Uzaklaştığınızda ise yetersiz kalırlar, çünkü bir Mac bildirimi size mutfakta ulaşamaz ve Claude'a yanıt veremez.

Claude Code Notifier, aynı hook'lar üzerine kurulmuş bağımsız bir araçtır (Anthropic değil, TouchTap tarafından geliştirildi). Ücretsiz komut satırı aracı ccn, Mac, Windows ve Linux'ta çalışır. Mac'inize şu komutla kurun:

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

veya Homebrew ile: brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn. Hook girdilerini ~/.claude/settings.json dosyasına ekler, dosyanın geri kalanına dokunmaz ve bir yedek tutar. Bundan sonra Claude işini bitirdiğinde, izin gerektiğinde veya soru sorduğunda, ağ ya da telefon gerekmeden bir macOS bildirimi gösterir.

Bir iPhone veya Android telefon eşlerseniz aynı olaylar push bildirimi olarak gelir; telefondan bir izne onay verebilir ya da reddedebilir, Claude'un sorusuna yanıt seçebilir veya sonraki talimatı gönderebilirsiniz. Son 30 saniye içinde yazdıysanız terminal her zamanki gibi sorar ve telefonda bekleyen bir şey olmaz. Telefon eşleme ve ccn sayfasına bakın. Telefon uygulamaları abonelik veya ömür boyu satın alma gerektirir; bkz. fiyatlandırma.

ccn'i eklerseniz kendi osascript hook'larınızı kaldırın, yoksa her olay için iki bildirim görürsünüz. Ayrıca eski bir Mac menü çubuğu uygulaması da var; bunu aynı Mac'te ccn ile birlikte çalıştırmayın.

08SSS