Claude Code Controle Remoto: Continue Sessões Locais

O Controle Remoto do Claude Code conecta claude.ai/code ou os aplicativos móveis do Claude a uma sessão do Claude Code em execução localmente em sua máquina. Você pode iniciar uma tarefa em sua mesa e retomá-la pelo telefone ou outro computador enquanto o Claude continua funcionando localmente o tempo todo — nada é movido para a nuvem.

Recursos Principais

Com o Controle Remoto você pode:

Usar todo o seu ambiente local remotamente: seu sistema de arquivos, servidores MCP, ferramentas e configuração do projeto permanecem disponíveis
Trabalhar em ambas as superfícies simultaneamente: a conversa permanece sincronizada em todos os dispositivos conectados, permitindo enviar mensagens do terminal, navegador e telefone de forma intercambiável
Sobreviver a interrupções: se seu laptop entrar em modo de suspensão ou sua rede cair, a sessão reconecta automaticamente quando sua máquina voltar a ficar online

Ao contrário do Claude Code na web, que é executado em infraestrutura de nuvem, as sessões do Controle Remoto são executadas diretamente em 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.

Requisitos

Antes de usar o Controle Remoto, confirme que seu ambiente atende a estas condições:

Assinatura: requer um plano Pro ou Max. Chaves de API não são suportadas. O Controle Remoto não está disponível em planos Team ou Enterprise.
Autenticação: execute claude e use /login para fazer login através de claude.ai se ainda não o fez
Confiança no espaço de trabalho: execute claude em seu diretório de projeto pelo menos uma vez para aceitar a caixa de diálogo de confiança no espaço de trabalho

Iniciando uma Sessão de Controle Remoto

Você pode iniciar uma nova sessão diretamente no Controle Remoto ou conectar uma sessão que já está em execução.

Para uma nova sessão, navegue até seu diretório de projeto e execute:

claude remote-control

O processo permanece em execução em seu terminal, 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 das ferramentas.

Este comando suporta as seguintes flags:

--verbose: mostra logs detalhados de conexão e sessão
--sandbox / --no-sandbox: habilita ou desabilita o sandboxing para isolamento do sistema de arquivos e rede durante a sessão. O sandboxing está desativado por padrão.

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

Isso inicia uma sessão de Controle Remoto que mantém seu histórico de conversa atual e exibe uma URL de sessão e código QR que você pode usar para conectar de outro dispositivo. As flags --verbose, --sandbox e --no-sandbox não estão disponíveis com este comando.

Use /rename antes de executar /remote-control para dar um nome descritivo à sessão. Isso facilita encontrá-la na lista de sessões entre dispositivos.

Conectando de Outro Dispositivo

Uma vez que uma sessão de Controle Remoto 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 exibido junto com a URL da sessão para abri-lo diretamente no aplicativo Claude
Abra claude.ai/code ou o aplicativo Claude e encontre a sessão pelo nome na lista de sessões

Sessões de Controle Remoto mostram um ícone de computador com um ponto de status verde quando online. A sessão remota recebe seu nome da sua última mensagem, do seu valor /rename ou "Sessão de Controle Remoto" se não houver histórico de conversa.

Se o ambiente já tiver uma sessão ativa, você será perguntado se deseja continuá-la ou iniciar uma nova.

📖 Leia a fonte completa: HN AI Agents