Skip to main content
Remote Control è disponibile su tutti i piani. Su Team e Enterprise, è disabilitato per impostazione predefinita fino a quando un proprietario non abilita l’interruttore Remote Control nelle impostazioni di amministrazione di Claude Code.
Remote Control connette claude.ai/code o l’app Claude per iOS e Android a una sessione di Claude Code in esecuzione sulla tua macchina. Avvia un’attività alla tua scrivania, quindi riprendi dal tuo telefono sul divano o da un browser su un altro computer. Quando avvii una sessione Remote Control sulla tua macchina, Claude continua a funzionare localmente per tutto il tempo, quindi l’esecuzione del codice e l’accesso al filesystem rimangono sulla tua macchina. Con Remote Control puoi:
  • Utilizzare il tuo ambiente locale completo da remoto: il tuo filesystem, i server MCP, gli strumenti e la configurazione del progetto rimangono disponibili, e digitando @ l’autocompletamento completa i percorsi dei file dal tuo progetto locale.
  • Lavorare da entrambe le superfici contemporaneamente: la conversazione e il progresso dei subagent e dei flussi di lavoro dinamici rimangono sincronizzati su tutti i dispositivi connessi, quindi puoi inviare messaggi dal tuo terminale, browser e telefono in modo intercambiabile.
  • Inviare immagini e file dal tuo telefono o browser: allega una foto o un file nell’app Claude o su claude.ai/code, con o senza didascalia. Claude vede le foto allegate direttamente come parte del tuo messaggio. Claude Code scarica altri file sulla tua macchina e li passa a Claude come riferimenti a file @.
  • Sopravvivere alle interruzioni: se il tuo laptop va in sospensione o la tua rete si interrompe, Claude Code si riconnette automaticamente quando la tua macchina torna online. Mentre la connessione si sta ricostruendo, Claude Code mette in coda i messaggi, i prompt di autorizzazione e gli aggiornamenti di stato dai subagent e dai flussi di lavoro, e li consegna una volta che la connessione si recupera.
A differenza di Claude Code sul web, che funziona su infrastrutture cloud, le sessioni Remote Control vengono eseguite direttamente sulla tua macchina e interagiscono con il tuo filesystem locale. Le interfacce web e mobile sono una finestra in quella sessione locale. Questa pagina copre la configurazione, come avviare e connettersi alle sessioni, e come Remote Control si confronta con Claude Code sul web.

​
Requisiti

Prima di utilizzare Remote Control, conferma che il tuo ambiente soddisfi queste condizioni:
  • Abbonamento: disponibile su piani Pro, Max, Team e Enterprise. Le chiavi API non sono supportate. Su Team e Enterprise, un proprietario deve prima abilitare l’interruttore Remote Control nelle impostazioni di amministrazione di Claude Code.
  • Autenticazione: esegui claude e utilizza /login per accedere tramite claude.ai se non l’hai già fatto. Senza un accesso idoneo, claude remote-control esce con un errore, mentre claude --remote-control avvia comunque una sessione interattiva e mostra una notifica di errore di Remote Control poco dopo l’avvio.
  • Endpoint API: non disponibile in nessuna di queste configurazioni:
    • Utilizzi Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry.
    • Punti ANTHROPIC_BASE_URL a un host diverso da api.anthropic.com, come un gateway LLM o proxy. Annulla l’impostazione della variabile per utilizzare Remote Control. Prima della v2.1.196, Claude Code consentiva Remote Control con un ANTHROPIC_BASE_URL personalizzato.
    • Accedi tramite un gateway di app Claude aziendale.
  • Valutazione dei flag di funzionalità: DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC e DISABLE_GROWTHBOOK disabilitano ciascuno la valutazione dei flag di funzionalità da cui dipende la disponibilità di Remote Control. Annulla l’impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco env di un file settings.json, per utilizzare Remote Control.
  • Fiducia dell’area di lavoro: esegui claude nella directory del tuo progetto almeno una volta per accettare la finestra di dialogo di fiducia dell’area di lavoro. La finestra di dialogo di fiducia all’avvio non salva mai la fiducia per la directory home, quindi avvia Remote Control da una directory di progetto.

​
Avvia una sessione Remote Control

Puoi avviare una sessione Remote Control dalla CLI o dall’estensione VS Code. La CLI offre tre modalità di invocazione; VS Code utilizza il comando /remote-control.
Accedi alla directory del tuo progetto ed esegui:
Finché non accetti la conferma una tantum di Remote Control, claude remote-control spiega cosa fa e chiede Enable Remote Control? (y/n) prima di avviare il server. Rispondi y per accettare e avviare il server. Se rifiuti, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che esegui il comando.Il processo rimane in esecuzione nel tuo terminale in modalità server, in attesa di connessioni remote. Visualizza un URL di sessione che puoi utilizzare per connetterti da un altro dispositivo, e puoi premere la barra spaziatrice per mostrare un codice QR per un accesso rapido dal tuo telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l’attività dello strumento.Flag disponibili:Fornisci questi flag dopo remote-control.Se passi un flag claude globale prima di remote-control, o uno script wrapper ne aggiunge uno, Claude Code non trasporta il flag alle sessioni che il server crea. Claude Code lascia passare il flag solo quando eliminarlo non è noto per cambiare ciò che quelle sessioni possono fare, come --verbose o --model. Per qualsiasi altro flag, come --settings, Claude Code rifiuta di avviare e nomina il flag da rimuovere. Prima della v2.1.248, qualsiasi opzione prima di remote-control faceva sì che Claude Code rifiutasse i flag dopo di essa con un errore unknown option.Claude Code verifica l’idoneità di Remote Control prima di stampare la guida, quindi claude remote-control --help restituisce un errore invece di questo elenco di flag quando non sei connesso con un account idoneo.

​
Verifica lo stato della connessione

In una sessione di terminale interattiva, un indicatore /rc active si mostra mentre la connessione è attiva, ed è nascosto se il terminale è troppo stretto per contenerlo. Con il rendering a schermo intero si trova alla fine della riga della directory di lavoro nell’intestazione di avvio, e senza di esso, nel footer sotto la casella di input. Il testo dell’indicatore è un collegamento alla sessione su claude.ai. Esegui /remote-control di nuovo per aprire un pannello di stato con l’URL della sessione e un codice QR per connetterti da un altro dispositivo. Quando l’indicatore è nel footer, puoi anche aprire il pannello selezionando l’indicatore con il tasto freccia giù e premendo Invio. Il pannello offre anche un’opzione di disconnessione, che disattiva Remote Control mentre la tua sessione locale continua a funzionare nel terminale. Se la connessione non riesce, Claude Code mostra una notifica con il motivo dell’errore, aggiunge una riga di avviso con il motivo alla conversazione, e cambia l’indicatore a uno stato di errore che rimane nel posto. Per riconnetterti, esegui /remote-control, a meno che il motivo non dica che la sessione è stata presa in consegna o terminata altrove, o che il server non riesce a trovarla. Leggi il motivo prima di riconnetterti. Quando la sessione è stata presa in consegna o terminata da un altro dispositivo, app, o sessione di Claude Code, o il server non riesce a trovarla, il motivo dice quale, e Claude Code omette il suo solito consiglio di eseguire /remote-control:
  • Un altro dispositivo o sessione di Claude Code ha preso in consegna la sessione: esegui /remote-control solo se vuoi riprendertela da quel dispositivo.
  • Hai terminato o archiviato la sessione da un altro dispositivo o app: esegui /remote-control solo se la vuoi indietro; Claude Code riapre una sessione archiviata.
  • Il server non riesce a trovare la sessione: potrebbe essere stata eliminata da un altro dispositivo o app.

​
Promemoria dell’URL della sessione

Mentre Remote Control è connesso, Claude Code ti ricorda l’URL della sessione quando passare al tuo telefono o browser è più utile, così non devi trovare il collegamento in /remote-control. Un promemoria appare sopra la casella del prompt in uno di questi momenti:
  • Turno lungo: quando un turno dura più a lungo di una soglia sintonizzata dal server, Claude Code mostra una notifica Still working con un collegamento Check in from your phone, così puoi seguire il turno dal tuo telefono o browser invece di aspettare al terminale. Claude Code la rimuove quando il turno termina.
  • Prompt di autorizzazione ripetuti: dopo aver risposto a diversi prompt di autorizzazione in una sessione, una notifica Approve tool calls from your phone mostra l’URL della sessione. Claude Code la rimuove quando il tuo prossimo turno inizia.
I promemoria possono apparire in qualsiasi sessione connessa, incluse quelle in cui Remote Control si connette automaticamente. Non appaiono ogni volta che si verificano queste condizioni, e ognuno appare solo poche volte in totale tra le sessioni. Non puoi configurarli o disattivarli; ognuno si cancella da solo.

​
Connettiti da un altro dispositivo

Una volta che una sessione Remote Control è attiva, hai alcuni modi per connetterti da un altro dispositivo:
  • Apri l’URL della sessione in qualsiasi browser per andare direttamente alla sessione su claude.ai/code.
  • Scansiona il codice QR mostrato accanto all’URL della sessione per aprirlo direttamente nell’app Claude. Con claude remote-control, premi la barra spaziatrice per attivare/disattivare la visualizzazione del codice QR.
  • Apri claude.ai/code o l’app Claude e trova la sessione per nome nell’elenco delle sessioni. Nell’app mobile Claude, tocca Code nella navigazione per raggiungere l’elenco delle sessioni. Le sessioni Remote Control mostrano un’icona di computer con un punto di stato verde quando sono online.
Quando ti connetti, il dispositivo mostra tutti i subagent e i workflow che la sessione ha già in esecuzione in background. Ferma uno di essi dal dispositivo, e Claude Code ferma quel compito sulla tua macchina. Il titolo della sessione remota viene scelto in questo ordine:
  1. Il nome che hai passato a --name, --remote-control, o /remote-control
  2. Il titolo che hai impostato con /rename
  3. L’ultimo messaggio significativo nella cronologia della conversazione esistente
  4. Un nome generato automaticamente come myhost-graceful-unicorn, dove myhost è il nome host della tua macchina o il prefisso che hai impostato con --remote-control-session-name-prefix
Se non hai impostato un nome esplicito, Claude Code aggiorna il titolo per riflettere il tuo prompt una volta che ne invii uno. Claude Code abbina i titoli generati automaticamente alla lingua della tua conversazione, o all’impostazione language se ne è configurata una; l’abbinamento della lingua richiede Claude Code v2.1.176 o successivo. Quando rinomini una sessione da claude.ai o dall’app Claude, Claude Code aggiorna anche il titolo locale mostrato in claude --resume. Claude Code applica lo stesso rinomina al nome della sessione mostrato sulla barra del prompt, e nell’elenco claude agents quando la sessione funziona in background. Prima della v2.1.221, il rinomina da claude.ai o dall’app Claude aggiornava solo il titolo, e la CLI manteneva il suo nome di sessione precedente; /rename, che funziona nella CLI stessa, imposta il nome su qualsiasi versione. Se non hai ancora l’app Claude, utilizza il comando /mobile all’interno di Claude Code per visualizzare un codice QR di download per iOS o Android.

​
Cosa vedono i dispositivi connessi

Un dispositivo connesso mostra la conversazione nel tuo terminale mentre accade. Questi casi vanno oltre i messaggi ordinari:
  • Compattazione e /clear: mentre Claude Code compatta la conversazione, i dispositivi connessi mostrano il progresso e poi dove la conversazione è stata compattata. Quando esegui /clear, la conversazione si ripristina anche sui dispositivi connessi.
  • Cambio di conversazioni con /resume: il dispositivo connesso non riceve il titolo della conversazione commutata o la cronologia precedente, ma i nuovi messaggi in entrambe le direzioni vanno verso e da qualunque conversazione sia aperta nel tuo terminale. Per lavorare di nuovo sulla conversazione originale dal dispositivo, esegui /resume nel tuo terminale e torna a essa.
  • Estrazione di una sessione con /teleport: quando estrai una sessione Claude Code sul web nel tuo terminale con /teleport, il dispositivo connesso non riceve la cronologia precedente della conversazione estratta. I nuovi messaggi in entrambe le direzioni vanno verso e da quella conversazione estratta, che è ora quella aperta nel tuo terminale.
  • Messaggi dalle tue altre sessioni: con messaggistica tra sessioni, la stessa connessione trasporta messaggi tra le tue stesse sessioni su macchine diverse e dalle tue sessioni Claude Code sul web, attraverso i server Anthropic come il resto del traffico Remote Control. Messaggi alle sessioni su altre macchine copre le regole di consegna e Controlla i messaggi in entrata copre i controlli in entrata. Richiede Claude Code v2.1.224 o successivo.
  • Prompt che invii a metà turno: quando invii un prompt da un dispositivo connesso prima che il turno corrente termini, Claude Code lo mette in coda e lo mantiene nella trascrizione del dispositivo dopo che quel turno finisce.
  • Diff dei tuoi cambiamenti: quando la directory della sessione è in un repository git, il pannello diff di un dispositivo connesso mostra il diff dei tuoi cambiamenti non committati. Il dispositivo richiede il diff sulla connessione, e Claude Code lo calcola sulla tua macchina. Quando il tuo working tree è pulito, Claude Code serve invece i cambiamenti del tuo ramo da quando ha divergito dal ramo predefinito. Prima della v2.1.247, Claude Code segnalava il diff ai dispositivi connessi solo nelle sessioni servite da claude remote-control.
  • Modello: quando scegli un modello da un dispositivo connesso, Claude Code esegue la sessione su quel modello. Il picker /model del terminale, /status, e /config mostrano quel modello. Richiede Claude Code v2.1.238 o successivo.
    • Un modello che scegli dal controllo del modello del dispositivo si applica solo alla sessione corrente. Quando invii /model <name> dal dispositivo a una sessione interattiva, Claude Code imposta anche il tuo predefinito per le nuove sessioni.
    • Se invii un nome che Claude Code non riconosce, come un nome visualizzato dove è previsto un ID modello, Claude Code rifiuta la scelta e la sessione mantiene il suo modello corrente. Prima della v2.1.260, Claude Code salvava una scelta non riconosciuta dal controllo del modello del dispositivo, e il tuo prossimo messaggio falliva.
  • Livello di sforzo: quando imposti il livello di sforzo da un dispositivo connesso, con /effort o il controllo dello sforzo del dispositivo, Claude Code lo applica alla sessione sulla tua macchina, e claude.ai/code mostra il livello che la sessione sta utilizzando. Se hai fissato un livello con CLAUDE_CODE_EFFORT_LEVEL, la sessione mantiene quel livello, e Claude Code rifiuta una scelta diversa dal controllo dello sforzo. Scegliere un livello dal controllo dello sforzo richiede Claude Code v2.1.234 o successivo sulla tua macchina.
  • Riconnessione dopo un errore di connessione: esegui /remote-control per riconnetterti. Se la compattazione ha riscritto la conversazione o hai cambiato conversazioni con /resume nel frattempo, Claude Code archivia la sessione del server che stava utilizzando invece di lasciarla nell’elenco delle sessioni. Puoi comunque trovarla filtrando per sessioni archiviate. Cambiare conversazioni mentre un dispositivo è ancora connesso non archivia la sessione.

​
Abilita Remote Control per tutte le sessioni

Remote Control si attiva solo quando esegui esplicitamente claude remote-control, claude --remote-control, o /remote-control, a meno che l’auto-connessione non sia attivata. Per attivare l’auto-connessione per ogni sessione interattiva, esegui /config all’interno di Claude Code e imposta Enable Remote Control for all sessions. L’interruttore accetta tre valori:
  • true: connettiti automaticamente quando una sessione interattiva si avvia.
  • false: disattiva l’auto-connessione, anche se un true dalle impostazioni gestite lo supera, perché Claude Code salva la scelta alle tue impostazioni utente. Un false nelle impostazioni di progetto o locali (.claude/settings.json, .claude/settings.local.json) disattiva l’auto-connessione anche su un true gestito.
  • default: cancella la tua scelta e segui il valore predefinito dell’amministratore della tua organizzazione se ne è impostato uno, altrimenti il valore predefinito attuale di Claude Code.
Lo stesso interruttore appare al di fuori della CLI:
  • App Desktop: Settings > Claude Code > Enable remote control by default.
  • Estensione VS Code: Enable Remote Control for all sessions nella sezione Impostazioni del menu dei comandi. Richiede Claude Code v2.1.203 o successivo.
Per attivare l’auto-connessione da un file di impostazioni, imposta remoteControlAtStartup a true nel tuo file ~/.claude/settings.json utente o nelle impostazioni gestite. Nelle impostazioni di progetto o locali (.claude/settings.json, .claude/settings.local.json), Claude Code onora un false e disattiva l’auto-connessione per quel repository, ma ignora un true, quindi un file controllato non può attivare Remote Control per tutti coloro che aprono il repository. L’auto-connessione accede con il tuo account claude.ai, quindi una sessione che avvia appare solo nelle tue app Claude e non concede a nessun altro l’accesso. Con questa impostazione attiva, ogni processo Claude Code interattivo registra una sessione remota. Se esegui più istanze, ognuna ottiene la sua sessione remota. Per eseguire più sessioni simultanee da un singolo processo, utilizza invece la modalità server.

​
Riprendi le sessioni dopo aver fermato il server

Quando fermi claude remote-control con Ctrl+C, le sessioni che stava servendo smettono di rispondere dal tuo telefono o browser. Finché non stavi eseguendo un altro claude remote-control nella stessa directory e non hai avviato questo con --no-create-session-in-dir, Claude Code non le archivia. Per riportarle indietro, esegui uno di questi comandi nella stessa directory:
  • claude remote-control: riporta indietro ogni sessione che il server stava servendo.
  • claude remote-control --continue: riporta indietro solo la sessione con cui il server si è avviato, ed esce quando quella sessione termina. Se questa directory non ha un record, Claude Code utilizza il più recente dai worktree git di questo repository.
  • claude remote-control --session-id <id>: riporta indietro solo la sessione il cui ID passi, ed esce quando quella sessione termina. L’ID è la parte dell’URL della sessione su claude.ai/code tra /code/ e qualsiasi ?.
Questi comandi funzionano per circa quattro ore dopo che il server si è fermato. Dopo di che, esegui claude remote-control per avviare una nuova sessione. Se hai archiviato una sessione nel frattempo, --continue e --session-id la disarchiviano su Claude Code v2.1.228 o successivo. Per riportare indietro una sessione che hai avviato con claude --remote-control o /remote-control, riprendi la conversazione con claude --continue o claude --resume. Se Claude Code si riconnette, e a quale sessione, dipende dal record di riconnessione della conversazione. Se riprendi la conversazione in un secondo terminale mentre il primo ha ancora Remote Control attivo, Claude Code stampa un avviso nel secondo terminale e lascia Remote Control disattivo lì invece di prendere la sessione dal primo. Mentre Remote Control rimane disattivo lì, Claude in quel terminale non vede le tue sessioni su altre macchine, e non possono raggiungerlo. Esegui /remote-control nel secondo terminale per spostare Remote Control lì. Quando riprendi una conversazione in Claude Desktop o un’estensione IDE che aveva Remote Control attivo, Claude Code la riallega alla sessione claude.ai esistente invece di aggiungerne una nuova all’elenco delle sessioni.

​
Connessione e sicurezza

La tua sessione locale di Claude Code effettua solo richieste HTTPS in uscita e non apre mai porte in ingresso sulla tua macchina. Quando avvii Remote Control, si registra con l’API Anthropic e esegue il polling per il lavoro. Quando ti connetti da un altro dispositivo, il server instrada i messaggi tra il client web o mobile e la tua sessione locale su una connessione in streaming. Tutto il traffico viaggia attraverso l’API Anthropic su TLS, lo stesso trasporto di sicurezza di qualsiasi sessione di Claude Code. La connessione utilizza più credenziali di breve durata, ognuna limitata a un singolo scopo e con scadenza indipendente. Quando la credenziale di registrazione di un server claude remote-control scade, il server si registra di nuovo con l’API Anthropic e continua a servire le sue sessioni. Mentre Remote Control è connesso, la trascrizione della sessione, inclusi i tuoi messaggi, le risposte di Claude e l’attività degli strumenti, viene archiviata sui server Anthropic. La trascrizione archiviata mantiene la conversazione sincronizzata tra i tuoi dispositivi e consente alla sessione di riconnettersi dopo un’interruzione di rete. L’esecuzione e l’accesso al filesystem rimangono sulla tua macchina, e le trascrizioni archiviate vengono conservate secondo la politica di utilizzo dei dati. Per disattivare completamente Remote Control, utilizza l’impostazione disableRemoteControl. Le organizzazioni con requisiti di conformità come Zero Data Retention non possono abilitare Remote Control.

​
Dispositivi affidabili

Dispositivi affidabili è attualmente in beta. Le funzionalità e la funzionalità possono evolversi man mano che l’esperienza viene perfezionata.Dispositivi affidabili è disponibile su piani Team e Enterprise. È disabilitato per impostazione predefinita fino a quando un Owner non lo abilita.
Dispositivi affidabili è un’impostazione a livello di organizzazione che richiede ai membri di verificare il loro dispositivo prima di poter visualizzare o controllare le sessioni Remote Control da claude.ai, dalle app Claude per dispositivi mobili o da Claude Desktop. Lega l’accesso a Remote Control a un dispositivo noto e a un’autenticazione recente, non solo a un account connesso. Quando l’impostazione è attiva, l’interazione con una sessione Remote Control richiede entrambi i seguenti:
  • Un dispositivo registrato: ogni browser, telefono o app desktop che un membro utilizza per Remote Control registra le proprie credenziali. La registrazione viene offerta solo poco dopo un accesso completo, quindi un dispositivo si unisce all’elenco affidabile come parte di un’autenticazione reale piuttosto che silenziosamente in background.
  • Un accesso recente: l’accesso del membro non deve essere più vecchio di 18 ore. Invece di accedere di nuovo ogni giorno, i membri confermano la presenza con Face ID, Touch ID, Windows Hello o una passkey. Questo passaggio di autenticazione biometrica aggiorna la sessione immediatamente.
I controlli biometrici vengono eseguiti sul dispositivo attraverso il sistema operativo o il browser, lo stesso meccanismo dell’accesso con passkey. Anthropic non riceve né archivia mai impronte digitali, dati facciali o altre informazioni biometriche. Solo la chiave pubblica del dispositivo e i metadati di base come il nome visualizzato, la piattaforma e l’ora di registrazione vengono archiviati. L’impostazione si applica solo a Remote Control. La chat Claude regolare, Claude Code nel terminale e l’utilizzo dell’API non sono interessati.

​
Abilita Dispositivi affidabili per la tua organizzazione

Un Owner abilita l’impostazione dalla console di amministrazione di Claude Code.
1

Apri le impostazioni di amministrazione di Claude Code

Vai a claude.ai/admin-settings/claude-code. L’interruttore Require trusted devices appare sotto l’impostazione Remote Control.
2

Attiva Require trusted devices

L’impostazione si applica a ogni membro dell’organizzazione e alle sessioni Remote Control avviate dopo aver abilitato l’interruttore. Le sessioni che erano già in esecuzione prima dell’attivazione dell’interruttore non sono protette retroattivamente e continuano senza il requisito del dispositivo fino a quando non terminano. L’ambito per team o per progetto non è disponibile.
3

Comunica ai membri cosa aspettarsi

La prima volta che un membro visualizza o controlla una nuova sessione Remote Control da un browser, telefono o app desktop dopo l’abilitazione dell’impostazione, gli viene chiesto di registrare quel dispositivo. Informarli in anticipo evita confusione.

​
Cosa vedono i membri

La registrazione è un passaggio una tantum per dispositivo. Dopo di che, l’unico cambiamento visibile è un occasionale prompt biometrico.
  • Primo utilizzo su ogni dispositivo: al membro viene chiesto di registrarsi. Se il suo accesso non è recente, accede prima attraverso il tuo flusso normale, incluso SSO se configurato, quindi conferma la registrazione.
  • Giorno per giorno: i membri con un dispositivo registrato e un accesso recente non vedono prompt. Quando l’accesso invecchia oltre 18 ore, la prossima interazione Remote Control mostra un singolo prompt Face ID, Touch ID, Windows Hello o passkey.
  • Dispositivi non registrati: le sessioni Remote Control non possono essere visualizzate o controllate fino a quando il dispositivo non è registrato. La chat Claude regolare su quel dispositivo non è interessata.
  • Nessun autenticatore di piattaforma: i membri su una macchina senza Face ID, Touch ID o Windows Hello possono utilizzare una chiave di sicurezza hardware, o accedere di nuovo invece di eseguire l’autenticazione.
  • Nel terminale: la macchina che esegue Claude Code riceve le proprie credenziali automaticamente quando lo sviluppatore accede alla CLI. Non c’è un passaggio di registrazione separato nel terminale.

​
Gestisci i dispositivi registrati

I membri possono rivedere e revocare i propri dispositivi dalle impostazioni dell’account. Apri claude.ai/settings/account e trova la sezione Trusted devices per vedere ogni dispositivo registrato con il suo nome, piattaforma e data di registrazione. La rimozione di un dispositivo revoca immediatamente le sue credenziali, e il dispositivo può registrarsi di nuovo in seguito dopo un accesso aggiornato. Le credenziali scadono anche da sole se non rinnovate, quindi un dispositivo inutilizzato cade automaticamente dall’elenco affidabile. Per un dispositivo perso o rubato, il membro lo rimuove da questa pagina. Se il membro non riesce ad accedere, un amministratore può utilizzare Sign out everywhere nella console di amministrazione per revocare ogni sessione e dispositivo registrato per quel membro, dopo di che il membro registra di nuovo i dispositivi che ancora possiede.

​
Remote Control vs Claude Code sul web

Remote Control e Claude Code sul web utilizzano entrambi l’interfaccia claude.ai/code. La differenza chiave è dove viene eseguita la sessione: Remote Control viene eseguito sulla tua macchina, quindi i tuoi server MCP locali, strumenti e configurazione del progetto rimangono disponibili. Claude Code sul web viene eseguito nel cloud. Utilizza Remote Control quando sei nel mezzo di un lavoro locale e vuoi continuare da un altro dispositivo. Utilizza Claude Code sul web quando vuoi avviare un’attività senza alcuna configurazione locale, lavorare su un repository che non hai clonato, o eseguire più attività in parallelo.

​
Notifiche push mobili

Quando Remote Control è attivo, Claude può inviare notifiche push al tuo telefono. Claude decide quando inviare una notifica. Tipicamente ne invia una quando un’attività a lunga esecuzione termina o quando ha bisogno di una decisione da te per continuare. Puoi anche richiedere una notifica nel tuo prompt, ad esempio notify me when the tests finish. Oltre ai due interruttori on/off qui sotto, non c’è configurazione per evento. Per configurare le notifiche push mobili:
1

Installa l'app Claude per dispositivi mobili

Scarica l’app Claude per iOS o Android.
2

Accedi con il tuo account Claude Code

Utilizza lo stesso account e organizzazione che usi per Claude Code nel terminale.
3

Consenti le notifiche

Accetta il prompt di autorizzazione delle notifiche dal sistema operativo.
4

Abilita push in Claude Code

Nel tuo terminale, esegui /config e abilita Push when Claude decides per notifiche proattive, Push when actions required per prompt di autorizzazione e domande, o entrambi.
Se le notifiche non arrivano:
  • Se /config mostra No mobile registered, apri l’app Claude sul tuo telefono in modo che possa aggiornare il suo token push. L’avviso si cancella la prossima volta che Remote Control si connette.
  • Su iOS, le modalità Focus e i riepiloghi delle notifiche possono sopprimere o ritardare le notifiche push. Controlla Impostazioni → Notifiche → Claude.
  • Su Android, l’ottimizzazione aggressiva della batteria può ritardare la consegna. Escludi l’app Claude dall’ottimizzazione della batteria nelle impostazioni di sistema.
Claude Code salta le notifiche push mobili mentre stai digitando o sei concentrato sul terminale connesso. A partire da v2.1.181, puoi impostare CLAUDE_CLIENT_PRESENCE_FILE su un percorso di file marcatore per estendere questo a qualsiasi momento in cui sei alla macchina, anche in un’altra finestra: le notifiche vengono saltate mentre il file esiste. Configura un listener di blocco dello schermo o uno strumento simile per creare il file quando lo schermo si sblocca ed eliminarlo quando lo schermo si blocca.

​
Limitazioni

  • Una sessione remota per processo interattivo: al di fuori della modalità server, ogni istanza di Claude Code supporta una sessione remota alla volta. Utilizza la modalità server per eseguire più sessioni simultanee da un singolo processo.
  • Il processo locale deve continuare a funzionare: Remote Control viene eseguito come processo locale. Se chiudi il terminale, esci da VS Code, o altrimenti interrompi il processo claude, la sessione va offline finché non la ripristini. A meno che Claude non sia nel mezzo di un’attività, claude.ai e l’app Claude mostrano la sessione come offline entro pochi secondi dopo l’uscita del processo. Per mantenere una sessione in esecuzione su una macchina remota dopo la disconnessione da SSH, avviala all’interno di tmux o screen.
  • Sessioni bloccate in modalità server: se una sessione servita da claude remote-control si blocca, inviale un messaggio da un dispositivo connesso. Claude Code la serve di nuovo. Non è necessario riavviare il server. Richiede Claude Code v2.1.238 o successivo.
  • Rifiuti HTTP 403 su una sessione connessa: una volta che una sessione interattiva è connessa, Claude Code continua a riprovare per un massimo di tre minuti quando qualcosa tra la tua macchina e i server di Anthropic risponde con HTTP 403, come può accadere dopo un cambio VPN o di rete. Se i rifiuti durano più a lungo, Claude Code si disconnette e il motivo indica cosa ha rifiutato: un edge di rete, o un proxy, VPN o firewall sulla tua rete.
  • Interruzione di rete prolungata: se la tua macchina è accesa ma non riesce a raggiungere la rete, quello che fai dopo dipende dalla modalità:
    • Modalità server: Claude Code rinuncia dopo circa 10 minuti e il processo claude remote-control esce. Esegui di nuovo claude remote-control per avviare una nuova sessione.
    • Sessione interattiva: continua a lavorare localmente. Claude Code continua a riprovare finché dura l’interruzione e si riconnette automaticamente quando la rete ritorna.
  • Heartbeat di presenza non riusciti: se una sessione interattiva si disconnette con could not reach the Remote Control server for about 30 minutes, esegui /remote-control per riconnetterti. Claude Code mostra questo messaggio solo quando gli heartbeat di presenza della sessione non hanno funzionato mentre il resto della connessione è rimasto attivo; registra di nuovo la sessione per circa 30 minuti prima di disconnettersi.
  • Dialoghi inoltrati scadono: Claude Code mantiene aperti i prompt di autorizzazione e le domande AskUserQuestion finché non le rispondi. Quando Claude Code inoltra un altro tipo di dialogo alla sessione remota, come il prompt di scelta del modello mostrato dopo un rifiuto di sicurezza, attende cinque minuti per impostazione predefinita, quindi chiude il dialogo e continua con il valore predefinito senza azione del dialogo. Imposta dialogExpiry per regolare o disabilitare la scadenza. Richiede Claude Code v2.1.224 o successivo.
  • Il prompt di consenso dei crediti di utilizzo Fable non viene inoltrato: Claude Code mostra il prompt di consenso dei crediti di utilizzo Fable a metà sessione solo dove viene eseguita la sessione, non sul tuo dispositivo. Quando la sessione viene eseguita in un terminale e nessuno lì risponde prima che Claude Code chiuda il prompt, il turno termina senza inviare la richiesta; vedi Il prompt per confermare non ha ricevuto risposta.
  • Alcuni comandi sono solo locali: i comandi che funzionano solo nell’interfaccia del terminale, come /plugin o /resume, funzionano solo dalla CLI locale, indipendentemente dal fatto che tu passi un argomento o meno. I seguenti funzionano da mobile e web:
    • Comandi con output di testo: /compact, /clear, /context, /usage, /exit, /usage-credits, /recap e /reload-plugins. /usage-credits stampa l’URL di fatturazione invece di aprire un browser. /reload-plugins funziona solo quando la sessione viene eseguita in un terminale interattivo; una sessione senza uno lo rifiuta.
    • /model, /effort, /fast, /color e /rename: passa il valore come argomento, ad esempio /model sonnet o /effort high. Da mobile e web, /model e /effort accettano l’argomento al posto del selettore del terminale o del cursore.
    • /mcp: dall’app mobile, restituisce un riepilogo testuale dello stato del server invece di aprire il selettore. Sul web, /mcp da solo apre una directory dei connettori claude.ai invece di restituire il riepilogo. I sottocomandi reconnect, enable e disable funzionano da entrambi. A differenza della CLI locale, /mcp reconnect senza nome del server riconnette ogni server che ha avuto un errore o necessita autenticazione.
    • /config, dalla v2.1.181: dall’app mobile, passa key=value per impostare un’impostazione, o eseguilo senza argomenti per elencare le chiavi che puoi impostare. Sul web, /config apre la sezione Claude Code delle tue impostazioni, e ignora il testo dopo il comando.
    • Su Team ed Enterprise, /usage-credits da mobile o web non invia una richiesta di crediti di utilizzo al tuo amministratore. L’invio richiede una conferma che appare solo nella CLI interattiva, quindi il comando ti dice di eseguirlo lì. Prima della v2.1.211, il modulo di testo inviava la richiesta senza conferma.
    • /autocompact, dalla v2.1.221: passa la dimensione della finestra come argomento, ad esempio /autocompact 500k. Senza argomenti, stampa la dimensione della finestra corrente come testo invece di aprire il dialogo che il comando mostra in una sessione di terminale.
    • /advisor, dalla v2.1.260: passa il modello come argomento, ad esempio /advisor opus, o passa off per disattivare l’advisor. Entrambi i moduli si applicano solo alla sessione corrente e lasciano invariato il tuo valore predefinito salvato. Senza argomenti, stampa l’advisor corrente come testo invece di aprire il selettore.

​
Risoluzione dei problemi

​
“Remote Control requires a claude.ai subscription”

Non sei autenticato con un account claude.ai, oppure un’altra credenziale sta prendendo precedenza sul tuo accesso. Il messaggio assume una di queste forme:
  • Non connesso, da /remote-control o --remote-control: Remote Control requires a claude.ai subscription.
  • Non connesso, da claude remote-control: You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.
  • Connesso, ma una chiave API o un token è in uso: Remote Control requires claude.ai subscription auth. seguito dalla credenziale in uso, come ANTHROPIC_API_KEY is set, so this session is using API-key auth. Un’impostazione apiKeyHelper e ANTHROPIC_AUTH_TOKEN sono denominate allo stesso modo.
Esegui claude auth login e scegli l’opzione claude.ai. Se il messaggio nomina ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN, rimuovilo ovunque sia impostato: il tuo ambiente shell o il blocco env di un file di impostazioni. Se nomina apiKeyHelper, rimuovi quella impostazione. Prima della v2.1.206, l’esecuzione di /remote-control mentre non eri connesso segnalava Unknown command: /remote-control invece di questo messaggio.

​
“Remote Control requires a full-scope login token”

Sei autenticato con un token di lunga durata da claude setup-token o dalla variabile di ambiente CLAUDE_CODE_OAUTH_TOKEN. Questi token possono solo effettuare richieste di modello, quindi non possono stabilire sessioni Remote Control. Esegui claude auth login per autenticarti con un token di sessione a scopo completo.

​
“Unable to determine your organization for Remote Control eligibility”

Le informazioni dell’account memorizzate nella cache sono obsolete o incomplete. Esegui claude auth login per aggiornarle.

​
“Remote Control isn’t enabled for this account”

Claude Code ha verificato la disponibilità di Remote Control per l’account con cui sei autenticato e il controllo è risultato disabilitato. La causa più comune è la cache dei diritti che è obsoleta dopo un cambio di piano. Esegui claude auth logout quindi claude auth login per aggiornarli, e aggiorna Claude Code se stai utilizzando una versione precedente. Esegui claude doctor per vedere quale controllo di idoneità individuale ha fallito. I conflitti delle variabili di ambiente, i controlli non raggiungibili e l’impostazione Remote Control della tua organizzazione producono ciascuno il proprio messaggio, quindi questo errore significa il controllo a livello di account stesso. Prima della v2.1.239, questo messaggio diceva “Remote Control is not yet enabled for your account”. Prima della v2.1.154, una variabile che disabilita la valutazione dei feature-flag, come DISABLE_TELEMETRY o DO_NOT_TRACK, produceva anche questo messaggio; la voce “Remote Control requires feature-flag evaluation” di seguito copre quella configurazione.

​
“Couldn’t verify Remote Control eligibility”

Claude Code non ha potuto raggiungere il servizio di feature-flag per verificare se Remote Control è abilitato per il tuo account, in genere perché sei offline o un proxy sta bloccando la richiesta. Riprova una volta che hai accesso alla rete, oppure esegui claude doctor per i dettagli. Il messaggio correlato “Couldn’t verify your organization’s Remote Control policy” ha la stessa causa e la stessa soluzione. Entrambi i messaggi sono stati aggiunti nella v2.1.178.

​
“Remote Control requires feature-flag evaluation”

Una di queste variabili è impostata: DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, o DISABLE_GROWTHBOOK. Ognuna di esse disabilita la valutazione dei feature-flag da cui dipende la disponibilità di Remote Control, e il messaggio completo nomina la variabile che Claude Code ha trovato. Annulla l’impostazione di quella variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco env di un file settings.json. Nelle versioni precedenti alla 2.1.154, la stessa configurazione produce “Remote Control is not yet enabled for your account” invece.

​
“Remote Control is only available when using Claude via api.anthropic.com”

La sessione non sta comunicando direttamente con l’API Anthropic, quindi non c’è alcun backend claude.ai con cui associarsi. Questo accade su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry. Accade anche quando ANTHROPIC_BASE_URL punta a un host diverso da api.anthropic.com, come un gateway LLM o proxy, anche se accedi con claude.ai. Prima della v2.1.196, Claude Code non mostrava questo messaggio per un ANTHROPIC_BASE_URL personalizzato. Vedi il riferimento degli errori per l’elenco completo delle cause. Il messaggio nomina cosa ha instradato la sessione lontano dall’API Anthropic, come CLAUDE_CODE_USE_BEDROCK o un ANTHROPIC_BASE_URL personalizzato. Se hai un accesso claude.ai idoneo, annulla l’impostazione della variabile denominata, rimuovila dalla chiave env nelle impostazioni se l’hai impostata lì, e riavvia la sessione. Prima della v2.1.219, il messaggio era solo la frase nell’intestazione di questa sezione, quindi nelle versioni precedenti controlla il tuo ambiente stesso per le variabili del provider come CLAUDE_CODE_USE_BEDROCK e CLAUDE_CODE_USE_VERTEX, e per ANTHROPIC_BASE_URL.

​
“Remote Control is disabled by your organization’s policy”

Una politica blocca Remote Control, oppure Claude Code non ha potuto caricare la politica della tua organizzazione su questa macchina e mantiene Remote Control disabilitato nel frattempo. Controlla queste cause in ordine:
  • L’errore menziona disableRemoteControl: il tuo amministratore IT ha disabilitato Remote Control su questo dispositivo tramite impostazioni gestite, indipendentemente dall’interruttore a livello di organizzazione e da come sei autenticato.
  • Il tuo piano claude.ai è Pro o Max: Claude Code è ancora autenticato con un’organizzazione Team o Enterprise da un accesso precedente, quindi controlla la politica Remote Control di quell’organizzazione. Esegui /status per vedere quale piano e organizzazione usa il tuo accesso. Esegui claude auth logout quindi claude auth login per accedere di nuovo con il tuo piano attuale.
  • La politica dell’organizzazione non è stata caricata su questa macchina: esegui claude doctor e leggi la riga Organization policy. Se la riga mostra che la politica non è caricata, è quello che mantiene Remote Control disabilitato. Prima della v2.1.261, claude doctor non stampava questa riga.
  • Il messaggio non dice di contattare l’amministratore della tua organizzazione: la tua organizzazione ha una configurazione HIPAA incompatibile con Remote Control, e /status elenca HIPAA nella sua riga Compliance. In questo stato l’interruttore Remote Control del pannello di amministrazione è disattivato, quindi un Owner non può modificarlo lì. Contatta il supporto Anthropic per discutere le opzioni. Prima della v2.1.267, questo caso mostrava “Remote Control isn’t available for your organization due to its compliance policy” invece.
  • Altrimenti, un Owner non l’ha abilitato per la tua organizzazione: Remote Control è disabilitato per impostazione predefinita su piani Team e Enterprise. Un Owner può abilitarlo su claude.ai/admin-settings/claude-code attivando l’interruttore Remote Control. Questo interruttore è un’impostazione organizzativa lato server.

​
“Remote credentials fetch failed”

Claude Code non ha potuto ottenere una credenziale di breve durata dall’API Anthropic per stabilire la connessione. Esegui di nuovo con --verbose per vedere l’errore completo:
Cause comuni:
  • Non sei connesso: esegui claude e utilizza /login per autenticarti con il tuo account claude.ai. L’autenticazione con chiave API non è supportata per Remote Control.
  • Problema di rete o proxy: un firewall o proxy potrebbe bloccare la richiesta HTTPS in uscita. Remote Control richiede l’accesso all’API Anthropic sulla porta 443.
  • Creazione della sessione non riuscita: se vedi anche Session creation failed — see debug log, l’errore si è verificato in precedenza nella configurazione. Verifica che il tuo abbonamento sia attivo.
Un token di accesso obsoleto non causa questo errore. Quando l’API Anthropic rifiuta il token salvato, ad esempio perché un altro processo Claude Code l’ha già aggiornato, Claude Code aggiorna il token e riprova da solo. Prima della v2.1.224, un token obsoleto non riusciva ad avviare Remote Control con questo messaggio, quindi le sessioni impostate per connettersi automaticamente potevano non riuscire intermittentemente all’avvio.

​
“Couldn’t reconnect to your Remote Control session”

Quando riprendi una conversazione con claude --resume o claude --continue, Claude Code si riconnette alla sessione Remote Control registrata in quella conversazione. Questo messaggio significa che la riconnessione non è riuscita per un motivo che potrebbe essere temporaneo, come un’interruzione di rete o un errore del server, quindi Claude Code non può confermare se la sessione remota esiste ancora. Esegui /remote-control per riprovare la connessione, o avvia una nuova sessione con claude --remote-control per creare una nuova sessione Remote Control. La tua sessione locale continua a funzionare senza Remote Control nel frattempo. Quando riprendi, puoi anche ottenere uno di questi risultati invece di questo messaggio:
  • Il server segnala che la sessione registrata è scomparsa, oppure il record di riconnessione nomina un account diverso: Claude Code si basa su quello che dice il record di riconnessione della conversazione:
    • Il record nomina il tuo account autenticato: Claude Code avvia una sessione sostitutiva con un nome generato automaticamente e lascia i messaggi precedenti della conversazione fuori da essa. Ottieni questo dopo aver eliminato la sessione da claude.ai o dall’app Claude, ad esempio.
    • Il record nomina un account diverso: Claude Code avvia una nuova sessione senza i messaggi precedenti della conversazione e senza mostrare un messaggio, indipendentemente dal fatto che la sessione registrata esista ancora.
    • Il record non dice quale account possedeva la sessione, oppure Claude Code non può leggere il tuo accesso salvato: Claude Code mostra Previous session is unavailable — run /remote-control to start a new one invece di questo messaggio, non avvia nulla, e rimuove il record dalla conversazione.
  • Hai disattivato Remote Control prima di riprendere: a meno che l’app che ospita Claude Code non gli abbia detto che l’app possiede la sessione claude.ai, Claude Code ha rimosso il record di riconnessione quando hai disattivato Remote Control dal pannello di stato della CLI, dall’estensione VS Code, o da un host costruito su Agent SDK, quindi non si riconnette. Quando un’app proprietaria l’ha disattivato, Claude Code ha mantenuto il record e si riconnette.
  • Un altro Claude Code su questa macchina ha ancora la sessione: vedi un avviso che inizia con Remote Control not started here, e Claude Code lascia Remote Control disabilitato nella sessione ripresa. Esegui /remote-control lì per spostarlo.
Prima della v2.1.232, Claude Code ha risposto diversamente quando il server ha segnalato che la sessione registrata era scomparsa. Dalla v2.1.227 alla v2.1.231, Claude Code ha rifiutato di avviare una sostituzione anche quando il record corrispondeva al tuo account. Fino alla v2.1.226, Claude Code ha avviato una sostituzione indipendentemente dal fatto che il record corrispondesse al tuo account, e nella v2.1.224 fino alla v2.1.226 l’ha creata con l’account autenticato su quella macchina, mai con un altro account, senza caricare i messaggi precedenti della conversazione su di essa. Prima della v2.1.200, Claude Code ha creato una nuova sessione dopo qualsiasi errore di riconnessione.

​
“Previous session is unavailable — run /remote-control to start a new one”

Claude Code non ha potuto ripristinare la sessione Remote Control precedente e si è fermato invece di avviare una nuova da solo. Puoi vedere questo messaggio dopo aver ripreso una conversazione con claude --resume o claude --continue, oppure dopo che Claude Code si è riconnesso da solo dopo una disconnessione. Esegui /remote-control per avviare una nuova sessione Remote Control con l’accesso attuale; la tua sessione locale continua a funzionare senza Remote Control nel frattempo. Il messaggio correlato Remote Control could not verify the signed-in account — run /remote-control to reconnect ha la stessa soluzione; Claude Code lo mostra quando l’account autenticato è cambiato o non poteva essere letto tra la sua convalida e la riconnessione. Se esegui /remote-control dopo Previous session is unavailable senza riavviare Claude Code prima, Claude Code lascia i messaggi precedenti della conversazione fuori dalla nuova sessione. Al ripristino, Claude Code avvia una nuova sessione al suo posto solo se il record di riconnessione della conversazione nomina l’account che possedeva la sessione, perché il server segnala una sessione che hai eliminato e una sessione posseduta da un altro account allo stesso modo. Claude Code prima della v2.1.227 non ha registrato quell’account, e Claude Code non può controllare il record quando non può leggere il tuo accesso salvato. Claude Code prima della v2.1.232 mostrava Remote Control could not resume the previous session under the current login — run /remote-control to start fresh invece, in un diverso insieme di casi.

​
“Remote Control got an unexpected server response”

Il server Remote Control ha accettato una richiesta ma ha risposto in una forma che questa versione di Claude Code non poteva leggere, durante la creazione della sessione remota o il recupero delle sue credenziali. Riprovare sulla stessa versione fallisce allo stesso modo. Esegui claude update, quindi esegui /remote-control per riconnetterti. Questo messaggio è stato aggiunto nella v2.1.225.

​
“Your organization requires Trusted Devices for Remote Control, but this device is not enrolled”

La tua organizzazione ha Trusted Devices abilitato e questa macchina non si è ancora registrata. Esegui /login in Claude Code. La registrazione avviene come parte dell’accesso, e non c’è un comando di registrazione separato.

​
“session expired for trusted-device check”

Il tuo accesso è più vecchio di 18 ore. Esegui /login in Claude Code, o conferma con Face ID, Touch ID, Windows Hello, o una passkey quando claude.ai o l’app mobile te lo chiede. Vedi Trusted Devices.

​
Scegli l’approccio giusto

Claude Code offre diversi modi di lavorare quando non sei al tuo terminale. Differiscono in ciò che attiva il lavoro, dove Claude viene eseguito e quanto setup è necessario.
  • Claude Code sul web: esegui sessioni nel cloud invece che sulla tua macchina, configurate tramite ambienti cloud
  • Messaggistica tra sessioni: consenti a Claude di inviare messaggi alle tue sessioni su altre macchine o su Claude Code sul web
  • Canali: inoltra Telegram, Discord o iMessage in una sessione in modo che Claude reagisca ai messaggi mentre sei assente
  • Dispatch: invia un’attività dal tuo telefono e può generare una sessione Desktop per gestirla
  • Autenticazione: configura /login e gestisci le credenziali per claude.ai
  • Riferimento CLI: elenco completo di flag e comandi incluso claude remote-control
  • Sicurezza: come le sessioni Remote Control si adattano al modello di sicurezza di Claude Code
  • Utilizzo dei dati: quali dati fluiscono attraverso l’API Anthropic durante le sessioni locali e remote