SpyBara
Go Premium

remote-control.md 2026-09-28 22:59 UTC to 2026-09-29 06:57 UTC

This page contains 166 additions and 174 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58 Mon 28 22:59 Tue 29 08:02

Continua le sessioni locali da qualsiasi dispositivo con Remote Control

Continua una sessione locale di Claude Code dal tuo telefono, tablet o da qualsiasi browser utilizzando Remote Control. Funziona con claude.ai/code e l'app Claude per dispositivi mobili.

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.

A differenza di sessioni cloud, che vengono eseguite 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, quindi il tuo computer deve rimanere acceso e il processo claude deve continuare a funzionare.

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.
    • Accedi tramite un gateway di app Claude aziendale.
  • Valutazione dei flag di funzionalità: se imposti una variabile di ambiente che disattiva la valutazione dei flag di funzionalità, la disponibilità di Remote Control dipende da quale:
    • Se imposti CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK, Remote Control non è disponibile. 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.
    • Se imposti solo DISABLE_TELEMETRY o DO_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.
  • Fiducia dell'area di lavoro: in una directory che non hai ancora considerato attendibile, claude remote-control stampa ciò che considerare attendibile attiva e chiede Trust <directory>? [y/N] prima di avviarsi. Rispondendo y salva 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 errore Workspace 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.

Nella directory del progetto, eseguire:

claude remote-control

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.

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 macchina, producendo nomi come myhost-graceful-unicorn. Impostare CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX per lo stesso effetto.
-c, --continue Ripristina la sessione che l'ultimo server in questa directory ha avviato, invece di crearne una nuova. Vedere Riprendere le sessioni dopo l'arresto del server. Non può essere combinato con --session-id, --spawn, --capacity o --create-session-in-dir. Richiede Claude Code v2.1.200 o successivo.
--session-id <id> Ripristina una sessione in base al suo ID. Vedere Riprendere le sessioni dopo l'arresto del server. Non può essere combinato con --continue, --spawn, --capacity o --create-session-in-dir. Richiede Claude Code v2.1.200 o successivo.
--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.
Premere w durante l'esecuzione per alternare tra same-dir e worktree.
--capacity <N> Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con --spawn=session.
--[no-]create-session-in-dir Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità worktree questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa --no-create-session-in-dir per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da riprendere.
--permission-mode <mode> Imposta la modalità di autorizzazione iniziale per le sessioni del server, come acceptEdits. Accetta manual come alias per default; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide.
-d, --debug[=<filter>] Attiva la registrazione del debug per il server, facoltativamente filtrata per categoria. Passare un filtro solo nella forma =, come --debug=api,hooks. Richiede Claude Code v2.1.282 o successivo; le versioni precedenti rifiutano il flag come argomento sconosciuto.
--debug-file <path> Scrive i log di debug nel file specificato.
--verbose Mostra log dettagliati di connessione e sessione.
--sandbox / --no-sandbox Abilita o disabilita il sandboxing per l'isolamento del file system e della rete. Disabilitato per impostazione predefinita.

Fornire 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.

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 si è connessi con un account idoneo.

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-control solo se si vuole riprenderselo.
  • This session was ended or archived from another device or app: eseguire /remote-control solo 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.

Quando ti connetti, il dispositivo mostra tutti i subagent e i flussi di lavoro che la sessione ha già in esecuzione in background. Arresta uno di essi dal dispositivo, e Claude Code arresta 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. Quando rinomini una sessione da claude.ai o dall'app Claude, Claude Code aggiorna anche il titolo locale mostrato in 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 /resume nel 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 stesse sessioni su macchine diverse e dalle tue sessioni cloud.
  • 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 /effort o il controllo dello sforzo del dispositivo, Claude Code lo applica alla sessione sulla tua macchina. 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. 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-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 le sessioni archiviate. Il cambio di conversazioni mentre un dispositivo è ancora connesso non archivia la sessione.

Abilitare 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 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 un true dalle impostazioni gestite lo supera, perché Claude Code salva la scelta nelle tue impostazioni utente. Un false nelle impostazioni di progetto o locali (.claude/settings.json, .claude/settings.local.json) disattiva la connessione automatica anche su un true gestito.
  • 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.

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 Settings del menu dei comandi.

Per attivare la connessione automatica da un file di impostazioni, imposta 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.

Riprendere le sessioni dopo l'arresto del server

Quando arresti 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 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 ?.

Questi comandi funzionano per circa quattro ore dopo l'arresto del server. 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 ripristinare una sessione che hai avviato con claude --remote-control o /remote-control, riprendi la conversazione con claude --continue o claude --resume. Se Remote Control non si riconnette, vedi 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.

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'impostazione disableRemoteControl. Le organizzazioni con requisiti di conformità come Zero Data Retention non possono abilitare Remote Control.

Dispositivi affidabili

Dispositivi affidabili richiede a ogni membro della vostra organizzazione, o a Lei sola su un piano Pro o Max, di verificare il proprio 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 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.

Trigger Claude viene eseguito su Setup Migliore per
Dispatch Invia un'attività dall'app mobile Claude La tua macchina (Desktop) Associa l'app mobile a Desktop Delegare il lavoro mentre sei via, setup minimo
Remote Control Guida una sessione in esecuzione da claude.ai/code o dall'app mobile Claude La tua macchina (CLI, Desktop, o VS Code) Esegui claude remote-control o /remote-control Guidare il lavoro in corso da un altro dispositivo
Channels Invia eventi da un'app di chat come Telegram o Discord, o dal tuo server La tua macchina (CLI) Installa un plugin channel o crea il tuo Reagire a eventi esterni come errori CI o messaggi di chat
Slack Menziona @Claude in un canale del team Cloud Anthropic Installa l'app Slack con Claude Code sul web abilitato PR e revisioni dalla chat del team
Self-hosted environments Avvia una sessione cloud e scegli l'ambiente della tua organizzazione L'infrastruttura della tua organizzazione Distribuisci runner, su piani Team e Enterprise Sessioni cloud che devono essere eseguite all'interno della tua rete
Scheduled tasks Imposta una pianificazione CLI, Desktop, o cloud Scegli una frequenza Automazione ricorrente come revisioni giornaliere

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 esempio notify 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:

1

Installa l'app mobile Claude

Scarica l'app Claude per iOS o Android.

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 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 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 Code salta le notifiche push mobili mentre stai digitando o sei concentrato sul terminale connesso. Per estendere questo a qualsiasi momento in cui sei alla macchina, anche in un'altra finestra, imposta 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 sessione remota alla volta. Utilizzare 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 chiudete il terminale, chiudete l'app Desktop o VS Code, o altrimenti interrompete il processo claude, la sessione va offline finché non la ripristinate. Per mantenere una sessione in esecuzione su una macchina remota dopo la disconnessione da SSH, avviatela all'interno di tmux o screen.
  • Sessioni bloccate in modalità server: se una sessione servita da claude remote-control si blocca, inviatele un messaggio da un dispositivo connesso. Claude Code la serve di nuovo. Non dovete 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 vostra 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 vostra rete.
  • Interruzione di rete prolungata: se la vostra macchina è accesa ma non riesce a raggiungere la rete, quello che fate dopo dipende dalla modalità:
    • Modalità server: Claude Code si arrende dopo circa 10 minuti e il processo claude remote-control esce. Eseguite claude remote-control di nuovo per avviare una nuova sessione.
    • Sessione interattiva: continuate a lavorare localmente. Claude Code continua a riprovare finché dura l'interruzione e si ricollega 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, eseguite /remote-control per riconnettervi.
  • I dialoghi inoltrati scadono: Claude Code mantiene aperti i prompt di autorizzazione e le domande AskUserQuestion finché non le rispondete. 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. Impostare dialogExpiry per regolare o disabilitare la scadenza. Richiede Claude Code v2.1.224 o successivo.
  • Il prompt di consenso dei crediti di utilizzo di Fable non viene inoltrato: Claude Code mostra il prompt di consenso dei crediti di utilizzo di Fable a metà sessione solo dove la sessione viene eseguita, non sul vostro 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; vedere The prompt to confirm went unanswered.
  • Alcuni comandi sono solo locali: i comandi che vengono eseguiti solo nell'interfaccia del terminale, come /plugin o /resume, funzionano solo dalla CLI locale, indipendentemente dal fatto che passiate un argomento o meno. I seguenti funzionano da mobile e web:
    • Comandi di 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: passate il valore come argomento, ad esempio /model sonnet o /effort high. Da mobile e web, /model e /effort prendono l'argomento al posto del picker del terminale o del cursore.
    • /mcp: dall'app mobile, restituisce un riepilogo di testo dello stato del server invece di aprire il picker. 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 un nome di server ricollega ogni server che ha fallito o ha bisogno di autenticazione.
    • /config: dall'app mobile, passate key=value per impostare un'impostazione, o eseguitelo senza argomento per elencare le chiavi che potete impostare. Sul web, /config apre invece la sezione Claude Code delle vostre impostazioni e ignora il testo dopo il comando.
    • Su Team e Enterprise, /usage-credits da mobile o web non invia una richiesta di crediti di utilizzo al vostro amministratore. L'invio richiede una conferma che appare solo nella CLI interattiva, quindi il comando vi dice di eseguirlo lì invece.
    • /autocompact, da v2.1.221: passate la dimensione della finestra come argomento, ad esempio /autocompact 500k. Senza argomento, stampa la dimensione della finestra corrente come testo invece di aprire il dialogo che il comando mostra in una sessione di terminale.
    • /advisor, da v2.1.260: passate il modello come argomento, ad esempio /advisor opus, o passate off per disattivare l'advisor. Entrambi i moduli si applicano solo alla sessione corrente e lasciano il vostro valore predefinito salvato invariato. Senza argomento, stampa l'advisor corrente come testo invece di aprire il picker.
    • /output-style, da v2.1.269: passate il nome dello stile come argomento, ad esempio /output-style concise, o eseguitelo senza argomento per elencare gli stili. Da mobile e web, potete elencare e selezionare solo gli stili incorporati. Per utilizzare uno stile personalizzato, selezionatelo nella sessione stessa.
    • /focus, da v2.1.281: passate on o off come argomento, ad esempio /focus on, o eseguitelo senza argomento per attivare/disattivare la visualizzazione focus. Entrambi i moduli si applicano solo alla sessione corrente e lasciano la vostra selezione salvata invariata.

Troubleshooting

"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-control o --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, 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: 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 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 connesso e il controllo è risultato disattivato. La causa più comune è la memorizzazione nella cache dei diritti che sono obsoleti dopo un cambio di piano. Esegui claude 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 di 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 esegui claude 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 di 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_TRAFFIC o DISABLE_GROWTHBOOK: annulla l'impostazione della variabile ovunque sia impostata, nel tuo ambiente shell o nel blocco env di un file settings.json.
  • DISABLE_TELEMETRY o DO_NOT_TRACK: su un piano Pro, Max, Team o Enterprise con DISABLE_GROWTHBOOK non 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, una delle due variabili ha prodotto questo messaggio, quindi aggiorna Claude Code alla v2.1.283 o successiva.

"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, su Google Cloud's Agent Platform e su Microsoft Foundry. Accade anche quando ANTHROPIC_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 /status per vedere quale piano e organizzazione utilizza il tuo accesso. Esegui claude auth logout quindi claude auth login per accedere di nuovo con il tuo piano attuale.
  • Il messaggio non dice di contattare l'amministratore della tua organizzazione: la tua organizzazione ha una configurazione HIPAA che è 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 è 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.

Prima della v2.1.281, questo messaggio appariva anche quando Claude Code non aveva caricato la policy della tua organizzazione su questa macchina, ad esempio dopo l'avvio offline. Le versioni successive segnalano quello stato come Couldn't verify your organization's policy for remote control invece.

"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, o claude --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 da Remote Control failed nella notifica e Remote Control disconnected nella conversazione. La sessione quindi lascia Remote Control disattivato.

Ripristina la tua connessione di rete, quindi esegui /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:

claude remote-control --verbose

Cause comuni:

  • Non connesso: esegui claude e usa /login per 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 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, 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 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. 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. Esegui claude 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.

  • 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 /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, Remote Control e cloud