Collega il telefono a Claude Code su Mac, Windows o Linux

01Cosa ottieni con l'associazione

Una volta associato il telefono, Claude Code può raggiungerti quando ha bisogno di te:

• Una push "Claude ha finito" appena termina un turno.
• Richieste di permesso che puoi consentire una volta, consentire per la sessione o negare.
• Domande a cui puoi rispondere scegliendo un'opzione.
• Un'istruzione di follow-up da inviare subito dopo che Claude ha finito.

Anche prima dell'associazione, ccn mostra già notifiche desktop sul computer negli stessi momenti. L'associazione aggiunge il telefono.

Claude Code Notifier è uno strumento indipendente creato da TouchTap Ltd. Non è realizzato da Anthropic né affiliato con essa. Funziona tramite gli hook di Claude Code, quindi copre ogni sessione claude in qualsiasi terminale, compresi quelli integrati negli IDE VS Code, Cursor e JetBrains.

02Prima di iniziare

Ti servono:

• Claude Code installato e funzionante sul computer.
• L'app Claude Code Notifier sul telefono, dall'App Store o da Google Play. Se scansioni il QR code senza avere l'app, il telefono ti propone lo store.
• Una connessione di rete su entrambi i dispositivi.

L'app si scarica gratis e per usarla richiede un abbonamento o un acquisto a vita, con una prova gratuita sul piano annuale. Vedi i prezzi.

03Due modi per associare

Ci sono due strade. Portano allo stesso risultato, quindi scegli quella più comoda.

Sia i link QR sia i codici a 6 cifre durano 24 ore.

04Metodo 1: scansiona un QR code

Su Mac o Linux

1. Apri un terminale e installa ccn:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

Oppure con Homebrew:

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn

2. Esegui ccn (o ccn pair). Installa gli hook se servono e mostra un QR code e un link.
3. Inquadra il QR code con la fotocamera del telefono e apri il link. Se l'app è installata, si apre e completa l'abbinamento. Altrimenti il telefono ti propone prima l'App Store o Google Play: installa l'app e l'abbinamento prosegue.
4. Il terminale conferma che il telefono è abbinato.

Su Windows

1. Apri PowerShell e installa ccn (il supporto per Windows è in beta):

irm https://claudecodenotifier.com/install.ps1 | iex

2. Esegui ccn pair. PowerShell mostra un QR code e un link.
3. Scansionalo con la fotocamera del telefono, come sopra.
4. PowerShell conferma che il telefono è abbinato.

Con Node.js o come plugin, su qualsiasi sistema operativo

Se hai Node.js, questo comando installa e avvia l'abbinamento in un colpo solo:

npx @touchtap/ccn

Oppure, direttamente da Claude Code, installalo come plugin ed esegui il suo comando di setup:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05Metodo 2: inserisci un codice a 6 cifre

Questo metodo parte dal telefono: è comodo quando non vedi bene lo schermo del computer o quando Claude Code gira su un server a cui accedi in SSH.

1. Apri l'app Claude Code Notifier e vai su Computers > Add a computer.
2. L'app mostra un codice a 6 cifre e il comando esatto da eseguire per il tuo sistema operativo.
3. Esegui quel comando sul computer. Se ccn è già installato, basta:

ccn pair 482913

Sostituisci 482913 con il tuo codice.

Installa e abbina con un solo comando

Ogni comando di installazione accetta il codice, quindi su un computer nuovo basta un solo comando.

Su Mac o Linux:

curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913

Su Windows, in PowerShell:

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

Come plugin di Claude Code, passa il codice al comando di setup: /ccn:setup 482913.

06Verifica che funzioni

Due comandi confermano che è tutto a posto:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

Poi provalo sul serio. Avvia claude, dagli un piccolo task e allontanati dalla tastiera. Quando finisce, ricevi una push sul telefono.

Tieni presente che ccn si accorge quando sei al computer. Se hai digitato negli ultimi 30 secondi, le richieste di permesso e le domande compaiono nel terminale come al solito e sul telefono arriva al massimo un avviso. Allontanati per vedere il telefono prendere il controllo.

07Abbinare più dispositivi

• Più computer, un telefono. Ripeti i passaggi su ogni computer. Il Mac del lavoro, il PC Linux di casa e il portatile Windows possono raggiungere tutti lo stesso telefono. Usare più sessioni di Claude Code spiega come distinguerli.
• Più telefoni, un computer. Abbina ogni telefono allo stesso computer.
• Vedere o rimuovere i telefoni. ccn devices elenca i telefoni abbinati e ccn devices revoke <name> ne rimuove uno.

08Script e macchine remote

ccn pair --no-wait mostra il QR code e termina subito, ideale per script e provisioning. Su un server in SSH di solito il metodo più semplice è quello del codice a 6 cifre, perché lo inserisci nella stessa sessione SSH che usi per Claude Code. Notifiche da Claude Code su un server remoto in SSH spiega il resto della configurazione.

09Se l'abbinamento non funziona

• Il codice è stato rifiutato. I codici durano 24 ore. Generane uno nuovo nell'app oppure usa il metodo del QR code.
• Il QR code non viene letto. Ingrandisci la finestra del terminale, oppure apri sul telefono il link stampato.
• ccn non viene trovato dopo l'installazione. Apri un nuovo terminale per aggiornare il PATH.
• Abbinato, ma non arriva nessuna push. Esegui ccn doctor, poi ccn test, e verifica nelle impostazioni del telefono che le notifiche siano consentite per l'app.

L'elenco completo è in Le notifiche di Claude Code non funzionano? Una checklist.

10Non sei ancora pronto ad abbinare?

Nessun problema. Le notifiche desktop funzionano appena installi ccn. Finché non abbini un telefono, ccn ogni tanto ti suggerisce ccn pair. Per disattivare i suggerimenti:

ccn config set pair_nudges off

11FAQ