Notifiche quando un agente di programmazione finisce o chiede un’approvazione

Per ricevere una notifica quando un agente di programmazione finisce o chiede un’approvazione, attiva i suoi avvisi integrati oppure aggiungi un hook che si attiva con quegli eventi. Se ti allontani dal computer, invia l’avviso al telefono. Fai una prova prima di andare via, perché un agente in attesa di approvazione non fa nulla finché non rispondi.

Gli esempi di questa guida usano Claude Code. Per tenere attivo il computer c’è una guida a parte. Mono by Reunified invia questi avvisi per gli agenti che avvii tramite l’app, ma il metodo funziona con qualsiasi configurazione.

1. Scegli quali eventi dell’agente meritano un avviso

Contano tre eventi:

Se imposti un solo avviso, scegli quello per le richieste di autorizzazione.

2. Attiva gli avvisi in Claude Code

Claude Code invia una notifica quando finisce o si ferma in attesa di un’autorizzazione e sembra che tu non sia al computer. Per impostazione predefinita mostra le notifiche desktop solo in Ghostty, Kitty e iTerm2 (configurazione del terminale). Negli altri terminali, imposta preferredNotifChannel su "terminal_bell" in ~/.claude/settings.json per far suonare il campanello del terminale. In tmux, aggiungi set -g allow-passthrough on a ~/.tmux.conf e ricarica la configurazione.

Per un suono o un comando tuo, aggiungi degli hook nello stesso file. L’evento Notification accetta dei matcher come permission_prompt (un’approvazione è in attesa da circa sei secondi) e idle_prompt (Claude ha finito circa un minuto fa e da allora non hai scritto nulla). Su un Mac, questa configurazione riproduce un suono diverso per ciascuno:

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

La guida agli hook contiene anche i comandi per le notifiche desktop su macOS, Linux e Windows. Gli altri agenti funzionano in modo diverso, quindi consulta la loro documentazione.

3. Invia l’avviso al telefono

Ci sono tre modi per far arrivare l’avviso al telefono:

• L’app dell’agente stesso. Con il Remote Control di Claude Code attivo, esegui /config e attiva le notifiche push quando decide Claude («Push when Claude decides»), quelle per le azioni richieste («Push when actions required») o entrambe. Servono un piano idoneo e l’app Claude collegata allo stesso account, con le notifiche consentite.
• Un hook che invia un messaggio push, per esempio con curl verso un servizio push la cui app è installata sul telefono.
• Un’app complementare che inoltra gli eventi della sessione dal computer.

Ogni metodo richiede il computer acceso, non in sospensione e online, con l’agente ancora in esecuzione. Tieni l’eventuale token dell’hook in ~/.claude/settings.json, non nel file .claude/settings.json del progetto, che può finire in un commit del repository.

4. Proteggi il testo degli avvisi sulla schermata di blocco

Chiunque si trovi vicino a un telefono bloccato può leggerne le anteprime. Non mettere segreti, contenuti di file o righe di log nei messaggi degli hook. Invia solo l’evento e il nome del progetto: per un progetto inventato chiamato «invoice-export», basta «invoice-export: serve un’approvazione». Su iPhone, apri Impostazioni > Notifiche e imposta Mostra anteprime su Quando sbloccato. Anche Android può nascondere i contenuti sensibili sulla schermata di blocco, ma il nome dell’opzione cambia da telefono a telefono.

In Mono, quando l’agente ha finito, l’avviso mostra il suo ultimo messaggio, accorciato se è lungo. Un avviso di autorizzazione mostra la richiesta come la descrive l’agente, spesso il comando.

5. Fai una prova con un compito innocuo prima di uscire

Sul computer di casa, avvia una sessione chiamata «controllo invoice-export» e chiedi all’agente di eseguire i test e di segnalare eventuali errori senza modificare file. L’agente chiede il permesso prima di eseguire un comando, quindi domanda se può lanciare npm test. Sul computer, passa a un’altra schermata o a un’altra app, poi blocca il telefono e vai in un’altra stanza.

In Mono dovresti vedere:

1. Un avviso «Richiesta di autorizzazione dell’agente» con il comando di test.
2. Se premi l’avviso, si apre quella sessione, dove scegli Consenti. Ogni richiesta successiva invia un proprio avviso.
3. «L’agente ha terminato in “controllo invoice-export”» con l’ultimo messaggio dell’agente, per esempio «Un test in dates.test.ts fallisce per i fusi orari. Non ho modificato nessun file.»

Poi avvia un secondo compito con la sessione aperta sul telefono: mentre la guardi non arriva nessun avviso. Prima di uscire, assicurati che la sessione non sia aperta sullo schermo di nessun dispositivo.

6. Risolvi i problemi degli avvisi che non arrivano

In Mono, apri Impostazioni > Notifiche e controlla «Tutte le notifiche», «Code» (sessioni terminate e fermate), «Richieste di autorizzazione» e «Invia agli altri tuoi dispositivi». Sono tutte attive per impostazione predefinita. Gli avvisi partono dal computer che esegue l’agente, quindi lascia Mono in esecuzione su quel computer.

Prima di approvare dal telefono, leggi cosa controllare in una richiesta di autorizzazione. La guida su come lavorare con gli agenti di programmazione dal telefono spiega il resto della configurazione. Mono non è ancora disponibile, ma puoi iscriverti alla lista d’attesa.