MacPipLa tua prossima app per Mac è qui.macpip.com →

Come ricevere un avviso quando Claude Code o Codex finisce

Aggiornato il 22 ottobre 2026

Avvii un compito lungo in Claude Code o Codex, passi ad altro e torni dieci minuti dopo: si era fermato dopo due minuti, in attesa di un sì. Un suono o una notifica quando l’agente finisce o ha bisogno del tuo OK risolve il problema.

Entrambi gli strumenti possono farlo gratis, in modo integrato o con una o due righe di configurazione. Questa guida illustra ogni metodo, passo per passo.

In breve

  • Claude Code può già avvisarti in Ghostty, Kitty e iTerm2 (iTerm2 richiede un’impostazione). Negli altri terminali, aggiungi un hook.
  • Un hook di Claude Code su Stop scatta quando finisce; uno su Notification scatta quando ha bisogno di te. Collega l’uno o l’altro ad afplay per un suono o a osascript per una notifica.
  • Codex: aggiungi una riga notify a ~/.codex/config.toml, oppure attiva le sue notifiche integrate nel terminale.
  • Non succede nulla? Riavvia la sessione: gli hook vengono letti all’avvio di una sessione.

Come gli agenti ti dicono che hanno finito

Claude Code o Codexfinisce, o ha bisogno di te
Hook / notifyesegue il tuo comando
Lo sentisuono · banner · campanella
Tutti i metodi di questa pagina funzionano allo stesso modo: l’agente esegue un comando al momento giusto.

Entrambi gli strumenti possono eseguire un tuo comando al momento giusto. Una notifica è tutta qui: Claude Code lo chiama hook, Codex lo chiama notify. Qualunque cosa faccia il comando (suonare, mostrare un banner, far lampeggiare lo schermo) avviene quando l’agente si ferma o chiede un input.

Un Mac più piacevole mentre il tuo agente lavora

Clacky rende più piacevole il Mac stesso mentre gli agenti lavorano: suoni di clic e di tastiera, e un registratore dello schermo quando vuoi mostrare cosa ha costruito l’agente. $4.99 una volta sola per 1 Mac.

Claude Code: la notifica integrata

Quando Claude Code finisce, o aspetta una richiesta di permesso, può inviare da solo una notifica sul desktop. Secondo la documentazione di Anthropic funziona subito in Ghostty e Kitty. In iTerm2, attivala una volta:

  1. iTerm2 → Settings → Profiles → Terminal.
  2. Seleziona Notification Center Alerts.
  3. Fai clic su Filter Alerts e attiva Send escape sequence-generated alerts.

Usi Claude Code dentro tmux? Aggiungi set -g allow-passthrough on a ~/.tmux.conf, altrimenti la notifica non arriva mai al terminale. Puoi anche scegliere come Claude Code ti avvisa (per esempio con il campanello del terminale) nelle sue impostazioni /config.

Fonte: documentazione di Claude Code: configurazione del terminale

Claude Code: un hook che riproduce un suono

Nel Terminale di Apple, in VS Code o in qualsiasi altro terminale, ci pensa un hook. Gli hook stanno in ~/.claude/settings.json (per tutti i progetti) o in .claude/settings.json (per un solo progetto). Contano due eventi:

  • Stop: Claude ha finito la risposta.
  • Notification: Claude ha bisogno di te (una richiesta di permesso, o sta aspettando un tuo input).

Questo riproduce un suono di macOS per entrambi. Uniscilo al tuo file di impostazioni (tieni quello che c’è già):

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

Preferisci un banner? Usa invece questo comando (lo stesso dell’esempio di Anthropic):

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

Scrivi /hooks in Claude Code per vedere cosa è configurato. I nuovi hook valgono per le sessioni che avvii dopo aver salvato. I suoni in /System/Library/Sounds/ sono liberi da usare: Glass, Ping, Pop, Purr, Submarine e altri.

Fonti: riferimento degli hook · guida agli hook

Codex: l’impostazione notify

La CLI di Codex esegue un tuo programma dopo ogni turno, impostato con notify in ~/.codex/config.toml. Codex aggiunge come ultimo argomento una descrizione JSON del turno (il suo type è agent-turn-complete), che un semplice comando audio può ignorare:

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify è una chiave di primo livello: mettila sopra qualsiasi [section] del file. Codex ha anche notifiche integrate nella sua interfaccia da terminale (notifications sotto [tui]) che usano la notifica o il campanello del terminale stesso; se vedi un banner dipende dal tuo terminale.

Il notify di Codex scatta quando un turno è completato. Non ha un evento separato per “serve la tua approvazione” come l’hook Notification di Claude Code.

Fonte: documentazione di Codex: configurazione avanzata

Se non succede nulla

  • Riavvia la sessione. Gli hook vengono letti all’avvio di una sessione, quindi una già in corso non ti avviserà.
  • Controlla che il file sia valido. Una virgola mancante in settings.json blocca tutti gli hook. Incollalo in un qualsiasi validatore JSON.
  • Prova il comando da solo. Esegui afplay /System/Library/Sounds/Glass.aiff nel Terminale. Nessun suono? Controlla il dispositivo di uscita e il volume.
  • I banner non compaiono? Controlla Impostazioni di Sistema → Notifiche per il tuo terminale (o per Script Editor, se usi osascript) e le modalità Full immersion.
  • Due suoni insieme? Hai due configurazioni (per esempio un hook in ~/.claude/settings.json e un altro nel .claude/settings.json del progetto). Tienine una.

Domande

Claude Code ha un suono di notifica integrato?

Può inviare da solo una notifica sul desktop in Ghostty, Kitty e iTerm2 (in iTerm2 va attivato Send escape sequence-generated alerts). Per un suono in qualsiasi terminale, aggiungi un hook Stop o Notification che esegue afplay.

Che differenza c’è tra gli hook Stop e Notification?

Stop si attiva quando Claude finisce di rispondere. Notification si attiva quando Claude ha bisogno di te: una richiesta di permesso, o sta aspettando un tuo input. Quasi tutti vogliono entrambi, con suoni diversi.

Codex può dirmi quando serve la mia approvazione?

Il programma notify di Codex si attiva quando un turno è completato (agent-turn-complete). Oggi non c’è un evento separato per l’approvazione, quindi lo senti a fine turno.

Non conosci Clacky? È un’app accogliente per la barra dei menu del Mac, con suoni di clic e di tastiera, un registratore dello schermo, screenshot e un piccolo porto che cresce mentre lavori. Vedi tutti gli strumenti · Ascolta i suoni nel browser

Verificato il 22 ottobre 2026. È cambiato qualcosa o c’è un errore? Scrivi a hello@clacky.app.