Remote Control è disponibile su tutti i piani. Su Team e Enterprise, è disabilitato per impostazione predefinita fino a quando un amministratore non abilita l’interruttore Remote Control nelle impostazioni di amministrazione di Claude Code.
- Utilizzare il tuo ambiente locale completo da remoto: il tuo filesystem, i server MCP, gli strumenti e la configurazione del progetto rimangono disponibili
- Lavorare da entrambe le superfici contemporaneamente: la conversazione rimane sincronizzata su tutti i dispositivi connessi, quindi puoi inviare messaggi dal tuo terminale, browser e telefono in modo intercambiabile
- Sopravvivere alle interruzioni: se il tuo laptop va in sospensione o la tua rete si interrompe, la sessione si riconnette automaticamente quando la tua macchina torna online
Remote Control richiede Claude Code v2.1.51 o successivo. Controlla la tua versione con
claude --version.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 amministratore deve prima abilitare l’interruttore Remote Control nelle impostazioni di amministrazione di Claude Code.
- Autenticazione: esegui
claudee utilizza/loginper accedere tramite claude.ai se non l’hai già fatto. - Fiducia dell’area di lavoro: esegui
claudenella directory del tuo progetto almeno una volta per accettare la finestra di dialogo di fiducia dell’area di lavoro.
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.
- Modalità server
- Sessione interattiva
- Da una sessione esistente
- VS Code
Accedi alla directory del tuo progetto ed esegui: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:
| Flag | Descrizione |
|---|---|
--name "My Project" | Imposta un titolo di sessione personalizzato visibile nell’elenco delle sessioni su claude.ai/code. |
--remote-control-session-name-prefix <prefix> | Prefisso per i nomi di sessione generati automaticamente quando non è impostato un nome esplicito. Per impostazione predefinita è il nome host della tua macchina, producendo nomi come myhost-graceful-unicorn. Imposta CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX per lo stesso effetto. |
--spawn <mode> | Come il server crea le sessioni. • same-dir (predefinito): tutte le sessioni condividono la directory di lavoro corrente, quindi possono entrare in conflitto se modificano gli stessi file.• worktree: ogni sessione su richiesta ottiene il proprio git worktree. Richiede un repository git.• session: modalità a sessione singola. Serve esattamente una sessione e rifiuta connessioni aggiuntive. Impostato solo all’avvio.Premi w durante l’esecuzione per attivare/disattivare tra same-dir e worktree. |
--capacity <N> | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con --spawn=session. |
--verbose | Mostra log dettagliati di connessione e sessione. |
--sandbox / --no-sandbox | Abilita o disabilita il sandboxing per l’isolamento del filesystem e della rete. Disabilitato per impostazione predefinita. |
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. Le sessioni Remote Control mostrano un’icona di computer con un punto di stato verde quando sono online.
- Il nome che hai passato a
--name,--remote-control, o/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
/mobile all’interno di Claude Code per visualizzare un codice QR di download per iOS o Android.
Abilita Remote Control per tutte le sessioni
Per impostazione predefinita, Remote Control si attiva solo quando esegui esplicitamenteclaude remote-control, claude --remote-control, o /remote-control. Per abilitarlo automaticamente per ogni sessione interattiva, esegui /config all’interno di Claude Code e imposta Enable Remote Control for all sessions su true. Impostalo di nuovo su false per disabilitarlo.
Con questa impostazione attiva, ogni processo Claude Code interattivo registra una sessione remota. Se esegui più istanze, ognuna ottiene il proprio ambiente e sessione. Per eseguire più sessioni simultanee da un singolo processo, utilizza invece la modalità server.
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.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 nell’infrastruttura cloud gestita da Anthropic. 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 esempionotify me when the tests finish. Oltre all’interruttore on/off qui sotto, non c’è configurazione per evento.
Le notifiche push mobili richiedono Claude Code v2.1.110 o successivo.
Accedi con il tuo account Claude Code
Utilizza lo stesso account e organizzazione che usi per Claude Code nel terminale.
- 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 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.
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 termina. - Interruzione di rete prolungata: se la tua macchina è accesa ma non riesce a raggiungere la rete per più di circa 10 minuti, la sessione scade e il processo esce. Esegui di nuovo
claude remote-controlper avviare una nuova sessione. - Ultraplan disconnette Remote Control: avviare una sessione ultraplan disconnette qualsiasi sessione Remote Control attiva perché entrambe le funzioni occupano l’interfaccia claude.ai/code e solo una può essere connessa alla volta.
Risoluzione dei problemi
”Remote Control requires a claude.ai subscription”
Non sei autenticato con un account claude.ai. Eseguiclaude auth login e scegli l’opzione claude.ai. Se ANTHROPIC_API_KEY è impostato nel tuo ambiente, annulla l’impostazione prima.
”Remote Control requires a full-scope login token”
Sei autenticato con un token di lunga durata daclaude setup-token o dalla variabile di ambiente CLAUDE_CODE_OAUTH_TOKEN. Questi token sono limitati solo all’inferenza e 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 aggiornarlo.
”Remote Control is not yet enabled for your account”
Il controllo di idoneità può fallire con determinate variabili di ambiente presenti:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_TELEMETRY: annulla l’impostazione e riprova.CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEX, oCLAUDE_CODE_USE_FOUNDRY: Remote Control richiede l’autenticazione claude.ai e non funziona con provider di terze parti.
/logout quindi /login per aggiornare.
”Remote Control is disabled by your organization’s policy”
Questo errore ha tre cause distinte. Esegui prima/status per vedere quale metodo di accesso e abbonamento stai utilizzando.
- Sei autenticato con una chiave API o un account Console: Remote Control richiede OAuth claude.ai. Esegui
/logine scegli l’opzione claude.ai. SeANTHROPIC_API_KEYè impostato nel tuo ambiente, annulla l’impostazione. - Il tuo amministratore di Team o Enterprise non l’ha abilitato: Remote Control è disabilitato per impostazione predefinita su questi piani. Un amministratore può abilitarlo su claude.ai/admin-settings/claude-code attivando l’interruttore Remote Control. Questa è un’impostazione organizzativa lato server, non una chiave di impostazioni gestite.
- L’interruttore di amministrazione è disattivato: la tua organizzazione ha una configurazione di conservazione dei dati o conformità incompatibile con Remote Control. Questo non può essere modificato dal pannello di amministrazione. Contatta il supporto Anthropic per discutere le opzioni.
”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 sei connesso: esegui
claudee utilizza/loginper 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.
Scegli l’approccio giusto
Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.| Trigger | Claude runs on | Setup | Best for | |
|---|---|---|---|---|
| Dispatch | Message a task from the Claude mobile app | Your machine (Desktop) | Pair the mobile app with Desktop | Delegating work while you’re away, minimal setup |
| Remote Control | Drive a running session from claude.ai/code or the Claude mobile app | Your machine (CLI or VS Code) | Run claude remote-control | Steering in-progress work from another device |
| Channels | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | Install a channel plugin or build your own | Reacting to external events like CI failures or chat messages |
| Slack | Mention @Claude in a team channel | Anthropic cloud | Install the Slack app with Claude Code on the web enabled | PRs and reviews from team chat |
| Scheduled tasks | Set a schedule | CLI, Desktop, or cloud | Pick a frequency | Recurring automation like daily reviews |
Risorse correlate
- Claude Code sul web: esegui sessioni in ambienti cloud gestiti da Anthropic invece che sulla tua macchina
- Ultraplan: avvia una sessione di pianificazione cloud dal tuo terminale e rivedi il piano nel tuo browser
- 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 e remote