Continue sessões locais de qualquer dispositivo com Remote Control
Continue uma sessão local do Claude Code do seu telefone, tablet ou qualquer navegador usando Remote Control. Funciona com claude.ai/code e o aplicativo Claude para dispositivos móveis.
Remote Control conecta claude.ai/code ou o aplicativo Claude para iOS e Android a uma sessão do Claude Code em execução na sua máquina. Inicie uma tarefa na sua mesa, depois continue a partir do seu telefone no sofá ou de um navegador em outro computador.
Quando você inicia uma sessão de Remote Control na sua máquina, Claude continua executando localmente o tempo todo, portanto nada se move para a nuvem. Com Remote Control você pode:
- Usar seu ambiente local completo remotamente: seu sistema de arquivos, MCP servers, ferramentas e configuração do projeto permanecem disponíveis, e digitar
@autocompleta caminhos de arquivo do seu projeto local - Trabalhar em ambas as superfícies ao mesmo tempo: a conversa permanece sincronizada em todos os dispositivos conectados, para que você possa enviar mensagens do seu terminal, navegador e telefone de forma intercambiável
- Sobreviver a interrupções: se seu laptop dormir ou sua rede cair, a sessão se reconecta automaticamente quando sua máquina voltar a ficar online
Diferentemente do Claude Code na web, que é executado em infraestrutura em nuvem, as sessões de Remote Control são executadas diretamente na sua máquina e interagem com seu sistema de arquivos local. As interfaces web e móvel são apenas uma janela para essa sessão local.
Esta página aborda a configuração, como iniciar e conectar a sessões, e como Remote Control se compara ao Claude Code na web.
Requisitos
Antes de usar Remote Control, confirme que seu ambiente atende a estas condições:
- Assinatura: disponível nos planos Pro, Max, Team e Enterprise. Chaves de API não são suportadas. Em Team e Enterprise, um administrador deve primeiro ativar o toggle Remote Control nas configurações de administrador do Claude Code.
- Autenticação: execute
claudee use/loginpara fazer login através de claude.ai se você ainda não fez isso. - Confiança do workspace: execute
claudeno diretório do seu projeto pelo menos uma vez para aceitar o diálogo de confiança do workspace.
Inicie uma sessão de Remote Control
Você pode iniciar uma sessão de Remote Control a partir da CLI ou da extensão VS Code. A CLI oferece três modos de invocação; VS Code usa o comando /remote-control.
Navegue até o diretório do seu projeto e execute:
claude remote-control
O processo continua em execução no seu terminal em modo servidor, aguardando conexões remotas. Ele exibe uma URL de sessão que você pode usar para conectar de outro dispositivo, e você pode pressionar a barra de espaço para mostrar um código QR para acesso rápido do seu telefone. Enquanto uma sessão remota está ativa, o terminal mostra o status da conexão e a atividade da ferramenta.
Sinalizadores disponíveis:
| Sinalizador | Descrição |
|---|---|
--name "My Project" |
Define um título de sessão personalizado visível na lista de sessões em claude.ai/code. |
--remote-control-session-name-prefix <prefix> |
Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. Defina CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para o mesmo efeito. |
--spawn <mode> |
Como o servidor cria sessões. • same-dir (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.• worktree: cada sessão sob demanda obtém seu próprio git worktree. Requer um repositório git.• session: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Definido apenas na inicialização.Pressione w em tempo de execução para alternar entre same-dir e worktree. |
--capacity <N> |
Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com --spawn=session. |
--verbose |
Mostra logs detalhados de conexão e sessão. |
--sandbox / --no-sandbox |
Ativa ou desativa sandboxing para isolamento de sistema de arquivos e rede. Desativado por padrão. |
Para iniciar uma sessão normal interativa do Claude Code com Remote Control ativado, use a flag --remote-control (ou --rc):
claude --remote-control
Opcionalmente, passe um nome para a sessão:
claude --remote-control "My Project"
Isso oferece uma sessão interativa completa no seu terminal que você também pode controlar a partir de claude.ai ou do aplicativo Claude. Diferentemente de claude remote-control (modo servidor), você pode digitar mensagens localmente enquanto a sessão também está disponível remotamente.
Se você já está em uma sessão do Claude Code e deseja continuá-la remotamente, use o comando /remote-control (ou /rc):
/remote-control
Passe um nome como argumento para definir um título de sessão personalizado:
/remote-control My Project
Isso inicia uma sessão de Remote Control que carrega seu histórico de conversa atual.
As flags --verbose, --sandbox e --no-sandbox não estão disponíveis com este comando.
Na extensão VS Code do Claude Code, digite /remote-control ou /rc na caixa de prompt, ou abra o menu de comandos com / e selecione-o. Requer Claude Code v2.1.79 ou posterior.
/remote-control
Um banner aparece acima da caixa de prompt mostrando o status da conexão. Uma vez conectado, clique em Open in browser no banner para ir diretamente para a sessão, ou encontre-a na lista de sessões em claude.ai/code. A URL da sessão também é postada na conversa.
Para desconectar, clique no ícone de fechar no banner ou execute /remote-control novamente.
Diferentemente da CLI, o comando VS Code não aceita um argumento de nome ou exibe um código QR. O título da sessão é derivado do seu histórico de conversa ou primeiro prompt.
Verificar status da conexão
Em uma sessão de terminal interativa, um indicador /rc active fica no rodapé abaixo da caixa de entrada enquanto a conexão está ativa, e fica oculto se o terminal for muito estreito para ajustá-lo. O texto do indicador é um link para a sessão em claude.ai. Selecione-o com a tecla de seta para baixo e pressione Enter, ou execute /remote-control novamente, para abrir um painel de status com a URL da sessão e um código QR que você pode usar para conectar de outro dispositivo.
Se a conexão falhar, o indicador fica vermelho e lê /rc failed. Selecione-o com a tecla de seta para baixo e pressione Enter para ver o motivo da falha e uma opção de descartar, ou execute /remote-control novamente para tentar novamente.
Conectar de outro dispositivo
Depois que uma sessão de Remote Control está ativa, você tem algumas maneiras de conectar de outro dispositivo:
- Abra a URL da sessão em qualquer navegador para ir diretamente para a sessão em claude.ai/code.
- Escaneie o código QR mostrado ao lado da URL da sessão para abri-lo diretamente no aplicativo Claude. Com
claude remote-control, pressione a barra de espaço para alternar a exibição do código QR. - Abra claude.ai/code ou o aplicativo Claude e encontre a sessão pelo nome na lista de sessões. No aplicativo móvel Claude, toque em Code na navegação para acessar a lista de sessões. As sessões de Remote Control mostram um ícone de computador com um ponto de status verde quando online.
O título da sessão remota é escolhido nesta ordem:
- O nome que você passou para
--name,--remote-controlou/remote-control - O título que você definiu com
/rename - A última mensagem significativa no histórico de conversa existente
- Um nome gerado automaticamente como
myhost-graceful-unicorn, ondemyhosté o nome do host da sua máquina ou o prefixo que você definiu com--remote-control-session-name-prefix
Se você não definir um nome explícito, o título será atualizado para refletir seu prompt assim que você enviar um. {/* min-version: 2.1.176 */}A partir da Claude Code v2.1.176, títulos gerados automaticamente correspondem ao idioma da sua conversa, ou à configuração language se uma estiver configurada. Renomear uma sessão a partir de claude.ai ou do aplicativo Claude também atualiza o título local mostrado em claude --resume.
Se o ambiente já tiver uma sessão ativa, você será perguntado se deseja continuá-la ou iniciar uma nova.
Se você ainda não tem o aplicativo Claude, use o comando /mobile dentro do Claude Code para exibir um código QR de download para iOS ou Android.
Ativar Remote Control para todas as sessões
Por padrão, Remote Control só é ativado quando você executa explicitamente claude remote-control, claude --remote-control ou /remote-control. Para ativá-lo automaticamente para cada sessão interativa, execute /config dentro do Claude Code e defina Enable Remote Control for all sessions como true. Defina-o de volta para false para desativar. No aplicativo Desktop, você também pode alternar isso em Settings → Claude Code → Enable remote control by default.
Com essa configuração ativada, cada processo interativo do Claude Code registra uma sessão remota. Se você executar várias instâncias, cada uma obtém seu próprio ambiente e sessão. Para executar várias sessões simultâneas a partir de um único processo, use o modo servidor em vez disso.
Conexão e segurança
Sua sessão local do Claude Code faz apenas solicitações HTTPS de saída e nunca abre portas de entrada na sua máquina. Quando você inicia Remote Control, ele se registra na API Anthropic e faz polling para trabalho. Quando você conecta de outro dispositivo, o servidor roteia mensagens entre o cliente web ou móvel e sua sessão local através de uma conexão de streaming.
Todo o tráfego viaja através da API Anthropic sobre TLS, o mesmo transporte de segurança que qualquer sessão do Claude Code. A conexão usa múltiplas credenciais de curta duração, cada uma com escopo para um único propósito e expirando independentemente.
Remote Control vs Claude Code na web
Remote Control e Claude Code na web usam a interface claude.ai/code. A diferença fundamental é onde a sessão é executada: Remote Control é executado na sua máquina, portanto seus MCP servers locais, ferramentas e configuração do projeto permanecem disponíveis. Claude Code na web é executado em infraestrutura em nuvem gerenciada pela Anthropic.
Use Remote Control quando você está no meio do trabalho local e deseja continuar de outro dispositivo. Use Claude Code na web quando você deseja iniciar uma tarefa sem nenhuma configuração local, trabalhar em um repositório que você não tem clonado ou executar várias tarefas em paralelo.
Notificações push móveis
Quando Remote Control está ativo, Claude pode enviar notificações push para seu telefone.
Claude decide quando fazer push. Normalmente envia uma quando uma tarefa de longa duração termina ou quando precisa de uma decisão sua para continuar. Você também pode solicitar um push em seu prompt, por exemplo notify me when the tests finish. Além dos dois toggles on/off abaixo, não há configuração por evento.
Para configurar notificações push móveis:
Faça login com sua conta do Claude Code
Use a mesma conta e organização que você usa para Claude Code no terminal.
Permita notificações
Aceite o prompt de permissão de notificação do sistema operacional.
Ative push no Claude Code
No seu terminal, execute /config e ative Push when Claude decides para notificações proativas, Push when actions required para prompts de permissão e perguntas, ou ambas.
Se as notificações não chegarem:
- Se
/configmostrar No mobile registered, abra o aplicativo Claude no seu telefone para que ele possa atualizar seu token de push. O aviso desaparece na próxima vez que Remote Control se conectar. - No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.
- No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.
Limitações
- Uma sessão remota por processo interativo: fora do modo servidor, cada instância do Claude Code suporta uma sessão remota por vez. Use o modo servidor para executar várias sessões simultâneas a partir de um único processo.
- O processo local deve continuar em execução: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo
claude, a sessão termina. - Interrupção de rede estendida: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute
claude remote-controlnovamente para iniciar uma nova sessão. - Ultraplan desconecta Remote Control: iniciar uma sessão ultraplan desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.
- Alguns comandos são apenas locais: comandos que abrem um seletor interativo no terminal, como
/pluginou/resume, funcionam apenas a partir da CLI local. Comandos que produzem saída de texto, incluindo/compact,/clear,/context,/usage,/exit,/usage-credits,/recape/reload-plugins, funcionam a partir de dispositivos móveis e web. {/* min-version: 2.1.166 */}A partir da v2.1.166,/mcptambém funciona a partir de dispositivos móveis e web: ele retorna um resumo de texto do status do servidor em vez de abrir o seletor, e aceita os mesmos subcomandos da CLI local, com uma diferença: a partir de dispositivos móveis e web,/mcp reconnectsem nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação, enquanto a CLI local requer um nome de servidor parareconnect.
Solução de problemas
"Remote Control requires a claude.ai subscription"
Você não está autenticado com uma conta claude.ai. Execute claude auth login e escolha a opção claude.ai. Se ANTHROPIC_API_KEY estiver definida em seu ambiente, desative-a primeiro.
"Remote Control requires a full-scope login token"
Você está autenticado com um token de longa duração de claude setup-token ou da variável de ambiente CLAUDE_CODE_OAUTH_TOKEN. Esses tokens são limitados apenas a inferência e não podem estabelecer sessões de Remote Control. Execute claude auth login para autenticar com um token de sessão de escopo completo em vez disso.
"Unable to determine your organization for Remote Control eligibility"
Suas informações de conta em cache estão desatualizadas ou incompletas. Execute claude auth login para atualizá-las.
"Remote Control is not yet enabled for your account"
A verificação de Remote Control não atingiu sua conta, ou seus direitos em cache estão desatualizados. Se você mudou de plano recentemente, execute claude auth logout e depois claude auth login para atualizá-los. Execute claude doctor para ver qual verificação de elegibilidade individual falhou. Conflitos de variáveis de ambiente, verificações inacessíveis e política organizacional cada um produzem sua própria mensagem, então este erro significa o próprio portão de verificação.
"Couldn't verify Remote Control eligibility"
Claude Code não conseguiu alcançar o serviço de sinalizador de recurso para verificar se Remote Control está habilitado para sua conta, normalmente porque você está offline ou um proxy está bloqueando a solicitação. Tente novamente quando tiver acesso à rede, ou execute claude doctor para obter detalhes. A mensagem relacionada "Couldn't verify your organization's Remote Control policy" tem a mesma causa e a mesma solução. Ambas as mensagens foram adicionadas na v2.1.178.
"Remote Control is disabled by your organization's policy"
Este erro tem quatro causas distintas. Execute /status primeiro para ver qual método de login e assinatura você está usando.
- Você está autenticado com uma chave de API ou conta Console: Remote Control requer OAuth claude.ai. Execute
/logine escolha a opção claude.ai. SeANTHROPIC_API_KEYestiver definida em seu ambiente, desative-a. - Seu administrador de Team ou Enterprise não ativou: Remote Control fica desativado por padrão nesses planos. Um administrador pode ativá-lo em claude.ai/admin-settings/claude-code ativando o toggle Remote Control. Este toggle é uma configuração de organização no lado do servidor.
- O toggle do administrador está acinzentado: sua organização tem uma configuração de retenção de dados ou conformidade que é incompatível com Remote Control. Isso não pode ser alterado no painel de administração. Entre em contato com o suporte da Anthropic para discutir opções.
- O erro menciona
disableRemoteControl: seu administrador de TI desativou Remote Control neste dispositivo através de configurações gerenciadas, independentemente do toggle em toda a organização.
"Remote credentials fetch failed"
Claude Code não conseguiu obter uma credencial de curta duração da API Anthropic para estabelecer a conexão. Execute novamente com --verbose para ver o erro completo:
claude remote-control --verbose
Causas comuns:
- Não conectado: execute
claudee use/loginpara autenticar com sua conta claude.ai. A autenticação por chave de API não é suportada para Remote Control. - Problema de rede ou proxy: um firewall ou proxy pode estar bloqueando a solicitação HTTPS de saída. Remote Control requer acesso à API Anthropic na porta 443.
- Falha na criação de sessão: se você também vir
Session creation failed — see debug log, a falha aconteceu anteriormente na configuração. Verifique se sua assinatura está ativa.
Escolha a abordagem correta
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 |
Recursos relacionados
- Claude Code na web: execute sessões em ambientes em nuvem gerenciados pela Anthropic em vez de na sua máquina
- Ultraplan: inicie uma sessão de planejamento em nuvem a partir do seu terminal e revise o plano no seu navegador
- Channels: encaminhe Telegram, Discord ou iMessage para uma sessão para que Claude reaja a mensagens enquanto você está ausente
- Dispatch: envie uma mensagem com uma tarefa do seu telefone e ela pode gerar uma sessão Desktop para lidar com isso
- Autenticação: configure
/logine gerencie credenciais para claude.ai - Referência de CLI: lista completa de flags e comandos incluindo
claude remote-control - Segurança: como as sessões de Remote Control se encaixam no modelo de segurança do Claude Code
- Uso de dados: quais dados fluem através da API Anthropic durante sessões locais e remotas