Claude Code Remote Control: come programmare dal telefono con un codice QR nel 2026

Sono disponibili altre istruzioni nella documentazione di Ailoot.

Che cos’è Remote Control e perché programmare dal telefono?#

Anthropic ha rilasciato Remote Control il 24 febbraio 2026. Anthropic lo descrive come un modo per continuare le sessioni locali da qualsiasi dispositivo.

In parole semplici: avvii una sessione nel terminale come al solito. Attivi Remote Control. Apri l’app Claude sul telefono → la scheda Code → e vedrai la sessione con un punto verde. Toccalo, leggi e rispondi. Puoi scrivere dal laptop, dal telefono e dal browser in qualsiasi combinazione: tutto è sincronizzato.

La documentazione ufficiale di Remote Control distingue esecuzione locale e traffico di rete: comandi e operazioni sui file avvengono sul computer, mentre la conversazione si sincronizza tramite Anthropic.

Questa è la differenza fondamentale rispetto a Claude Code sul web, dove la sessione viene eseguita in una VM cloud di Anthropic. Qui Claude continua a funzionare sul tuo hardware, con tutti i tuoi repository Git, le variabili d’ambiente e le chiavi dei database. Il telefono è solo uno schermo che usi per parlargli.

Perché potrebbe servire a chi programma con il vibe coding

Tre scenari pratici che l’autore ha usato ogni settimana:

1. Un lungo refactoring notturno. Assegna a Claude il compito di aggiornare 40 file per una nuova API. Allontanati dal laptop. Al mattino, sdraiati sul divano con il telefono, esamina il diff e dì: «Accetta i primi 12; mostrami gli altri separatamente». Non serve aprire il laptop.
2. Approva un passaggio mentre vai al lavoro. Sei in metropolitana quando Claude invia una notifica push: «Serve una decisione sulla migrazione dello schema». Aprila, leggi le due alternative e scrivi: «Scegli la prima opzione; non toccare i test». La sessione prosegue mentre sei in viaggio.
3. Durante una diretta o una riunione. Durante una riunione su Zoom, puoi controllare dal telefono che una seconda sessione Claude abbia creato una build di test. Senza passare da una finestra all’altra durante la videochiamata.

Requisiti per usare Remote Control#

Tabella completa dei requisiti:

Controlla la tua versione con:

claude --version

Se è precedente alla 2.1.51, aggiorna:

npm install -g @anthropic-ai/claude-code@latest

Se nell’ambiente sono impostati ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o apiKeyHelper, Remote Control non si avvierà. Dalla versione v2.1.139 (11.05.2026), Anthropic blocca esplicitamente la funzione quando queste variabili sono presenti. Esegui unset ANTHROPIC_API_KEY e accedi di nuovo con /login.

Come avviare Remote Control: 3 metodi in 2 minuti#

Metodo 1. Modalità server: un server dedicato alle sessioni remote

1. Apri un terminale nella cartella del progetto

   Esegui cd una volta per raggiungere la directory in cui lavorerai. Se è una nuova cartella, esegui claude come al solito per completare la finestra di dialogo Workspace Trust.

2. Avvia il server

   claude remote-control
   

   Il terminale rimane attivo. In basso compaiono l’URL della sessione e il messaggio «Premi spazio per mostrare il QR». Il server è in attesa di connessioni.

3. Connettiti dal telefono

   Premi Spazio: apparirà il codice QR. Scansionalo con l’app Claude o la fotocamera dell’iPhone per aprire la sessione.

Facoltativo: imposta il nome e i parametri della sessione:

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name — il nome visualizzato per la sessione nell’elenco sul telefono.
• --spawn worktree — ogni nuova sessione si apre in un proprio worktree Git, così le sessioni parallele non interferiscono tra loro.
• --capacity 4 — massimo 4 sessioni remote simultanee sul server. Il valore predefinito è 32.

Metodo 2. Modalità interattiva: la mia sessione con Remote Control attivo

claude --remote-control
# or shorter:
claude --rc

Si avvia una normale sessione interattiva nel terminale, con Remote Control attivo. Puoi scrivere a Claude sia dal laptop sia dal telefono: la conversazione è un’unica sessione sincronizzata.

A differenza della modalità server, questa è una sola sessione. È utile quando prevedi di lavorare soprattutto dal computer e vuoi il telefono come alternativa per quando devi allontanarti.

Metodo 3. Da una sessione attiva con /rc

Stai già lavorando in Claude Code? Non terminare la sessione. Digita semplicemente:

/remote-control

o, in forma più breve:

/rc

La sessione diventa remota. Non perderai il contesto. È utile quando, nel bel mezzo di un’attività, ti rendi conto che devi allontanarti.

Codice QR: collega il telefono in 10 secondi#

1. Installa l’app Claude

   Se non l’hai ancora, digita /mobile in Claude Code. Apparirà un codice QR per scaricare l’app dall’App Store o da Google Play. È più veloce che cercarla manualmente.

2. Mostra il codice QR della sessione nel terminale

   Dopo claude --rc o claude remote-control, premi Spazio. Il codice QR apparirà direttamente nel terminale.

3. Scansiona con il telefono

   Apri l’app Claude → fotocamera, oppure usa la fotocamera standard dell’iPhone (anche le fotocamere Android possono scansionarlo). Se non funziona, allarga la finestra del terminale, passa a iTerm2 o Windows Terminal, oppure copia l’URL sopra il codice QR e incollalo manualmente nel browser.

4. Attiva le notifiche push

   Digita /config nella sessione e attiva «Invia una notifica push quando Claude decide». Claude Code deve essere versione 2.1.110 o successiva.

Cosa vedrai sul telefono

Nell’app Claude si apre la scheda Code. La tua sessione appare nell’elenco con un’icona a forma di computer e un punto verde (online). Toccalo per accedere.

Poi funziona come claude.ai/code: puoi vedere i messaggi di Claude e i diff dei file, accettarli o rifiutarli, oppure chiedere modifiche. Puoi inviare una nuova richiesta. Tutto arriva al tuo computer, dove Claude locale la elabora e restituisce una risposta.

Cosa può fare Claude con le notifiche push

Claude invia notifiche push quando ritiene che servano. Per impostazione predefinita, accade in due casi: quando termina un’attività lunga o quando Claude ha bisogno di una tua decisione. Puoi anche chiederglielo esplicitamente: «Avvisami quando i test sono superati» e ne invierà una.

Se le notifiche push non arrivano:

• Su iOS, controlla Impostazioni → Notifiche → Claude. Le modalità Full immersion potrebbero silenziarle.
• Su Android, disattiva l’ottimizzazione della batteria per l’app Claude.
• Se /config mostra «Nessun dispositivo mobile registrato», apri l’app Claude almeno una volta affinché possa aggiornare il token push.

Lavorare dal divano: 5 scenari utili#

Scenario 1. Revisione dal divano: esaminare un’attività notturna

Prima di andare a dormire, assegna a Claude un’attività come: «Esegui tutto il repository con le nuove regole di lint e correggi tutto ciò che non è critico; contrassegna il resto come TODO». Esegui claude --rc e lascia aperto il terminale.

Al mattino, sdraiati sul divano con il telefono. Apri l’app Claude → trova la sessione con un punto verde → vedrai 87 commit sotto forma di diff. Scorrili; nei punti dubbi scrivi «annulla questa modifica, la sistemerò manualmente» e, per quelli a posto, «accetta tutto». Niente «devo arrivare al laptop» alle 7 del mattino.

Scenario 2. Approva durante il tragitto: approvare un passaggio in metropolitana

Al mattino avvia una lunga migrazione dello schema del database. Alle 9:30, in metropolitana, arriva una notifica push: «Ho trovato due alternative per la migrazione; serve una decisione». Tocca la notifica, leggile, scegline una e aggiungi: «Non eliminare la vecchia tabella finché l’intera esecuzione dei test non è completata». Claude continua.

Senza Remote Control, Claude si fermerebbe a quel punto e resterebbe in attesa in silenzio. Arrivi a destinazione e apri il laptop: 40 minuti persi.

Scenario 3. Allontanarsi: un’attività lunga durante il pranzo

Prima di pranzo, avvia Claude con «Aggiorna la documentazione di tutti gli endpoint». Vai al bar. Dopo 25 minuti, arriva una notifica push: «Fatto, dai un’occhiata». Tocca «accetta» una volta, poi torna alla tua zuppa. Senza Remote Control, o resti al laptop per 25 minuti come una guardia, oppure torni e scopri che Claude non ha fatto nulla perché si è imbattuto in un punto che richiedeva una decisione.

È un punto importante. Remote Control non rende Claude più autonomo: ti dà semplicemente accesso da qualsiasi luogo. Meno punti decisionali incontra Claude, meno notifiche push riceverai. Perciò rendi le istruzioni più specifiche: «Fai così; in questi casi fai cosà; se è davvero poco chiaro, fermati e invia una notifica push».

Scenario 4. Una decisione architetturale da un bar

Durante un refactoring, Claude trova due strade per la migrazione e ti chiede di scegliere. Se sei lontano dal computer, apri i diff proposti sul telefono, scegli un’opzione e aggiungi il commento: «Però non toccare la tabella user_settings: la eliminerò la prossima settimana». La sessione continua.

Funziona particolarmente bene in modalità worktree (--spawn worktree): ogni attività parallela si trova nel proprio branch, quindi non interferiscono tra loro. Sul telefono puoi passare dall’una all’altra come nelle chat.

Scenario 5. Più sessioni worktree contemporaneamente

Un approccio potente consiste nell’usare la modalità server con più worktree. Avvia questo comando sul laptop:

claude remote-control --spawn worktree --capacity 4

Avvia sessioni in branch diversi dal telefono: una sviluppa una funzione, un’altra corregge i bug di un elenco e una terza esegue test di regressione. Funzionano tutte in parallelo sul laptop e nessuna blocca le altre.

Sicurezza: cosa resta sul computer e cosa viene inviato#

Prima di collegare un progetto sensibile, decidi quali contenuti possano entrare nei prompt e nell’output degli strumenti. Mantieni i segreti di produzione fuori dall’ambiente accessibile all’agente: la tabella dei trasferimenti non dimostra che una sessione specifica non possa divulgarli.

In parole semplici: il tuo laptop chiede ad Anthropic «Hai messaggi per me?», riceve una risposta ed elabora tutto localmente. Nessuno dall’esterno apre una porta in ingresso sul tuo computer. Un firewall aziendale lo consentirà senza configurazioni speciali.

Quali dati arrivano fisicamente ad Anthropic

Remote Control aggiunge un’interfaccia sincronizzata, non una modalità d’inferenza offline. Anthropic conserva la trascrizione della sessione collegata, inclusi messaggi, risposte e attività degli strumenti, secondo la propria politica sui dati. Esamina sia i dati inviati al modello sia l’accesso dai dispositivi collegati.

Una nota sulle credenziali

In altre parole, tra il laptop, Anthropic e il telefono circola un insieme di token di breve durata invece di un unico token di lunga durata. La compromissione di uno non dà accesso a tutti gli altri.

Un’altra limitazione importante: --dangerously-skip-permissions non funziona in Remote Control. Ogni chiamata a uno strumento (Bash, Write, Edit) richiede comunque la tua approvazione. È una scelta deliberata, per evitare che la funzione per telefono si trasformi in «un laptop in autopilota senza supervisione».

Hai avviato Remote Control? Ora configura Claude per evitare interruzioni ogni 10 minuti#

/rc è un modo pratico per portare la sessione sul telefono. Ma se Claude scrive «Non capisco cosa fare» ogni 10 minuti, il problema non è il telefono: è la progettazione del contesto, cioè quanto chiaramente stabilisci le regole all’inizio.

Sei problemi al primo avvio e come risolverli#

Problema 1. «Gli ambienti Remote Control non sono disponibili per il tuo account»

È la lamentela più comune nel repository anthropics/claude-code (issue #29449 e più di una dozzina di duplicati). Hai risposto y alla domanda «attivare Remote Control?»: la CLI ha restituito un errore e non propone più di riprovare.

La causa è quasi sempre la stessa: nell’ambiente è impostato ANTHROPIC_API_KEY o CLAUDE_CODE_OAUTH_TOKEN. Remote Control funziona solo con OAuth completo tramite /login, non con una chiave.

Soluzione:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# check that the environment is clean:
env | grep -i anthropic
env | grep -i claude

# sign in again:
claude
/logout
/login

Dopo aver effettuato l’accesso tramite browser con /login, Remote Control dovrebbe avviarsi.

Problema 2. Il telefono non riesce a scansionare il codice QR

La fotocamera del telefono è puntata sul codice ma non reagisce, oppure dice «Impossibile leggere».

Causa: il terminale visualizza il codice QR troppo piccolo o con contrasto insufficiente.

Soluzione:

1. Espandi la finestra del terminale a schermo intero.
2. Se usi Apple Terminal, passa a iTerm2 (o Warp). Se sei su Windows, usa Windows Terminal invece di CMD.
3. Riduci la dimensione del carattere del terminale di 1–2 punti per ingrandire il codice QR.
4. Se non basta, copia l’URL sopra il codice QR e aprilo nel browser del telefono.

Problema 3. Il firewall blocca la porta 443

Succede spesso sui computer aziendali con un proxy di intercettazione (Zscaler o una VPN aziendale con MITM).

Soluzione: inizia con i log dettagliati e acquisisci l’errore specifico:

claude remote-control --verbose

Se compare «verifica del certificato non riuscita», c’è un’intercettazione MITM e devi parlare con l’amministratore di rete. Se compare «connessione rifiutata» / «timeout», chiedi all’amministratore di consentire l’accesso in uscita a *.anthropic.com:443.

Problema 4. Claude Code è troppo vecchio

Controlla:

claude --version

Se è precedente alla 2.1.51, aggiorna:

npm install -g @anthropic-ai/claude-code@latest

L’estensione VS Code richiede almeno v2.1.79. Le notifiche push richiedono v2.1.110.

Problema 5. Le notifiche push non arrivano

Scenario: Remote Control funziona, ma il telefono resta silenzioso quando Claude completa un’attività lunga.

Elenco di controllo:

1. Esegui /config nella sessione. Se dice «Nessun dispositivo mobile registrato», apri l’app Claude sul telefono almeno una volta affinché possa aggiornare il token push.
2. iOS: Impostazioni → Notifiche → Claude → controlla che le notifiche siano attive e non silenziate dalla modalità Full immersion.
3. Android: apri le impostazioni della batteria ed escludi Claude dall’ottimizzazione della batteria.
4. Se Riepilogo notifiche di iOS è attivo, la notifica push potrebbe arrivare ma comparire nel riepilogo orario. Disattiva il riepilogo per Claude.

Problema 6. Claude Desktop compromette /remote-control

Se esegui /remote-control nell’app Claude Desktop, ricevi l’errore «Remote Control richiede un token di accesso con ambito completo» (issue GitHub #48378).

Causa: Claude Desktop inserisce un token OAuth con autorizzazioni limitate (solo inferenza).

Soluzione: esegui Claude Code in un normale terminale di sistema, non nel terminale integrato in Claude Desktop. È una limitazione nota; Anthropic sta lavorando a una soluzione.

Bonus. La riconnessione automatica si interrompe senza avviso nelle sessioni lunghe

Sintomo: una sessione Remote Control dura 30–60 minuti, poi il telefono si disconnette senza avvisi né indicatori (issue #34255). Per risolvere manualmente: /remote-control → Disconnetti → riavvia. Non è l’ideale, ma la funzione è ancora un’anteprima di ricerca.

Nel solo maggio 2026, Anthropic ha distribuito otto correzioni specifiche per Remote Control: la funzione viene migliorata attivamente. Puoi lamentarti, ma è ragionevole aspettarsi che la maggior parte di questi problemi scompaia nel giro di un paio di mesi.

Remote Control, bot Telegram e SSH+tmux a confronto#

Tabella comparativa

Quando scegliere ciascuna opzione

• Remote Control — l’impostazione predefinita per «allontanati dal laptop e continua a dirigere il lavoro». UI completa, sincronizzazione tra dispositivi e nessun servizio di terze parti.
• Channels (bot Telegram) — quando vuoi che un errore CI, una nuova lamentela di un cliente o un messaggio in chat chieda automaticamente a Claude di indagare. È «evento → Claude reagisce» invece di «dirigo Claude dal telefono». Leggi la guida a Telegram e Claude Code.
• SSH + tmux — quando ti serve una shell qualsiasi sul telefono per i tuoi comandi (distribuire una release, controllare un log, riavviare un servizio). Una shell universale al di fuori di Claude Code. Per le attività occasionali, funziona tramite Termux/Blink.
• Altri agenti di programmazione — Anthropic Remote Control è solo per Claude Code. Per un confronto tra Claude e le alternative, vedi Cursor vs Claude Code.

La documentazione di Anthropic distingue quindi queste due funzioni in base al caso d’uso: Remote Control serve per dirigere; Channels per reagire.

Novità di Remote Control da maggio 2026 a giugno 2026#

Cronologia completa delle correzioni:

Otto correzioni specifiche per Remote Control in un mese sono normali per una funzione in anteprima di ricerca. Anthropic sta chiaramente rispondendo ai feedback e risolvendo i casi limite.

Se la funzione si comporta in modo strano, il primo passo è controllare la versione e aggiornarla. È probabile che il bug sia già stato corretto.

Checklist: configurarlo e renderlo operativo in 5 minuti#

1. Controlla la versione di Claude Code

   claude --version — dovrebbe essere la 2.1.51 o una versione successiva. In caso contrario, esegui npm install -g @anthropic-ai/claude-code@latest.

2. Rimuovi le chiavi API dall’ambiente

   Esegui unset ANTHROPIC_API_KEY e unset CLAUDE_CODE_OAUTH_TOKEN. Poi esegui /logout → /login tramite il browser.

3. Installa l’app Claude sul telefono

   Esegui /mobile in una sessione Claude Code per mostrare un codice QR che rimanda all’App Store / Google Play.

4. Avvia Remote Control

   Esegui claude --rc oppure /rc all’interno di una sessione. Appariranno un URL e il messaggio «Premi spazio per mostrare il QR».

5. Scansiona il codice QR con il telefono

   Premi Spazio nel terminale → usa la fotocamera o l’app Claude. Allarga la finestra del terminale se non riesci a scansionarlo.

6. Attiva le notifiche push

   /config → «Invia una notifica push quando Claude decide». Se compare «Nessun dispositivo mobile registrato», apri l’app Claude almeno una volta.

7. Avvia un’attività lunga e allontanati

   Rendi specifico il prompt: «Fai così; in questi casi fai cosà; nei casi dubbi invia una notifica push». Poi continua dal telefono usando le notifiche push.

In un esempio pratico, ci sono voluti 3–5 minuti dall’inizio alla prima conversazione dal divano.

Quando vuoi, scopri Ailoot.