Notifiche da Claude Code su un server remoto via SSH

01Perché i comandi di notifica locali non fanno nulla via SSH

Un hook è un comando che Claude Code esegue sulla macchina dove Claude Code è in esecuzione. Su un server raggiunto via SSH, quella macchina è il server. Lì notify-send ha bisogno di un demone delle notifiche desktop, che, come fa notare la guida agli hook di Anthropic, i server headless e le sessioni SSH non hanno. osascript e i toast di PowerShell proprio non ci sono.

Quindi la domanda non è "quale comando di notifica", ma "come arriva un segnale dal server a me". Ci sono tre modi:

02Strada 1: notifiche attraverso il terminale SSH

La notifica di Claude Code è una escape sequence scritta nel terminale. La guida al terminale di Anthropic spiega che arriva alla tua macchina locale via SSH, quindi anche una sessione remota può avvisarti. Ghostty e Kitty la passano al centro notifiche del desktop senza configurazione. iTerm2 lo fa dopo averlo abilitato: Settings > Profiles > Terminal, spunta Notification Center Alerts, poi in Filter Alerts attiva Send escape sequence-generated alerts.

Se il tuo terminale non è tra questi, o vuoi un testo personalizzato, un hook può restituire una escape sequence che Claude Code scriverà. Gli hook non hanno un terminale proprio, quindi la restituisci in un campo terminalSequence. Salva questo sul server come ~/.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}'

Poi aggiungilo a ~/.claude/settings.json sul server:

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

Esegui chmod +x ~/.claude/hooks/notify-ssh.sh e installa jq sul server. La documentazione di Anthropic elenca le sequenze accettate: OSC 9 (iTerm2, ConEmu, Windows Terminal, WezTerm), OSC 99 (Kitty), OSC 777 (urxvt, Ghostty, Warp) e un semplice bell. Claude Code scrive la sequenza solo in una sessione interattiva mentre la sua interfaccia è a schermo.

I limiti sono intrinseci. Se la connessione SSH cade, il portatile va in sospensione o chiudi la scheda, non arriva nulla. Se usi Claude Code in tmux, aggiungi set -g allow-passthrough on a ~/.tmux.conf sul server; la guida a tmux spiega questo e le sessioni detached.

03Strada 2: una push dal server

Una push non dipende dal terminale, quindi è la scelta giusta per i job lunghi. L'hook fa una richiesta HTTPS dal server e un servizio la recapita al telefono o in chat. La guida a ntfy e la guida a Telegram, Slack e Discord contengono hook funzionanti. Ti dicono che è successo qualcosa, ma non possono approvare un comando né rispondere a una domanda, quindi Claude resta in attesa finché non ti riconnetti.

04Strada 3: Claude Code Notifier sul server

Claude Code Notifier è uno strumento indipendente (creato da TouchTap, non da Anthropic). Il suo tool da riga di comando gratuito, ccn, gira su Mac, Windows e Linux, quindi lo installi sul server, dove gira Claude Code:

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

Aggiunge le sue voci hook al file ~/.claude/settings.json del server, lascia intatto il resto e crea un backup. Le notifiche desktop di ccn compaiono sulla macchina dove gira ccn, che su un server headless significa da nessuna parte. La strada utile è il telefono: le notifiche sul telefono passano dal relay server cifrato di TouchTap, non dalla connessione SSH, quindi funzionano da qualsiasi macchina su cui gira ccn, purché raggiunga internet.

Abbinamento via SSH

Per l'abbinamento non serve un browser sul server. Puoi eseguire ccn pair nella sessione SSH: stampa nel terminale un codice QR da inquadrare con la fotocamera del telefono e un link valido per 24 ore. Oppure apri l'app sul telefono, vai su Computers > Add a computer ed esegui la riga mostrata, che installa e abbina in un solo passaggio:

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

(Il codice a sei cifre è un esempio; usa quello mostrato dalla tua app.) Un telefono può avere più computer, quindi sia un portatile sia un server possono inviargli notifiche. Per i dettagli vedi la guida all'abbinamento.

Cosa puoi fare dal telefono

Una volta associato il telefono, ricevi una push quando Claude finisce, chiede un permesso o fa una domanda. Puoi consentire una volta, consentire per la sessione o negare un permesso, scegliere una risposta alla domanda di Claude e inviare l'istruzione successiva quando Claude ha finito. Se non sei al computer, il terminale aspetta la risposta dal telefono fino a un limite che scegli tu, e smette di aspettare appena digiti sulla tastiera. Esegui ccn doctor sul server per controllare gli hook, le credenziali e la connessione al relay. Consulta i prezzi per le app per telefono; lo strumento da riga di comando è gratuito.

05Mantieni attivo Claude Code quando cade la connessione SSH

Tutte e tre le soluzioni richiedono che Claude Code resti in esecuzione. Se avvii claude direttamente dalla shell SSH e la connessione cade, la sessione termina con lei. Avvialo dentro tmux o GNU screen così sopravvive alla disconnessione, e poi ricollegati più tardi. Gli hook continuano a scattare anche in una sessione detached, ed è proprio lì che una push sul telefono si rivela utile. La guida a tmux e allontanarsi durante i task lunghi spiegano questo flusso di lavoro.

06FAQ