ntfy ile Claude Code push bildirimleri (kendin yap)

01Adım 1: bir topic seçin ve abone olun

ntfy kayıt gerektirmez. Bir topic, biri ona ilk kez mesaj yayınladığında veya abone olduğunda oluşturulur ve adını bilen herkes onu okuyabilir. ntfy'nin kendi dokümantasyonu topic'in aslında bir parola gibi olduğunu söyler; bu yüzden uzun ve rastgele bir ad seçin, örneğin claude-7f3k9q2xw4mz. Topic adlarında harf, rakam, alt çizgi ve tire kullanılabilir; en fazla 64 karakter olabilir.

ntfy uygulamasını kurun (App Store, Google Play veya F-Droid), + simgesine dokunun ve ntfy.sh üzerindeki topic'inize abone olun.

Terminalden çalıştığını kontrol edin:

curl -H "Title: Test" -d "Hello from my computer" https://ntfy.sh/claude-7f3k9q2xw4mz

Telefon bir iki saniye içinde titremelidir. Windows tarafında curl.exe, Windows 10 ve 11 ile birlikte gelir ve aynı komutu kabul eder.

02Adım 2: hook script'i (Mac ve Linux)

Claude Code her hook'a standart girdi üzerinden bir JSON nesnesi iletir. Her iki olay da cwd ve hook_event_name gibi alanları paylaşır. Notification, message ve notification_type alanlarını; Stop ise Claude'un son yanıtının metni olan last_assistant_message alanını ekler. Bu script her ikisini de okunabilir bir push bildirimine dönüştürür. jq gerektirir (brew install jq veya Debian ve Ubuntu'da apt install jq).

Bunu ~/.claude/ntfy-notify.sh olarak kaydedin ve chmod +x ~/.claude/ntfy-notify.sh komutunu çalıştırın:

#!/bin/sh
TOPIC_URL="https://ntfy.sh/claude-7f3k9q2xw4mz"

input=$(cat)
event=$(printf '%s' "$input" | jq -r '.hook_event_name')
project=$(basename "$(printf '%s' "$input" | jq -r '.cwd')")

if [ "$event" = "Stop" ]; then
  title="Claude finished: $project"
  body=$(printf '%s' "$input" | jq -r '(.last_assistant_message // "Done") | .[0:300]')
  priority=3
else
  title="Claude needs you: $project"
  body=$(printf '%s' "$input" | jq -r '.message // "Needs your attention"')
  priority=4
fi

curl -s -H "Title: $title" -H "Priority: $priority" -H "Tags: robot" \
  -d "$body" "$TOPIC_URL" > /dev/null
exit 0

Öncelik 1 (min) ile 5 (urgent) arasındadır. Tags bildirime bir emoji ekler; robot bir robot yüzü gösterir.

03Adım 3: settings.json dosyasına bağlayın

Hook'ları ~/.claude/settings.json dosyasına ekleyin. Dosyada zaten bir hooks nesnesi varsa, onu değiştirmek yerine bu olayları içine ekleyin.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          { "type": "command", "command": "~/.claude/ntfy-notify.sh" }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/ntfy-notify.sh", "async": true }
        ]
      }
    ]
  }
}

"async": true, Stop hook'unun arka planda göndermesini sağlar; böylece yavaş bir ağ Claude'u asla geciktirmez. Hook'lar oturum başlarken yüklendiği için yeni bir Claude Code oturumu başlatın.

Stop mu, idle_prompt mu?

Stop, Claude işini bitirdiği anda tetiklenir; klavyenin başında olsanız bile. Bu size fazla geliyorsa Stop bloğunu kaldırın ve bunun yerine permission_prompt|idle_prompt matcher'ını kullanın. Anthropic'in dokümantasyonuna göre idle_prompt, Claude bitirdikten yaklaşık 60 saniye sonra ve yalnızca o süre içinde bir şey yazmadıysanız tetiklenir; permission_prompt ise bir izin istemi tuşa basılmadan yaklaşık altı saniye beklediğinde tetiklenir. Bu da size bedavaya kabaca bir "yalnızca başında değilken" filtresi sağlar. Notification hook rehberi ve Stop hook rehberi tüm alanları ve zamanlamaları ele alır.

04Windows (PowerShell)

Windows üzerinde bunu %USERPROFILE%\.claude\ntfy-notify.ps1 olarak kaydedin. Ek bir kurulum gerektirmez:

$in = [Console]::In.ReadToEnd() | ConvertFrom-Json
$project = Split-Path $in.cwd -Leaf

if ($in.hook_event_name -eq 'Stop') {
  $title = "Claude finished: $project"
  $body = [string]$in.last_assistant_message
  if ($body.Length -gt 300) { $body = $body.Substring(0, 300) }
  $priority = '3'
} else {
  $title = "Claude needs you: $project"
  $body = [string]$in.message
  $priority = '4'
}

Invoke-RestMethod -Method Post -Uri 'https://ntfy.sh/claude-7f3k9q2xw4mz' `
  -Headers @{ Title = $title; Priority = $priority } `
  -Body ([Text.Encoding]::UTF8.GetBytes($body)) | Out-Null

Ardından yukarıdaki command satırlarının yerine şu hook girdisini kullanın:

{
  "type": "command",
  "shell": "powershell",
  "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$HOME\\.claude\\ntfy-notify.ps1\""
}

Claude Code'u WSL içinde çalıştırıyorsanız Mac ve Linux script'ini kullanın; hook açısından WSL bir Linux'tur.

05Gizliliği korumak

Push bildirimindeki her şey ntfy sunucusundan geçer ve ntfy.sh üzerinde topic adını bilen herkes onu okuyabilir. Yukarıdaki Stop mesajı, kod veya dosya adları içerebilen Claude yanıtının başını içerir. Bunu sıkılaştırmanın üç yolu var:

1. Daha az gönderin. Stop gövdesini "Done" gibi sabit bir metinle değiştirin ve başlıkta yalnızca proje adını bırakın.
2. Erişim token'ı kullanın. ntfy, her yayında -H "Authorization: Bearer tk_..." başlığını kabul eder. Kendi sunucunuzda auth-default-access: "deny-all" ayarlayın, ntfy user add ile bir kullanıcı ve ntfy token add ile bir token oluşturun.
3. Kendi sunucunuzu barındırın. ntfy self-host edilebilir. iPhone uygulamasına anında teslimat için ntfy dokümantasyonu upstream-base-url: "https://ntfy.sh" ayarlanmasını önerir; bu ayar telefonu uyandırabilmesi için ntfy.sh'a yalnızca bir mesaj kimliği ve topic hash'i iletir, uygulama da mesajı ardından sizin sunucunuzdan çeker.

Claude Code uzak bir sunucuda çalışıyorsa aynı hook orada da değişiklik yapmadan çalışır; bu da ntfy'yi SSH üzerinden bildirimler için iyi bir seçenek yapar.

06Claude Code Notifier'ın yeri

Tek yönlü uyarılar için yukarıdaki kurulum eksiksiz bir çözümdür ve sizi bundan vazgeçirmeye çalışmayız. Ancak yalnızca haber vermekle kalır. Push bildirimi Claude'un izne ihtiyaç duyduğunu söylediğinde, oturum siz klavyeye dönene kadar beklemeye devam eder.

ntfy, HTTP isteği gönderen aksiyon butonlarını destekler; dolayısıyla bir yanıt yolunu kendiniz kurabilirsiniz: isteği yayınlayan, ikinci bir topic'te yanıt bekleyen ve bir karar döndüren bir PermissionRequest hook'u. Bazı açık kaynak projeler tam olarak bunu yapıyor (karşılaştırmaya bakın).

Claude Code Notifier bu yolu hazır olarak sunar. Eşleştirilmiş bir telefonla bir izne bir kez izin verebilir, oturum boyunca izin verebilir veya reddedebilir, Claude bir soru sorduğunda yanıt seçebilir ve Claude bitirdikten sonra bir sonraki talimatı gönderebilirsiniz; hepsi telefondan. Ayrıca başında olup olmadığınızı da kontrol eder: son 30 saniye içinde bir şey yazdıysanız terminal her zamanki gibi sorar ve telefonda hiçbir şey beklemez. Başında değilseniz terminal, belirlediğiniz üst sınıra kadar yanıtınızı bekler ve klavyeye dokunduğunuz anda beklemeyi bırakır. ccn Mac, Windows ve Linux üzerinde çalışır; telefon uygulamaları için ccn sayfasına ve fiyatlandırmaya göz atın.

07SSS