Claude Code'un yerleşik bildirimleri: terminal zili ve preferredNotifChannel

01Hızlı çözüm

Claude işini bitirdiğinde hiçbir şey duymuyorsanız, ~/.claude/settings.json dosyasına şunu ekleyin:

{
  "preferredNotifChannel": "terminal_bell"
}

Ardından terminalinizin zile bir tepki verdiğinden emin olun: ses çalmak, Dock simgesini zıplatmak, sekmeyi yanıp söndürmek veya bildirim göstermek gibi. Bu ayar Claude Code'da değil, terminalin kendisindedir. Mac, Windows ve Linux'taki çoğu terminalin tercihlerinde bir "bell" veya "alert" bölümü bulunur.

02Tüm preferredNotifChannel değerleri

Bu ayar herhangi bir settings dosyasına eklenebilir: kullanıcı (~/.claude/settings.json), proje (.claude/settings.json) veya yerel (.claude/settings.local.json). Eski sürümler bu ayarı ~/.claude.json içinde tutuyordu ve Claude Code orada kalan bir değeri hâlâ okur.

03Yerleşik bildirim ne zaman tetiklenir

Anthropic'in dokümantasyonuna göre yerleşik uyarı, Notification hook'u ile aynı zamanlamayı kullanır. Bir terminal oturumunda:

• İzin prompt'u: prompt hiçbir tuşa basılmadan yaklaşık altı saniye bekledikten sonra. Bastığınız her tuş bekleme süresini sıfırlar.
• Tamamlandı: Claude durduktan yaklaşık 60 saniye sonra; yalnızca o zamandan beri bir şey yazmadıysanız ve çalışmaya devam eden bir arka plan agent'ı yoksa.

Yani yerleşik "tamamlandı" uyarısı bilinçli olarak anında gelmez. Siz izlerken sizi rahatsız etmek için değil, başından ayrıldığınızda size ulaşmak için tasarlanmıştır. Bir tur biter bitmez uyarı almak istiyorsanız bunun yerine bir Stop hook'u kullanın (bkz. Stop hook rehberi).

04Terminal terminal

iTerm2 (macOS)

iTerm2 varsayılan olarak masaüstü bildirimi alır, ancak iTerm2 bunu yalnızca siz izin verdikten sonra gösterir:

1. Settings > Profiles > Terminal bölümünü açın.
2. Notification Center Alerts seçeneğini işaretleyin.
3. Filter Alerts'a tıklayın ve Send escape sequence-generated alerts seçeneğini etkinleştirin.

Ayrıca System Settings > Notifications altında iTerm2'nin bildirim göstermesine izin verildiğini kontrol edin.

Apple Terminal (macOS)

Apple Terminal masaüstü bildirimi almaz. "auto" ile Claude Code, yalnızca öndeki pencerenin profilinde Audible bell kapalıysa sessiz bir zil gönderir. Profilde Visual bell veya Dock zıplatma seçeneği açıksa, zil pencerenin yanıp sönmesi ya da Terminal arka plandayken Dock simgesinin zıplaması olarak görünür.

Bir ayrıntıya dikkat edin. Claude Code'un ilk çalıştırmadaki terminal kurulum prompt'unu kabul ettiyseniz, Apple Terminal profilinizde sesli zili kapatan /terminal-setup çalıştırılmıştır. Ses duymak için "terminal_bell" değerini ayarlayın ve Settings > Profiles > Advanced altında Audible bell'i yeniden açın.

Ghostty ve Kitty (macOS ve Linux)

İkisi de herhangi bir kurulum gerektirmeden masaüstü bildirimi alır ve bunu işletim sisteminizin bildirim merkezine iletir.

Diğer her şey

Windows Terminal, GNOME Terminal, Konsole, Alacritty, WezTerm, Warp ve IDE terminalleri varsayılan olarak hiçbir bildirim almaz. "terminal_bell" değerini ayarlayıp terminalin kendi zil ayarını açın ya da bir hook kullanın. IDE terminallerinin kendine özgü tuhaflıkları var; bunlar VS Code, Cursor ve JetBrains rehberinde ele alınıyor.

05SSH üzerinden ve tmux içinde

Masaüstü bildirimi, kendi bilgisayarınızdaki terminalin yorumladığı bir escape dizisidir; bu yüzden Claude Code SSH üzerinden uzak bir sunucuda çalışırken bile size ulaşır. Ghostty ve Kitty bunu ek ayar gerektirmeden iletir. iTerm2 için yukarıdaki uyarı ayarları gerekir.

tmux içinde, passthrough'a izin vermediğiniz sürece bu dizi yutulur. Şunu ~/.tmux.conf dosyasına ekleyin ve tmux source-file ~/.tmux.conf komutunu çalıştırın:

set -g allow-passthrough on

Detached oturumlar ise ayrı bir sorun: bağlı bir terminal yoksa uyarıyı gösterecek bir şey de yoktur. tmux rehberine ve SSH üzerinden bildirimler sayfasına bakın.

06Yerleşik uyarı ve hook'ları birlikte kullanmak

Notification hook'ları yerleşik uyarının yerine geçmez, onunla birlikte çalışır. Anthropic'in dokümantasyonu, hook'ların "notifications_disabled" ayarlıyken bile tetiklendiğini açıkça belirtir: bu ayar hook'unuzun çalışıp çalışmayacağını değil, yalnızca Claude Code'un sizi nasıl uyaracağını değiştirir. Böylece net bir ayrım elde edersiniz:

• Masa başındaki uyarı için "auto" veya "terminal_bell" kullanmaya devam edin.
• Geri kalan her şey için bir hook ekleyin: sistem sesi, bildirim almayan bir terminalde masaüstü bildirimi ya da ntfy ile telefonunuza push gibi.
• Bir hook zaten masaüstü bildirimi gösteriyorsa, iki bildirim görmemek için "notifications_disabled" ayarlayın.

Örneğin bu, macOS'ta Claude ilginizi beklediğinde, hangi terminalde olursa olsun bir ses çalar:

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

Linux ve Windows karşılıkları Linux rehberinde ve Windows rehberinde yer alıyor.

07Yerleşik seçeneklerin sınırları

• Bilgisayarın başında kalır. Zil ya da bildirim ekranınızdaki terminalden gelir. Mutfağa gittiğinizde kaçırırsınız.
• Terminale bağlıdır. Birçok popüler terminal, bir ayarı değiştirene kadar hiçbir şey almaz.
• Yanıt veremezsiniz. Size yalnızca Claude'un beklediğini söyler; yine de klavyenin başına dönmeniz gerekir.

Anthropic'in Remote Control özelliği, Claude mobil uygulamasıyla birlikte, telefona push almanın resmi yoludur. Karşılaştırma rehberi bunu diğer seçeneklerle yan yana ele alıyor.

08Claude Code Notifier'ın yeri

Masanızda çalışıyorsanız, yerleşik uyarı ve "terminal_bell" ihtiyacınız olan her şey olabilir. Claude Code Notifier ise masada olmadığınız zamanlar içindir. Komut satırı aracı ccn, bir Claude Code hook'u olarak çalışır; bu sayede zil ayarlarından bağımsız olarak Mac, Windows ve Linux'taki her terminalde çalışır. Tek başına, Claude işini bitirdiğinde, izin istediğinde veya soru sorduğunda masaüstü bildirimi gösterir. Bir telefon eşlediğinizde izinleri telefondan onaylayabilir veya reddedebilir, Claude'un sorularını yanıtlayabilir ve sonraki talimatı gönderebilirsiniz; son 30 saniye içinde yazı yazdıysanız telefonda hiçbir şey beklemez. ccn sayfasına bakın.

09SSS