Come ricevere un avviso quando Claude Code o Codex finisce
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
afplayper un suono o aosascriptper una notifica. - Codex: aggiungi una riga
notifya~/.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
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:
- iTerm2 → Settings → Profiles → Terminal.
- Seleziona Notification Center Alerts.
- 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.
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.jsonblocca tutti gli hook. Incollalo in un qualsiasi validatore JSON. - Prova il comando da solo. Esegui
afplay /System/Library/Sounds/Glass.aiffnel 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.jsone un altro nel.claude/settings.jsondel 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.
Altre guide
- Mac acceso a coperchio chiusoModalità clamshell, caffeinate, pmset e app, e cosa fa davvero ognuno.
- Suoni di tastiera e clic su MacCome funzionano, il permesso che serve, le app e le soluzioni.
- Mostrare i clic su MacL’opzione integrata, gli editor e un’onda dal vivo con suono.
- Suono di clic su MacNessuna impostazione integrata: come aggiungerlo, e il permesso che serve.
- Migliori app di suoni per tastiera17 app gratuite e a pagamento fianco a fianco, e quale fa per te.
- Suoni della tastiera per concentrarsiSuoni di digitazione morbidi per studiare, scrivere e programmare, nelle tue cuffie.
- I suoni della tastiera spiegatiCosa vogliono dire thock, cremoso, clacky e poppy, e come suona ciascuno.
- App accoglienti per MacGiochi idle, suoni ambientali, animaletti e clic morbidi che girano mentre lavori.
- Migliori app per evidenziare il cursoreFari, onde di clic e suoni di clic per demo, chiamate e registrazioni.
- I suoni della tastiera non funzionanoMonitoraggio dell’input, Secure Input, il dispositivo di uscita e le impostazioni di silenzio.
- Gobbo su MacLeggi il copione sotto la fotocamera e tienilo fuori dalla registrazione.
- Mostrare i clic e registrarne il suonoMetti l’onda e il suono dei clic in qualsiasi registrazione dello schermo del Mac.
- Test di digitazione con suoni della tastieraUn test di digitazione di 30 secondi che puoi sentire, direttamente nel browser.
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.