- 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.
claude deve continuare a funzionare.
Remote Control è una funzionalità di Claude Code. Per le conversazioni in altri prodotti Claude, consulta il Claude Help Center.
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.
- Ruoli personalizzati: se la tua organizzazione Enterprise gestisce il tuo accesso con ruoli personalizzati, i tuoi ruoli devono concederti sia il permesso per le sessioni cloud sia il permesso Claude Code remote control. Se manca uno dei due, l’avvio di Remote Control mostra
Remote Control is disabled by your organization's policy. Chiedi a un Owner di verificare i tuoi ruoli e di aggiungere ciò che manca in Organization settings > Roles. - Autenticazione: esegui
claudee utilizza/loginper accedere tramite claude.ai se non l’hai già fatto. Senza un accesso idoneo,claude remote-controlesce con un errore, mentreclaude --remote-controlavvia 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_URLa un host diverso daapi.anthropic.com, come un gateway LLM o proxy. Annulla l’impostazione della variabile per utilizzare Remote Control. - Accedi tramite un gateway di app Claude aziendale.
- Valutazione dei flag di funzionalità: se imposti una variabile d’ambiente che disattiva la valutazione dei flag di funzionalità, la disponibilità di Remote Control dipende da quale:
- Se imposti
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_GROWTHBOOK, Remote Control non è disponibile. Annulla l’impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel bloccoenvdi un filesettings.json, per utilizzare Remote Control. - Se imposti solo
DISABLE_TELEMETRYoDO_NOT_TRACK, Remote Control rimane disponibile a meno che la tua organizzazione non richieda Dispositivi affidabili. Se lo richiede, annulla l’impostazione della variabile per utilizzare Remote Control. L’utilizzo di Remote Control con una di queste variabili impostate richiede Claude Code v2.1.283 o successivo, oppure v2.1.304 o successivo nell’app Claude Desktop.
- Se imposti
- Fiducia dell’area di lavoro: in una directory che non hai ancora considerato attendibile,
claude remote-controlstampa ciò che considerare attendibile attiva e chiedeTrust <directory>? [y/N]prima di avviarsi. Rispondendoysalva la scelta, tranne nella tua directory home, dove la fiducia non viene mai salvata e la domanda ritorna ad ogni esecuzione. Quando il suo input o output standard non è un terminale, il comando non può chiedere ed esce con un erroreWorkspace not trusted.
Avviare una sessione Remote Control
È possibile avviare una sessione Remote Control dalla CLI, dall’app Claude Desktop o dall’estensione VS Code. La CLI offre tre modalità di invocazione; l’app Desktop e VS Code utilizzano il comando/remote-control.
- Modalità server
- Sessione interattiva
- Da una sessione esistente
- VS Code
- App Desktop
Nella directory del progetto, eseguire:Fino a quando non si accetta 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. Rispondere y per accettare e avviare il server. Se si rifiuta, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che si esegue il comando.Il processo rimane in esecuzione nel terminale in modalità server, in attesa di connessioni remote. Visualizza un URL di sessione che è possibile utilizzare per connettersi da un altro dispositivo, e si può premere la barra spaziatrice per visualizzare un codice QR per un accesso rapido dal telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l’attività degli strumenti.Passare uno qualsiasi di questi flag dopo remote-control:Se si passa 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 consente il flag solo quando è noto che eliminarlo non cambia ciò che quelle sessioni possono fare, come --verbose o --model. Per qualsiasi altro flag, come --settings, Claude Code rifiuta di avviarsi e nomina il flag da rimuovere.Per eseguire il sandbox delle sessioni che il server avvia, attivare il sandboxing in un file di impostazioni.Per stampare i flag di remote-control nel terminale, esegui claude remote-control --help. Prima della v2.1.302, senza un accesso idoneo il comando restituiva invece uno degli errori elencati in Risoluzione dei problemi.Verificare lo stato della connessione
In una sessione interattiva, mentre Remote Control è connesso, il terminale mostra un indicatore/rc active che si collega alla sessione su claude.ai. L’indicatore è nascosto quando il terminale è troppo stretto per contenerlo. Per visualizzare l’URL della sessione e un codice QR per connettersi da un altro dispositivo, eseguire /remote-control di nuovo per aprire il pannello di stato. Il pannello ti consente anche di disconnettere Remote Control mentre la sessione locale continua a funzionare.
Se la connessione non riesce in una sessione interattiva, l’indicatore cambia per mostrare l’errore, e Claude Code mostra il motivo in una notifica e lo aggiunge alla conversazione. Eseguire /remote-control per riconnettersi, a meno che il motivo non dica che la sessione è cambiata da qualche altra parte:
- Another connection took over this session: un altro dispositivo o una sessione Claude Code lo ha ora. Eseguire
/remote-controlsolo se si vuole riprenderselo. - This session was ended or archived from another device or app: eseguire
/remote-controlsolo se si vuole la sessione indietro. Claude Code riapre una sessione archiviata. - The server no longer reports this session: potrebbe essere stato eliminato da un altro dispositivo o app.
Connettersi 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, premere 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 del computer con un punto di stato verde quando sono online.
- Il nome che hai passato a
--name,--remote-controlo/remote-control - Il titolo che hai impostato con
/rename - L’ultimo messaggio significativo nella cronologia della conversazione esistente
- Un nome generato automaticamente come
myhost-graceful-unicorn, dovemyhostè il nome host della tua macchina o il prefisso che hai impostato con--remote-control-session-name-prefix
claude --resume.
Se non hai ancora l’app Claude, esegui /mobile all’interno di Claude Code per visualizzare un codice QR per claude.ai/mobile, che apre il negozio di app corretto per il tuo telefono.
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 l’avanzamento 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 a cui è stato passato 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/resumenel tuo terminale e torna indietro. - Estrazione di una sessione con
/teleport: quando estrai una sessione cloud 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 la messaggistica tra sessioni, la stessa connessione trasporta messaggi tra le tue sessioni su macchine diverse.
- Diff delle tue modifiche: quando la directory della sessione si trova in un repository git, il pannello diff di un dispositivo connesso mostra le tue modifiche. Su un ramo che ha commit davanti al ramo predefinito del repository, il pannello mostra le modifiche da quando il ramo si è separato da esso, incluse le tue modifiche non sottoposte a commit. Sul ramo predefinito stesso, o su un ramo che non è davanti a esso, il pannello mostra solo le tue modifiche non sottoposte a commit.
- Modello: quando scegli un modello da un dispositivo connesso, Claude Code esegue la sessione su 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 valore predefinito per le nuove sessioni. - Livello di sforzo: quando imposti il livello di sforzo da un dispositivo connesso, con
/efforto il controllo dello sforzo del dispositivo, Claude Code lo applica alla sessione sulla tua macchina. Se hai fissato un livello conCLAUDE_CODE_EFFORT_LEVEL, la sessione mantiene quel livello, e Claude Code rifiuta una scelta diversa dal controllo dello sforzo. La scelta di 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-controlper riconnetterti. Se nel frattempo la compattazione ha riscritto la conversazione o hai cambiato conversazione con/resume, Claude Code archivia la sessione del server che stava utilizzando invece di lasciarla nell’elenco delle sessioni. Puoi comunque trovare quella sessione tra le tue sessioni archiviate su claude.ai/code. Cambiare conversazione mentre un dispositivo è ancora connesso non archivia la sessione.
Abilitare Remote Control per tutte le sessioni
Remote Control si attiva solo quando esegui esplicitamenteclaude remote-control, claude --remote-control o /remote-control, a meno che la connessione automatica non sia attivata. Per attivare la connessione automatica 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 la connessione automatica, anche se untruedalle impostazioni gestite lo supera, perché Claude Code salva la scelta nelle tue impostazioni utente. Unfalsenelle impostazioni di progetto o locali (.claude/settings.json,.claude/settings.local.json) disattiva la connessione automatica anche su untruegestito.default: cancella la tua scelta e segui il valore predefinito dell’amministratore della tua organizzazione se ne è stato impostato uno, altrimenti il valore predefinito attuale di Claude Code. Se impostiDISABLE_TELEMETRYoDO_NOT_TRACK, consulta Connessione automatica conDISABLE_TELEMETRYoDO_NOT_TRACKimpostati.
- Estensione VS Code: Enable Remote Control for all sessions nella sezione Settings del menu dei comandi.
- App Desktop: Connect new sessions to Remote Control in Settings > Code o Settings > Claude Code. Consulta Controllare quali sessioni appaiono sugli altri dispositivi.
remoteControlAtStartup su 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 la connessione automatica per quel repository, ma ignora un true, quindi un file archiviato non può attivare Remote Control per tutti coloro che aprono il repository.
La connessione automatica accede con il tuo account claude.ai, quindi una sessione che avvia appare solo nei tuoi account Claude app e non concede a nessun altro l’accesso.
Con questa impostazione attivata, 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.
Connessione automatica con DISABLE_TELEMETRY o DO_NOT_TRACK impostati
Con solo DISABLE_TELEMETRY o DO_NOT_TRACK impostati, le tue sessioni non si connettono automaticamente tramite il valore predefinito dell’amministratore della tua organizzazione o il valore predefinito di Claude Code. Se qualcos’altro rende Remote Control non disponibile per te, come DISABLE_GROWTHBOOK o un gateway LLM, parti invece da Requisiti.
Prima di attivare la connessione automatica con solo DISABLE_TELEMETRY o DO_NOT_TRACK impostati, verifica che la tua versione di Claude Code soddisfi il requisito per queste variabili. Poi verifica se la tua organizzazione richiede i Trusted Devices:
- Non richiesti: imposta Enable Remote Control for all sessions su
truein/config. - Richiesti: Remote Control non è disponibile mentre
DISABLE_TELEMETRYoDO_NOT_TRACKè impostato. Rimuovi quella delle due variabili che hai impostato. Se le tue sessioni continuano a non connettersi automaticamente, imposta Enable Remote Control for all sessions sutruein/config.
Riprendere le sessioni dopo l’arresto del server
Quando arresticlaude 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 ripristinarle, esegui uno di questi comandi nella stessa directory:
claude remote-control: ripristina ogni sessione che il server stava servendo.claude remote-control --continue: ripristina solo la sessione che il server ha avviato, ed esce quando quella sessione termina. Se questa directory non ha un record, Claude Code utilizza la più recente dai worktree git di questo repository.claude remote-control --session-id <id>: ripristina 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?.
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 ripristinare una sessione che hai avviato con claude --remote-control o /remote-control, riprendi la conversazione con claude --continue o claude --resume. Per la modalità di permesso con cui si avvia la conversazione ripresa, consulta modalità di permesso alla ripresa. Se Remote Control non si riconnette, consulta Couldn’t reconnect to your Remote Control session.
Se riprendi la conversazione in un secondo terminale mentre il primo ha ancora Remote Control attivo, Claude Code stampa un avviso Remote Control not started here nel secondo terminale e lascia Remote Control disattivato lì invece di prendere la sessione dal primo. Esegui /remote-control nel secondo terminale per spostare Remote Control su di esso.
Quando riprendi una conversazione in Claude Desktop o in 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.
Impostare la modalità di spawn predefinita per un progetto
Seclaude remote-control stampa Spawn mode: <mode> (saved for this folder; press w to change) all’avvio, il server si sta avviando in una modalità di spawn salvata in precedenza per questo progetto.
La modalità salvata deriva da una scelta che hai fatto nel tuo terminale. Se lì claude remote-control ti ha chiesto Spawn mode for this project:, Claude Code ha conservato ciò che hai risposto: 1 per same-dir o 2 per worktree. Se hai premuto w durante l’esecuzione, Claude Code ha conservato la modalità a cui sei passato, anche in un’esecuzione avviata con --spawn same-dir o --spawn worktree.
- Mentre il server è in esecuzione in modalità
same-diroworktree, premiwnel terminale del server per passare all’altra. Il cambio richiede un repository git o un hookWorktreeCreate. - Per usare una modalità diversa per una singola esecuzione, passa
--spawn <mode>.
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. 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’impostazionedisableRemoteControl. Le organizzazioni con Zero Data Retention abilitato, o con la configurazione HIPAA applicata, 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 Pro, Max, Team ed Enterprise ed è disabilitato per impostazione predefinita. Su piani Team ed Enterprise, un Owner lo abilita per l’organizzazione. Su piani Pro e Max, Lei abilita Require trusted devices da sola nelle impostazioni, sulla pagina Cowork o Account.
- 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.
Abilita Dispositivi affidabili per un’organizzazione Team o Enterprise
Un Owner abilita l’impostazione dalle impostazioni dell’organizzazione di claude.ai.1
Vai alla pagina Capabilities
Vai a Organization settings > Capabilities > Remote sessions. L’interruttore Require trusted devices appare in quella sezione.
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 sessioni cloud
Remote Control e sessioni cloud utilizzano entrambi l’interfaccia claude.ai/code. La differenza principale è dove viene eseguita la sessione: Remote Control viene eseguito sulla vostra macchina, quindi i vostri server MCP locali, strumenti e configurazione del progetto rimangono disponibili. Una sessione cloud viene eseguita su infrastruttura cloud, gestita da Anthropic per impostazione predefinita. Utilizzate Remote Control quando siete nel mezzo di un lavoro locale e volete continuare da un altro dispositivo. Utilizzate una sessione cloud quando volete avviare un’attività senza alcuna configurazione locale, lavorare su un repository che non avete clonato, o eseguire più attività in parallelo. Un progetto combina i due: i suoi thread vengono eseguiti nel cloud e utilizza Remote Control per eseguire un thread sul vostro computer quando lo richiedete lì. 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.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 parte tua per continuare. Puoi anche richiedere una notifica nel tuo prompt, ad esempionotify me when the tests finish. Oltre ai due interruttori on/off di seguito, non c’è alcuna configurazione per evento.
Per configurare le notifiche push mobili:
2
Accedi con il tuo account Claude Code
Usa 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 le notifiche proattive, Push when actions required per i prompt di autorizzazione e le domande, o entrambi.- Se
/configmostra 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 i 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_CLIENT_PRESENCE_FILE su un percorso di file marcatore: 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 sola sessione remota alla volta. Usa la modalità server per eseguire più sessioni simultanee da un unico processo.
- Il processo locale deve restare in esecuzione: Remote Control viene eseguito come processo locale. Se chiudi il terminale, esci dall’app Desktop o da VS Code che esegue la sessione sulla tua macchina, o interrompi in altro modo il processo
claude, la sessione va offline finché non la riattivi. Se eseguiclaudeda un terminale su una macchina remota, avvialo all’interno ditmuxoscreenper mantenere la sessione in esecuzione dopo la disconnessione da SSH. - Sessioni arrestate in modo anomalo in modalità server: se una sessione servita da
claude remote-controlsi arresta in modo anomalo, inviale un messaggio da un dispositivo connesso. Claude Code la servirà di nuovo. Non devi riavviare il server. Richiede Claude Code v2.1.238 o versioni successive. - 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 di 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, oppure un proxy, una VPN o un firewall sulla tua rete.
- Interruzione prolungata della rete: se la tua macchina è attiva ma non riesce a raggiungere la rete, cosa fare dipende dalla modalità:
- Modalità server: Claude Code rinuncia dopo circa 10 minuti e il processo
claude remote-controltermina. Esegui di nuovoclaude remote-controlper avviare una nuova sessione. - Sessione interattiva: continua a lavorare in locale. Claude Code riprova per tutta la durata dell’interruzione e si riconnette da solo quando la rete torna disponibile.
- Modalità server: Claude Code rinuncia dopo circa 10 minuti e il processo
- Allegati che non vengono scaricati: se un file che alleghi dal telefono o dal browser non può essere scaricato sulla tua macchina, Claude riceve comunque il tuo messaggio e i file che sono stati scaricati. Al posto dei file mancanti, Claude Code aggiunge al messaggio una nota come
[1 of 3 attachments did not arrive]. - Errori degli heartbeat di presenza: se una sessione interattiva si disconnette con
could not reach the Remote Control server for about 30 minutes, esegui/remote-controlper riconnetterti. - Le finestre di dialogo inoltrate scadono: Claude Code mantiene aperte le richieste di permesso e le domande di
AskUserQuestionfinché non rispondi. Quando Claude Code inoltra alla sessione remota un altro tipo di finestra di dialogo, come il prompt di scelta del modello mostrato dopo un rifiuto per motivi di sicurezza, attende cinque minuti per impostazione predefinita, poi chiude la finestra di dialogo e prosegue con l’opzione predefinita senza azione. ImpostadialogExpiryper modificare o disattivare la scadenza. Richiede Claude Code v2.1.224 o versioni successive. - Il prompt di consenso ai crediti di utilizzo di Fable non viene inoltrato: Claude Code mostra il prompt di consenso ai crediti di utilizzo di Fable durante la sessione solo dove la sessione è in esecuzione, non sul tuo dispositivo. Quando la sessione è in esecuzione in un terminale e nessuno risponde lì prima che Claude Code chiuda il prompt, il turno termina senza inviare la richiesta; consulta The prompt to confirm went unanswered.
- Alcuni comandi sono solo locali: i comandi che funzionano solo nell’interfaccia del terminale, come
/plugino/resume, funzionano solo dalla CLI locale, indipendentemente dal fatto che tu passi un argomento. Anche/claude-apinon è disponibile quando lo digiti da mobile o dal web. Claude può comunque caricare quella skill autonomamente in quei contesti. I seguenti funzionano da mobile e dal web:- Comandi con output testuale:
/compact,/clear,/context,/usage,/exit,/usage-credits,/recape/reload-plugins./usage-creditsstampa l’URL di fatturazione invece di aprire un browser./reload-pluginsfunziona solo quando la sessione è in esecuzione in un terminale interattivo; una sessione senza terminale interattivo lo rifiuta. /model,/effort,/fast,/colore/rename: passa il valore come argomento, ad esempio/model sonneto/effort high. Da mobile e dal web,/modele/effortaccettano l’argomento al posto del selettore o del cursore del terminale./mcp: dall’app mobile, restituisce un riepilogo testuale dello stato dei server invece di aprire il selettore. Sul web,/mcpda solo apre una directory di connettori claude.ai invece di restituire il riepilogo. I sottocomandireconnect,enableedisablefunzionano da entrambi quando la sessione è in esecuzione in un terminale interattivo./mcp reconnectsenza nome del server riprova con ogni server che ha avuto un errore o che richiede l’autenticazione. Per autorizzare un connettore claude.ai senza il selettore, consulta Autorizza di nuovo un connettore dalla tua shell./config: dall’app mobile, passakey=valueper definire un’impostazione, oppure eseguilo senza argomenti per elencare le chiavi che puoi impostare. Sul web,/configapre invece Settings > Code o Settings > Claude Code.- Nei piani Team ed Enterprise,
/usage-creditsda mobile o dal 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 indica di eseguirlo lì. /autocompact, dalla v2.1.221: passa la dimensione della finestra come argomento, ad esempio/autocompact 500k. Senza argomenti, stampa come testo la dimensione attuale della finestra invece di aprire la finestra di dialogo che il comando mostra in una sessione del terminale./advisor, dalla v2.1.260: passa il modello come argomento, ad esempio/advisor opus, oppure passaoffper disattivare l’advisor. Entrambe le forme si applicano solo alla sessione corrente e lasciano invariata la tua impostazione predefinita salvata. Senza argomenti, stampa come testo l’advisor attuale invece di aprire il selettore./output-style, dalla v2.1.269: passa il nome dello stile come argomento, ad esempio/output-style concise, oppure eseguilo senza argomenti per elencare gli stili. Da mobile e dal web, puoi elencare e selezionare solo gli stili integrati. Per usare uno stile personalizzato, selezionalo nella sessione stessa./focus, dalla v2.1.281: passaonooffcome argomento, ad esempio/focus on, oppure eseguilo senza argomenti per attivare o disattivare la vista focus. Entrambe le forme si applicano solo alla sessione corrente e lasciano invariata la tua selezione salvata.
- Comandi con output testuale:
Autorizzare di nuovo un connettore dalla tua shell
Quando un connettore di claude.ai richiede l’autenticazione in una sessione che gestisci tramite Remote Control, il pannello/mcp non è disponibile dall’app mobile o dal web. Ottieni il link di autorizzazione da un terminale sulla macchina in cui è in esecuzione la sessione, poi apri il link sul dispositivo che stai usando. Non puoi eseguire il comando dall’app mobile o dal web. Una riga che invii da lì e che inizia con ! arriva a Claude come messaggio e non viene eseguita in modalità shell.
1
Ottieni il link di autorizzazione
In un terminale sulla macchina in cui è in esecuzione la sessione, ad esempio tramite SSH, esegui Il comando stampa un link di claude.ai e termina. Apri il link nel tuo browser e completa l’autorizzazione su claude.ai.
claude mcp login con il nome del connettore tra virgolette. Il nome di un connettore inizia con claude.ai, ad esempio claude.ai Slack per il connettore Slack. Il seguente comando ottiene il link per il connettore Slack:--no-browser impedisce al comando di aprire un browser su quella macchina, che potrebbe non essere il dispositivo che stai usando.2
Usa il connettore in una sessione
Avvia una nuova sessione, oppure riconnetti il connettore nella sessione già in esecuzione:Nel terminale, Claude Code stampa
- Nuova sessione: una sessione che avvii dopo l’autorizzazione si connette al connettore senza ulteriori passaggi.
- Sessione in esecuzione: esegui
/mcp reconnectcon lo stesso nome e senza virgolette, nel prompt di Claude Code oppure dall’app mobile o dal web. Per verificare che la tua sessione accetti il comando da lì, consulta la voce/mcpin quali comandi funzionano da mobile e web.
Successfully reconnected to claude.ai Slack. Dall’app mobile o dal web, la risposta è Reconnected "claude.ai Slack".Troubleshooting
“Remote Control disconnected” or “Can’t reach”
Su claude.ai/code o nell’app Desktop, un messaggio Remote Control disconnected o Can’t reach significa che il tuo browser o la tua app ha perso il contatto con Claude Code sul tuo computer. Nessuno dei due messaggi ti dice se Claude o un subagent che stavi osservando sta ancora lavorando sul tuo computer. Su quel computer, controlla in quale stato si trova Claude Code e segui il passaggio corrispondente per riconnetterti:- Una sessione interattiva mostra
Remote Control disconnected: segui i passaggi di riconnessione per il motivo indicato in quella riga - Claude Code è in esecuzione e non mostra alcun errore: una sessione interattiva si riconnette da sola non appena la macchina è attiva e online, quindi non devi fare nulla. Se hai usato
claude remote-control, consulta Extended network outage in Limitazioni - Claude Code non è in esecuzione: avvialo di nuovo e ripristina la sessione
“Remote Control requires a claude.ai subscription”
Non sei connesso con un account claude.ai, oppure un’altra credenziale sta avendo la precedenza sul tuo accesso. Il messaggio assume una di queste forme:- Disconnesso, da
/remote-controlo--remote-control:Remote Control requires a claude.ai subscription.oppure/remote-control requires a claude.ai subscription. - Disconnesso, 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, comeANTHROPIC_API_KEY is set, so this session is using API-key auth. Un’impostazioneapiKeyHelpereANTHROPIC_AUTH_TOKENsono denominate allo stesso modo.
claude auth login e scegli l’opzione claude.ai. Se il messaggio nomina ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN, rimuovilo ovunque sia impostato: nel tuo ambiente shell o nel blocco env di un file di impostazioni. Se nomina apiKeyHelper, rimuovi quella impostazione.
“Remote Control requires a full-scope login token”
Sei autenticato con un token di lunga durata daclaude setup-token o dalla variabile d’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. Eseguiclaude 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 connesso e il controllo è risultato disattivato. La causa più comune è la memorizzazione nella cache dei diritti che sono obsoleti dopo un cambio di piano. Eseguiclaude auth logout quindi claude auth login per aggiornarli, e aggiorna Claude Code se sei su una versione precedente.
Esegui claude doctor per vedere quale controllo di idoneità individuale ha avuto esito negativo. I conflitti di variabili d’ambiente, i controlli non raggiungibili e l’impostazione Remote Control della tua organizzazione producono ciascuno il proprio messaggio, quindi questo errore significa che il controllo a livello di account stesso.
Prima della v2.1.239, questo messaggio diceva “Remote Control is not yet enabled for your account”.
“Couldn’t verify Remote Control eligibility”
Claude Code non ha potuto raggiungere il servizio 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 eseguiclaude doctor per i dettagli. Il messaggio correlato “Couldn’t verify your organization’s Remote Control policy” significa che Claude Code ha riscontrato un errore nella lettura di quella policy, e ha la stessa soluzione.
“Remote Control requires feature-flag evaluation”
Una variabile d’ambiente che disattiva la valutazione feature-flag è impostata, e il messaggio completo nomina la variabile che Claude Code ha trovato. Nelle versioni precedenti alla 2.1.154, la stessa configurazione produce “Remote Control is not yet enabled for your account” invece. Cosa fare dipende dalla variabile che il messaggio nomina:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_GROWTHBOOK: annulla l’impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel bloccoenvdi un filesettings.json.DISABLE_TELEMETRYoDO_NOT_TRACK: su un piano Pro, Max, Team o Enterprise conDISABLE_GROWTHBOOKnon impostato, queste variabili lasciano Remote Control disponibile a meno che la tua organizzazione non richieda Trusted Devices. Se lo richiede, annulla l’impostazione della variabile ovunque sia impostata per utilizzare Remote Control. Dalla v2.1.154 alla v2.1.282, vedi questo messaggio con una qualsiasi delle due variabili impostata, quindi aggiorna Claude Code a una versione che soddisfi il requisito per queste variabili.
“Remote Control is only available when using Claude via api.anthropic.com”
La sessione non sta comunicando direttamente con l’API Anthropic, il che Remote Control richiede. Questo accade su Amazon Bedrock, su Google Cloud’s Agent Platform e su Microsoft Foundry. Accade anche quandoANTHROPIC_BASE_URL punta a un host diverso da api.anthropic.com, come un LLM gateway o proxy, anche se accedi con claude.ai. Vedi il riferimento degli errori per l’elenco completo delle cause.
Il messaggio nomina ciò che 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.
“Remote Control is disabled by your organization’s policy”
Una policy blocca Remote Control. 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 connesso. - Il tuo piano claude.ai è Pro o Max: Claude Code è ancora connesso con un’organizzazione Team o Enterprise da un accesso precedente, quindi controlla la policy Remote Control di quell’organizzazione. Esegui
/statusper vedere quale piano e organizzazione utilizza il tuo accesso. Eseguiclaude auth logoutquindiclaude auth loginper accedere di nuovo con il tuo piano attuale. - Il messaggio non dice di contattare l’amministratore della tua organizzazione: alla tua organizzazione è applicata la configurazione HIPAA, che disattiva Remote Control. Per verificarlo, esegui
/statuse cercaHIPAAnella rigaOrganization configuration. Un Owner vede l’interruttore Remote Control disattivato in grigio nelle impostazioni di amministrazione e non può attivarlo. Se hai domande sulla configurazione, chiedi a un Owner, che può contattare il team account Anthropic della tua organizzazione. Prima della v2.1.267, questo caso mostrava “Remote Control isn’t available for your organization due to its compliance policy” invece. - Remote Control funziona per altri membri della tua organizzazione ma non per te: se la tua organizzazione Enterprise gestisce il tuo accesso con ruoli personalizzati, la causa possono essere i tuoi ruoli. Remote Control richiede sia il permesso per le sessioni cloud sia il permesso Claude Code remote control. Chiedi a un Owner di verificare se i tuoi ruoli includono entrambi e di aggiungere ciò che manca in Organization settings > Roles.
- Altrimenti, un Owner non l’ha abilitato per la tua organizzazione: Remote Control è disattivato per impostazione predefinita sui piani Team e Enterprise. Un Owner può abilitarlo su claude.ai/admin-settings/claude-code attivando l’interruttore Remote Control. Questo interruttore è un’impostazione dell’organizzazione lato server.
Couldn't verify your organization's policy for remote control invece.
“Remote Control was turned off by your organization’s policy”
La policy della tua organizzazione ha smesso di consentire Remote Control mentre una sessione era connessa, quindi Claude Code l’ha disconnessa. Cosa succede alla sessione dipende da come hai avviato Remote Control:- Con
/remote-control,claude --remote-controlo auto-connect: la sessione continua a funzionare senza Remote Control, e Claude Code la archivia su claude.ai - Con
claude remote-control: il server si arresta e archivia le sessioni che stava servendo, quindi termina
/remote-control nella sessione o claude remote-control nella tua shell. Entrambi i comandi falliscono con Remote Control is disabled by your organization's policy finché Claude Code su questa macchina non ha recuperato la policy modificata. Una sessione aperta la recupera circa una volta all’ora. Per scoprire cosa sta bloccando Remote Control, confronta il testo completo stampato dal comando con quella voce.
“Couldn’t verify your organization’s policy for remote control”
Claude Code non ha potuto recuperare la policy della tua organizzazione e non ha una copia salvata su questa macchina da utilizzare invece, quindi mantiene Remote Control disattivato finché non può confermare che la tua organizzazione lo consente. Questo di solito accade quando avvii Claude Code offline o prima che una VPN si connetta, oppure quando un proxy interferisce con la richiesta. Su una connessione lenta può anche apparire mentre la prima richiesta è ancora in corso. Il messaggio assume una di queste forme:- Da
/remote-control,claude remote-control, oclaude --remote-control:Couldn't verify your organization's policy for remote control. Check your network connection and try again. - Da auto-connect quando una sessione inizia:
couldn't verify your organization's policy — check your network connection and try again, preceduto daRemote Control failednella notifica eRemote Control disconnectednella conversazione. La sessione quindi lascia Remote Control disattivato.
/remote-control o esegui di nuovo il comando. Ogni tentativo controlla di nuovo la policy, quindi non hai bisogno di riavviare Claude Code. Se il messaggio continua ad apparire, esegui claude doctor e leggi la sua riga Organization policy, che dice perché la policy non ha caricato.
Prima della v2.1.281, questo stato mostrava Remote Control is disabled by your organization's policy invece.
“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:
- Non connesso: esegui
claudee usa/loginper autenticarti con il tuo account claude.ai. L’autenticazione tramite 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 è accaduto prima nella configurazione. Verifica che il tuo abbonamento sia attivo.
“Couldn’t reconnect to your Remote Control session”
Quando riprendi una conversazione conclaude --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, oppure 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.
“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 avviarne una nuova da solo. Puoi vedere questo messaggio dopo aver ripreso una conversazione conclaude --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. 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.
“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. Eseguiclaude update, quindi esegui /remote-control per riconnetterti.
“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 iscritta. Esegui/login in Claude Code. L’iscrizione avviene come parte dell’accesso, e non c’è alcun comando di iscrizione separato.
“session expired for trusted-device check”
Il tuo accesso è più vecchio di 18 ore. Esegui/login in Claude Code, oppure conferma con Face ID, Touch ID, Windows Hello, o una passkey quando claude.ai o l’app mobile te lo chiede. Vedi Trusted Devices.
Risorse correlate
- 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 sessioni cloud
- 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
/logine 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, Remote Control e cloud