Powiadomienia z Claude Code na zdalnym serwerze przez SSH

01Dlaczego lokalne polecenia powiadomień nic nie robią przez SSH

Hook to polecenie, które Claude Code uruchamia na maszynie, na której Claude Code działa. Na serwerze, do którego łączysz się przez SSH, jest to właśnie serwer. notify-send potrzebuje tam demona powiadomień, którego – jak zauważa poradnik o hookach od Anthropic – serwery bez GUI i sesje SSH nie mają. osascript i toasty PowerShell w ogóle tam nie istnieją.

Pytanie brzmi więc nie „jakie polecenie powiadomień”, tylko „jak sygnał ma dotrzeć z serwera do mnie”. Są trzy sposoby:

02Droga 1: powiadomienia przez terminal SSH

Własne powiadomienie Claude Code to sekwencja escape wypisywana do terminala. Poradnik o terminalu od Anthropic mówi, że dociera ona do twojej lokalnej maszyny przez SSH, więc zdalna sesja nadal może cię zaalarmować. Ghostty i Kitty przekazują ją do centrum powiadomień bez żadnej konfiguracji. iTerm2 też, po włączeniu: Settings > Profiles > Terminal, zaznacz Notification Center Alerts, a potem w Filter Alerts włącz Send escape sequence-generated alerts.

Jeśli twój terminal nie jest żadnym z nich albo chcesz własny tekst, hook może zwrócić sekwencję escape, którą Claude Code wypisze. Hooki nie mają własnego terminala, więc zwracasz ją w polu terminalSequence. Zapisz to na serwerze jako ~/.claude/hooks/notify-ssh.sh:

#!/bin/bash
body=$(jq -r '.message // "Claude Code needs your attention"')
# OSC 9 for iTerm2, WezTerm and ConEmu; use '\033]777;notify;%s;%s\007' for Ghostty
seq=$(printf '\033]9;%s\007' "$body")
jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

Następnie dodaj go do ~/.claude/settings.json na serwerze:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/notify-ssh.sh" }
        ]
      }
    ]
  }
}

Uruchom chmod +x ~/.claude/hooks/notify-ssh.sh i zainstaluj jq na serwerze. Dokumentacja Anthropic wymienia akceptowane sekwencje: OSC 9 (iTerm2, ConEmu, Windows Terminal, WezTerm), OSC 99 (Kitty), OSC 777 (urxvt, Ghostty, Warp) i zwykły dzwonek. Claude Code wypisuje sekwencję tylko w sesji interaktywnej, gdy jego interfejs jest na ekranie.

Ograniczenia są wbudowane. Jeśli połączenie SSH padnie, laptop się uśpi albo zamkniesz kartę, nic nie dotrze. Jeśli uruchamiasz Claude Code w tmux, dodaj set -g allow-passthrough on do ~/.tmux.conf na serwerze; poradnik o tmux opisuje to oraz odłączone sesje.

03Droga 2: push z serwera

Push nie zależy od terminala, więc to dobry wybór przy długich zadaniach. Hook wysyła z serwera żądanie HTTPS, a usługa dostarcza je na telefon lub czat. Poradnik o ntfy i poradnik o Telegram, Slack i Discord zawierają działające hooki. Informują, że coś się stało. Nie zatwierdzą polecenia ani nie odpowiedzą na pytanie, więc Claude nadal czeka, aż się ponownie połączysz.

04Droga 3: Claude Code Notifier na serwerze

Claude Code Notifier to niezależne narzędzie (od TouchTap, nie od Anthropic). Jego darmowe narzędzie CLI, ccn, działa na Macu, Windows i Linux, więc instalujesz je na serwerze, tam gdzie działa Claude Code:

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

Dodaje swoje wpisy hooków do ~/.claude/settings.json na serwerze, zostawia resztę i robi kopię zapasową. Powiadomienia na pulpicie od ccn pojawiają się na maszynie, na której działa ccn, czyli na serwerze bez GUI – nigdzie przydatnym. Przydatny jest telefon: powiadomienia na telefon idą przez szyfrowany serwer relay TouchTap, a nie przez połączenie SSH, więc działają z każdej maszyny z ccn, która ma dostęp do internetu.

Parowanie przez SSH

Parowanie nie wymaga przeglądarki na serwerze. Możesz uruchomić ccn pair w sesji SSH; wyświetli w terminalu kod QR do zeskanowania aparatem telefonu oraz link ważny 24 godziny. Albo otwórz aplikację na telefonie, przejdź do Computers > Add a computer i uruchom pokazaną linię, która instaluje i paruje w jednym kroku:

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

(Sześciocyfrowy kod to przykład; użyj tego z aplikacji.) Jeden telefon może mieć kilka komputerów, więc laptop i serwer mogą raportować do niego jednocześnie. Szczegóły znajdziesz w poradniku o parowaniu.

Co możesz zrobić z telefonu

Po sparowaniu dostajesz push, gdy Claude skończy, potrzebuje uprawnienia albo zadaje pytanie. Możesz zezwolić raz, zezwolić na całą sesję albo odmówić, wybrać odpowiedź na pytanie Claude i wysłać kolejne polecenie, gdy Claude skończy. Jeśli cię nie ma, terminal czeka na odpowiedź z telefonu do wybranego przez ciebie limitu i przestaje czekać, gdy tylko zaczniesz pisać na klawiaturze. Uruchom ccn doctor na serwerze, żeby sprawdzić hooki, dane uwierzytelniające i połączenie z relayem. Ceny aplikacji na telefon znajdziesz w cenniku; narzędzie wiersza poleceń jest darmowe.

05Jak utrzymać Claude Code przy życiu, gdy SSH się rozłączy

Wszystkie trzy sposoby wymagają, żeby sam Claude Code dalej działał. Jeśli uruchomisz claude bezpośrednio z powłoki SSH i połączenie zerwie się, sesja kończy się razem z nim. Uruchamiaj go w tmux albo GNU screen, żeby przetrwał rozłączenie, a potem podłącz się ponownie. Hooki działają dalej w odłączonej sesji i właśnie wtedy push na telefon jest najbardziej przydatny. Ten workflow opisują poradnik o tmux i odchodzenie od długich zadań.

06FAQ