Claude Code bildirimleri (Mac): İş bittiğinde veya Claude seni beklediğinde haber al.

Claude Code’un yerleşik uyarısı, Claude bir görevi bitirdiğinde veya izin istemek için durakladığında ve sen terminalin başında değilmişsin gibi göründüğünde devreye girer. Bu uyarının bildirim başlığı olarak görünüp görünmemesi terminal uygulamasına bağlıdır.

Claude Code’da bunun için tek bir ayar vardır: preferredNotifChannel. Claude Code’da /config yaz ve Local notifications bölümünü aç. Varsayılan değer auto. Diğer seçenekler: terminal_bell, iterm2, iterm2_with_bell, kitty, ghostty ve notifications_disabled.

Terminal zili, bir program dikkatini çekmek istediğinde terminalin çıkardığı kısa ses veya ekrandaki yanıp sönmedir. Terminal.app, Warp veya VS Code’da bunu kullanmak için, ~/.claude/settings.json gibi bir Claude Code ayar dosyasının en dıştaki süslü parantezleri arasına şu satırı da ekleyebilirsin:

"preferredNotifChannel": "terminal_bell"

• iTerm2: Settings > Profiles > Terminal bölümünü aç, Notification Center Alerts seçeneğini işaretle, Filter Alerts düğmesine tıkla ve Send escape sequence-generated alerts seçeneğini aç.
• Terminal.app: Zili daha kolay fark etmek için Settings > Profiles > Advanced bölümünü aç. Bell altında, Terminal arka plandayken Dock simgesinde işaret gösterilmesini veya simgenin zıplamasını seç. Claude Code’u ilk çalıştırdığında sunduğu terminal ayarlarını kabul ettiysen Terminal’in sesli zili kapatılmıştır; sesi duymak istiyorsan aynı yerde Audible bell seçeneğini işaretle.
• Her terminal için: Terminal uygulamasının kendisine Sistem Ayarları > Bildirimler bölümünde bildirim gönderme izni verilmiş olmalıdır.

Eski yazılar claude config set komutunu çalıştırmanı söyler. Bu komut artık yok: /config kullan veya ayar dosyasını düzenle.

Kanca, Claude Code’un belirli bir anda çalıştırdığı bir kabuk komutudur. Kancaları bir ayar dosyasında tanımlarsın. Çalıştırılmalarında terminalin bir rolü olmadığı için her terminalde çalışırlar.

Anthropic’in kendi bildirim alma örneği, Notification olayını kullanır. Bu olay, Claude’un işinin bittiğini yalnızca idle_prompt aracılığıyla, yaklaşık 60 saniye sonra ve ancak o zamandan beri bir şey yazmadıysan bildirir. Claude durduğu anda uyarı almak için Stop kullan.

İstek hız sınırı gibi bir API hatasıyla biten bir tur, Stop yerine StopFailure olayını tetikler. Bildirim kancaları hiçbir işlemi engelleyemez: Yalnızca komutunu çalıştırırlar.

Aşağıdaki her kod parçası, tüm projelerin için geçerli olan ~/.claude/settings.json dosyasına eklenir. Her birinin JSON ve kabuk sözdiziminin geçerli olduğu kontrol edilmiştir. Ek yazılım gerekmez.

Claude’un işi bittiğinde Mac’te bir bildirim başlığı gör.

~/.claude/settings.json dosyasına ekle

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code\" sound name \"Glass\"' -e 'end run' \"Finished in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Claude onayını beklediğinde Mac’te bir bildirim başlığı gör.

~/.claude/settings.json dosyasına ekle

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code needs you\" sound name \"Ping\"' -e 'end run' \"Waiting for your OK in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Her iki bildirim başlığı da oturumun çalıştığı klasörün adını gösterir.

Script Editor’ın bildirim başlıklarını göstermesine izin ver.

Mac’te osascript bildirim başlıkları, yerleşik Script Editor uygulamasından gelir. Script Editor’a bildirim gönderme izni verilene kadar komut hata mesajı göstermeden başarısız olur ve macOS senden izin istemez.

1. Terminal’de şu komutu bir kez çalıştır:

osascript -e 'display notification "test"'

2. Sistem Ayarları > Bildirimler bölümünü aç, Script Editor’ı bul ve Bildirimlere İzin Ver seçeneğini aç.

Bildirim başlığı yerine bir ses duy.

~/.claude/settings.json dosyasına ekle

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" } ] }
    ]
  }
}

Uyarıyı konuşma sesiyle al.

~/.claude/settings.json dosyasına ekle

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "say \"Claude has finished\"", "async": true } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "say \"Claude needs your permission\"", "async": true } ] }
    ]
  }
}

"async": true, Mac konuşurken Claude Code’un çalışmaya devam etmesini sağlar.

Bir olay için bildirim başlığı, diğeri için ses istiyorsan bildirim kancası oluşturucuyu iki kez kullan: Her seferinde bir olay ve uyarı biçimi seç. Ardından iki sonucu da dosyana eklemek için birleştirme kutusunu kullan. Araç, her kod parçasının hangi dosyaya ekleneceğini söyler ve her şey tarayıcında çalışır.

• Klasöre güvenildiğini onayla. Claude Code, o klasör için çalışma alanı güven iletişim kutusunu onaylayana kadar ~/.claude/settings.json içindekiler dahil tüm kancaları bekletir.
• Nelerin yüklendiğini gör. Claude Code’da /hooks yaz. Bu komut kancalarını ve her birinin geldiği dosyayı listeler, ancak kanca ekleyemez. Claude Code normalde değişikliklerini kendiliğinden algılar; algılamazsa oturumu yeniden başlat.
• İş için kullanılan Mac’ler. Bir kuruluş yalnızca kendi yönettiği kancalara izin verebilir. Bu durumda /hooks, “Only hooks from managed settings run here” mesajını gösterir ve kişisel kancalar çalışmaz.
• Aynı anda iki uyarı. Tüm ayar düzeylerindeki kancalar birlikte uygulanır. Bu yüzden proje dosyasındaki bir uyarı kancası ile kullanıcı dosyandaki farklı bir uyarı kancası birlikte tetiklenir. Birden fazla dosyada bulunan tamamen aynı kanca ise yalnızca bir kez çalışır. Kancalar, yerleşik bildirimle birlikte de çalışır. İkisini birden alıyorsan Local notifications ayarını notifications_disabled olarak değiştir ve kancayı kullanmaya devam et.
• Çok fazla uyarı. Stop, yalnızca görevin tamamı bittiğinde değil, her turun sonunda tetiklenir.
• Cowork Island da kullanıyorsan. Yukarıdaki kod parçalarında olduğu gibi her kancanı ayrı bir girdide ve ~/.perch/ dışında tut. Uygulama yalnızca /.perch/ içeren komutları kendisine ait sayar ve girdileri bütünüyle değiştirir. Bu nedenle uygulamanın girdisine yerleştirilen bir komut, o girdiyle birlikte kaldırılır.

• Claude Code belgeleri: Terminal yapılandırması
• Claude Code belgeleri: Kanca başvuru kaynağı
• Claude Code belgeleri: Kanca rehberi
• Claude Code belgeleri: Ayarlar başvuru kaynağı
• Claude Code belgeleri: Ayarlar
• Claude Code değişiklik günlüğü
• Terminal Kullanma Kılavuzu: İleri düzey ayarlar
• Mac Otomasyon Betikleri Kılavuzu: Bildirimleri gösterme
• Cowork Island SSS ve kurulum rehberi

Kaynaklar 18 Ekim 2026’da kontrol edildi. Bu rehber, Cowork Island’ın yapımcısı tarafından yazılmıştır. Düzeltmeler için support@coworkisland.com adresine e-posta gönder veya GitHub’da bir kayıt (issue) aç.