Le notifiche integrate di Claude Code: il terminal bell e preferredNotifChannel

01La soluzione rapida

Se non senti niente quando Claude termina, aggiungi questo a ~/.claude/settings.json:

{
  "preferredNotifChannel": "terminal_bell"
}

Poi assicurati che il terminale faccia qualcosa con il bell: riprodurre un suono, far rimbalzare l'icona nel Dock, far lampeggiare la scheda o mostrare una notifica. Questa impostazione sta nel terminale, non in Claude Code. Su Mac, Windows e Linux la maggior parte dei terminali ha una sezione "bell" o "avvisi" nelle preferenze.

02Tutti i valori di preferredNotifChannel

L'impostazione può stare in qualsiasi file di settings: utente (~/.claude/settings.json), progetto (.claude/settings.json) o locale (.claude/settings.local.json). Le versioni precedenti la tenevano in ~/.claude.json, e Claude Code legge ancora un valore rimasto lì.

03Quando scatta la notifica integrata

Secondo la documentazione di Anthropic, l'avviso integrato ha gli stessi tempi dell'hook Notification. In una sessione da terminale:

• Prompt di permesso: dopo che il prompt è rimasto in attesa per circa sei secondi senza che tu prema un tasto. Ogni tasto premuto fa ripartire l'attesa.
• Terminato: circa 60 secondi dopo che Claude si ferma, e solo se nel frattempo non hai digitato nulla e nessun agent in background è ancora in esecuzione.

Quindi l'avviso integrato di "terminato" non è immediato, ed è voluto. Serve a raggiungerti quando ti sei allontanato, non a disturbarti mentre guardi. Se vuoi un avviso nel momento esatto in cui un turno finisce, usa invece un hook Stop (vedi la guida allo Stop hook).

04Terminale per terminale

iTerm2 (macOS)

iTerm2 riceve una notifica desktop di default, ma iTerm2 la mostra solo dopo che l'hai consentita:

1. Apri Settings > Profiles > Terminal.
2. Spunta Notification Center Alerts.
3. Clicca Filter Alerts e attiva Send escape sequence-generated alerts.

Verifica anche che iTerm2 abbia il permesso di mostrare notifiche in Impostazioni di Sistema > Notifiche.

Apple Terminal (macOS)

Apple Terminal non riceve notifiche desktop. Con "auto", Claude Code invia un bell silenzioso solo se trova Audible bell disattivato nel profilo della finestra in primo piano. Il bell appare poi come un lampeggio della finestra, o un rimbalzo nel Dock se Terminal è in background, se nel profilo è attiva l'opzione Visual bell o quella del rimbalzo nel Dock.

Occhio a un dettaglio. Se al primo avvio hai accettato il prompt di configurazione del terminale di Claude Code, è stato eseguito /terminal-setup, che disattiva il campanello udibile nel tuo profilo di Apple Terminal. Per sentire un suono, imposta "terminal_bell" e riattiva Audible bell in Settings > Profiles > Advanced.

Ghostty e Kitty (macOS e Linux)

Entrambi ricevono una notifica desktop senza alcuna configurazione, e la inoltrano al centro notifiche del sistema operativo.

Tutto il resto

Windows Terminal, GNOME Terminal, Konsole, Alacritty, WezTerm, Warp e i terminal degli IDE di default non ricevono niente. Imposta "terminal_bell" e attiva la gestione del bell nel terminal, oppure usa un hook. I terminal degli IDE hanno le loro stranezze, spiegate nella guida a VS Code, Cursor e JetBrains.

05Via SSH e dentro tmux

La notifica desktop è una escape sequence interpretata dal terminal sul tuo computer, quindi ti arriva anche quando Claude Code gira su un server remoto via SSH. Ghostty e Kitty la inoltrano senza configurazioni extra. iTerm2 richiede le impostazioni degli avvisi viste sopra.

Dentro tmux la sequenza viene inghiottita, a meno che tu non abiliti il passthrough. Aggiungi questo a ~/.tmux.conf ed esegui tmux source-file ~/.tmux.conf:

set -g allow-passthrough on

Le sessioni detached sono un altro problema: se non c'è nessun terminal collegato, nessuno può mostrare l'avviso. Vedi la guida a tmux e le notifiche via SSH.

06Avviso integrato e hook insieme

Gli hook Notification girano insieme all'avviso integrato, non lo sostituiscono. La documentazione di Anthropic dice chiaramente che gli hook partono anche con "notifications_disabled": l'impostazione cambia solo il modo in cui Claude Code ti avvisa, non se il tuo hook viene eseguito. Così puoi dividere i compiti in modo pulito:

• Tieni "auto" o "terminal_bell" per l'avviso quando sei alla scrivania.
• Aggiungi un hook per tutto il resto, come un suono di sistema, una notifica desktop in un terminal che non ne riceve, o una push sul telefono con ntfy.
• Se un hook mostra già una notifica desktop, imposta "notifications_disabled" per non vederne due.

Per esempio, questo riproduce un suono su macOS ogni volta che Claude ha bisogno di te, in qualsiasi terminal:

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

Gli equivalenti per Linux e Windows sono nella guida a Linux e nella guida a Windows.

07Limiti delle opzioni integrate

• Resta sul computer. Il bell o la notifica arrivano dal terminal sul tuo schermo. Se vai in cucina, te li perdi.
• Dipende dal terminal. Molti terminal diffusi non ricevono niente finché non cambi un'impostazione.
• Non puoi rispondere. Ti dice che Claude è in attesa, ma devi comunque tornare alla tastiera.

Remote Control di Anthropic, con l'app mobile di Claude, è il modo ufficiale per ricevere push sul telefono. La guida al confronto lo mette a confronto con le altre opzioni.

08Dove si inserisce Claude Code Notifier

Se lavori alla scrivania, l'avviso integrato più "terminal_bell" potrebbe bastarti. Claude Code Notifier serve per quando non sei alla scrivania. Il suo tool da riga di comando, ccn, gira come hook di Claude Code, quindi funziona in qualsiasi terminal su Mac, Windows e Linux, con o senza impostazioni del bell. Da solo mostra una notifica desktop quando Claude finisce, chiede un permesso o fa una domanda. Con un telefono associato puoi consentire o negare i permessi, rispondere alle domande di Claude e inviare l'istruzione successiva dal telefono; e se hai digitato negli ultimi 30 secondi, sul telefono non arriva niente. Vedi la pagina di ccn.

09FAQ