Come ricevere un avviso quando Claude Code o Codex finisce

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.

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

Avvisi agenti di Clacky: lo stesso, senza configurazione

Se preferisci non toccare JSON e TOML, Clacky (un’app per la barra dei menu del Mac) ha gli Avvisi agenti. Usano gli stessi hook visti sopra, quindi niente osserva il tuo schermo o legge il tuo terminale:

1. Apri la dashboard di Clacky → Avvisi agenti.
2. Accanto a Claude Code o Codex, fai clic su Configura…. Clacky ti mostra esattamente le righe che aggiungerà; fai clic su Aggiungi hook. Tiene una copia di backup del tuo file lì accanto (settings.json.clacky-backup).
3. Fai clic su Invia un avviso di prova per sentire entrambi i suoni.

Cosa ottieni:

• Un suono diverso per fatto (un accordo che sale) e ha bisogno di te (due tocchi e una domanda), con cinque voci tra cui scegliere per ogni agente.
• Un leggero bagliore sul bordo dello schermo, facoltativo, per circa un secondo. Non intercetta i clic e non compare mai nelle registrazioni.
• In silenzio se è in primo piano (muto mentre il terminale dell’agente è l’app attiva) e Silenzio durante le chiamate (muto mentre il microfono è in uso), entrambi attivi di default.
• Un pallino per sessione nella barra dei menu: al lavoro, in attesa o fatto. Fai clic su uno per portare in primo piano il suo terminale.
• Mantieni attivo → Finché il mio agente non ha finito, così un’esecuzione lunga non si ferma perché il Mac è andato in stop.

Claude Code funziona in qualsiasi terminale e nella scheda Code dell’app Claude. Codex funziona con la CLI e riceve il suono fatto (Codex non invia alcun evento “ha bisogno di te”). Se la tua configurazione di Codex ha già una riga notify, Clacky la lascia stare e te lo dice, invece di sostituirla. Rimuovi… toglie solo le righe di Clacky.

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 il tuo hook e quello di Clacky). Tienine una.