ccn è un piccolo programma che Claude Code esegue tramite i suoi hook, su macOS, Windows o Linux. Installalo e ricevi una notifica sul desktop appena Claude finisce, ha bisogno di un'autorizzazione o fa una domanda. Abbina il telefono quando vuoi: gli stessi momenti arrivano anche come notifica push, e da lì puoi approvare, negare o rispondere. Niente resta attivo in background e funziona in qualsiasi terminale.
01Installa
macOS e Linux
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh
Windows (PowerShell)
irm https://claudecodenotifier.com/web/install.ps1 | iex
Il supporto per Windows è in beta. I pacchetti winget e Scoop sono in arrivo.
Homebrew
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn
Per chi ha Node.js
npx @touchtap/ccn pair
Ogni riga installa ccn e i suoi hook, così la prossima volta che Claude Code finisce o ha bisogno di te compare una notifica su questo computer. Non serve un telefono e niente resta in background. ccn aggiunge sette voci a ~/.claude/settings.json e lascia intatto tutto il resto del file. Hai un codice dall'app del telefono? Le righe sotto Abbina il telefono installano e abbinano in un colpo solo.
02Abbina il telefono
L'abbinamento è facoltativo e non blocca mai niente: ccn continua a notificare su questo computer, con o senza un telefono abbinato. Una volta abbinato, ogni notifica arriva anche sul telefono come push, e da lì puoi approvare, negare o rispondere. Ci sono due modi per abbinare.
Scansiona un codice QR dal terminale
ccn pair
Esegui ccn o ccn pair. Mostra un codice QR e un link validi per 24 ore: scansiona il codice con la fotocamera del telefono oppure apri il link sul telefono. Senza l'app, il link propone prima lo store; con l'app, il telefono si collega da solo. ccn pair --no-wait li mostra e termina subito, così puoi continuare a lavorare e scansionare più tardi.
Digita il codice dell'app
ccn pair 482913
Apri Claude Code Notifier sul telefono e aggiungi un computer. L'app mostra un codice a 6 cifre e la riga esatta da eseguire, con il codice già inserito. Se ccn è installato, basta ccn pair seguito dal codice. Altrimenti ogni riga di installazione accetta il codice e installa e abbina in un colpo solo:
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913npx @touchtap/ccn pair 482913Sostituisci 482913 con il codice sul tuo telefono. I codici durano 24 ore; quando scade, l'app ne genera uno nuovo.
Dopo dieci notifiche sul desktop senza un telefono abbinato, ccn aggiunge una riga che suggerisce ccn pair. ccn config set pair_nudges off la disattiva.
03Cosa ottieni
Da solo, ccn mostra una notifica su questo computer quando Claude finisce, ha bisogno di un'autorizzazione o fa una domanda. Con un telefono abbinato ottieni anche:
- Claude ha finito: una notifica push appena finisce un turno.
- Autorizzazioni: consenti una volta, consenti per la sessione o nega, dal telefono.
- Domande: scegli una risposta quando Claude ti chiede di decidere.
- Un seguito: subito dopo che Claude ha finito, invia dal telefono la prossima istruzione.
Se hai scritto negli ultimi 30 secondi, niente resta in attesa: il terminale chiede come al solito e il telefono riceve un avviso. Se sei lontano, il terminale aspetta il telefono e smette di aspettare appena tocchi la tastiera. Puoi cambiare i tempi di ogni computer nell'app.
04Comandi
ccn pairMostra un codice QR e un link per abbinare un telefono (validi 24 ore) e attendeccn pair CODEAbbina con il codice a 6 cifre dell'appccn pair --no-waitMostra il codice QR e il link, poi termina subitoccn doctorControlla gli hook, l'abbinamento e la connessioneccn testInvia una notifica di provaccn devicesElenca i telefoni abbinati o ne revoca unoccn config showMostra le impostazioni di questo computerccn config set pair_nudges offDisattiva il suggerimento di abbinare dopo le notifiche sul desktopccn syncRecupera subito le impostazioni cambiate dal telefonoccn upgradeAggiorna ccn all'ultima versione adessoccn config set auto_update offDisattiva il controllo giornaliero degli aggiornamenticcn unlockAcquista una licenza e sblocca questo computer (vedi Licenza)05Licenza
Una licenza acquistata su claudecodenotifier.com/licence sblocca ogni telefono abbinato a un massimo di 3 computer. È legata al computer: inserisci la chiave in ccn, mai nell'app del telefono.
ccn unlockAcquista una licenza nel browser e sblocca questo computer (--lifetime per pagare una volta)ccn activate KEYUsa la tua chiave su questo computer (--replace NAME libera il posto di un altro computer)ccn deactivateLibera il posto di questo computer per usare la chiave altroveccn licenceMostra il piano, la data di rinnovo e i computer che usano la chiaveSenza licenza, ccn può mostrare una riga al giorno in Claude Code, e una notifica sul desktop, su come sbloccare. CCN_NO_NUDGE=1 le disattiva.
06Aggiornamenti
ccn upgrade
ccn si tiene aggiornato da solo: una volta al giorno controlla in background se c'è una nuova versione e la installa. ccn upgrade aggiorna subito, e ccn config set auto_update off disattiva il controllo giornaliero. Se l'hai installato con Homebrew o npm, ccn lascia l'aggiornamento al tuo gestore di pacchetti e ti indica il comando da eseguire.
07L'app per Mac
L'app per Mac di Claude Code Notifier nella barra dei menu funziona ancora ed è gratuita. Se preferisci un'app a un terminale, scaricala oppure esegui brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. A differenza di ccn, può inviare webhook, e richiede iTerm2, kitty o tmux per rispondere dal telefono. Non eseguirle entrambe sullo stesso Mac, o ogni notifica arriverà due volte. Per passare dall'app a ccn, abbina con ccn pair CODE --replace-mac-app, che rimuove gli hook dell'app, poi chiudi l'app.
08Disinstalla
ccn uninstall
Così rimuovi gli hook da settings.json, revochi gli abbinamenti ed elimini lo stato locale. Poi elimina il binario: ~/.local/bin/ccn su macOS e Linux, %LOCALAPPDATA%\Programs\ccn su Windows, oppure brew uninstall ccn.
ccn forget
Elimina questo computer dal server di inoltro e rimuove ccn.