Claude Code Remote Control: continue programando pelo celular

Se a sessão já estiver aberta, comece com /remote-control. Para iniciar uma conversa no terminal, use claude --remote-control. Já claude remote-control inicia um servidor que fica à espera de trabalho remoto. São formas diferentes de começar, todas com execução local. O guia de Remote Control da Anthropic documenta as três.

Quem pode usar o Claude Code Remote Control?

A documentação define a disponibilidade assim: “disponível nos planos Pro, Max, Team e Enterprise. Chaves de API não são aceitas.” Nos planos Team e Enterprise, “um Owner precisa primeiro ativar a opção Remote Control” nas configurações administrativas do Claude Code. Essa opção vem desativada por padrão na organização. Fonte: requisitos.

Entre na sua conta Claude antes de começar: execute claude e depois /login. Pagar pelo uso da API não atende a esse requisito, e outra credencial configurada pode ter prioridade sobre um login de assinatura já salvo. A seção de solução de problemas abaixo explica essa diferença.

O Remote Control também exige conexão direta com a API da Anthropic. Não há suporte a Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry, nem a um ANTHROPIC_BASE_URL personalizado que aponte para um endereço diferente de api.anthropic.com ou ao login por um gateway corporativo de aplicativos Claude. Fonte: requisitos de conexão.

Para saber quanto custam os planos, veja os preços do Claude Code. O acesso remoto muda de onde você pode acompanhar uma tarefa; a execução continua no computador que você já usa.

Escolha como iniciar a conexão

O caminho mais rápido depende de você estar começando uma tarefa ou retomando uma conversa.

As três primeiras linhas correspondem aos três modos de iniciar o recurso pela CLI. VS Code e Desktop têm seus próprios pontos de entrada. Fonte: modos de inicialização.

Inicie um servidor no diretório do projeto

No diretório do projeto em que você quer trabalhar, execute:

claude remote-control

Aceite a confirmação inicial do Remote Control quando ela aparecer. Em seguida, o processo aguarda conexões e exibe a URL da sessão. Pressione a barra de espaço para mostrar o QR code. Mantenha esse terminal aberto e rodando.

O modo servidor oferece um lugar para acompanhar as conexões e a atividade das ferramentas. Se você também quiser digitar prompts nesse terminal, escolha o modo interativo descrito abaixo. Para dar à sessão um nome fácil de reconhecer na lista de sessões remotas, acrescente --name "My Project" depois de remote-control. Fonte: inicialização do servidor.

Abra uma nova sessão interativa

Use claude --remote-control ou a forma abreviada claude --rc. Você pode continuar digitando no computador enquanto acessa a mesma sessão pelo celular ou navegador. É possível informar um nome depois da opção, como em claude --remote-control "My Project".

É uma boa escolha para quem começa a programar na mesa e precisa sair antes de terminar a tarefa. Fonte: inicialização interativa.

Conecte uma conversa em andamento

Dentro da sessão, digite /remote-control ou /rc. Se for a primeira conexão, aceite a caixa de diálogo de ativação. O histórico da conversa é mantido. Na CLI, /remote-control My Project também define o nome da sessão.

Depois da conexão, o terminal pode mostrar o indicador /rc active. Execute /remote-control novamente para abrir o painel de status, com a URL, o QR code e o controle de desconexão. Desconectar por esse painel mantém a conversa local em execução. Se a janela do terminal estiver estreita, o indicador pode ficar oculto. Fonte: status da conexão.

Comece pelo VS Code ou pelo Desktop

Na extensão Claude Code para VS Code, digite /remote-control ou /rc no campo de prompt. O indicador no rodapé abre a sessão conectada, e a URL também aparece na conversa. No VS Code, esse comando não aceita um argumento de nome da sessão nem exibe QR code. Execute-o novamente para desconectar.

No Claude Desktop, use o mesmo comando em uma sessão local da aba Code. Encontre a sessão conectada em claude.ai/code; para desconectar, repita o comando. O Desktop também oferece uma opção de Remote Control por sessão. Fontes: acesso pelos aplicativos, controles do Desktop.

Autorize o diretório no computador que executa a sessão

Definir um diretório como confiável é uma decisão separada de fazer login ou liberar o Remote Control para a organização. Essa autorização diz respeito ao diretório que o Claude Code vai usar.

Quando o modo servidor encontra um diretório ainda não autorizado, explica o que essa autorização permite e pede sua confirmação. A escolha fica salva, exceto no caso do seu diretório pessoal: nele, a confirmação é solicitada a cada execução.

Essa solicitação exige um terminal real. Se a entrada ou a saída padrão estiver redirecionada, o Claude Code não consegue pedir a confirmação e encerra com um erro de confiança no diretório. As soluções documentadas são executar claude nesse diretório e autorizá-lo primeiro, ou iniciar claude remote-control diretamente em um terminal e responder ali à solicitação. Fonte: erro de confiança no diretório.

Como acessar o Claude Code no celular ou em outro navegador

Abra a URL da sessão para acessá-la diretamente no navegador. Outra opção é entrar em claude.ai/code e selecionar a sessão pelo nome.

No celular, use o aplicativo oficial do Claude para iOS ou Android, conectado à sua conta Claude. Toque em Code para abrir a lista de sessões. Uma sessão de Remote Control online aparece com um ícone de computador e um ponto verde de status. Você também pode escanear o QR code da sessão para abri-la no aplicativo. Fonte: conexão de dispositivos.

Um bom primeiro teste é enviar uma mensagem curta pelo celular enquanto a sessão do computador ainda está à sua frente. Assim, você confirma que escolheu a conversa certa antes de se afastar.

Você pode enviar prompts por qualquer uma das interfaces. Os dispositivos conectados também mostram os subagentes em execução, que são agentes auxiliares trabalhando dentro da sessão, e os fluxos de trabalho em segundo plano. Interromper um deles remotamente encerra essa tarefa no computador da mesa. Fonte: comportamento nos dispositivos.

O que fica no computador e o que passa pela Anthropic?

Seu computador continua sendo a oficina. O celular e o navegador oferecem outra forma de comandar o trabalho que acontece ali.

O sistema de arquivos local, as ferramentas, as configurações do projeto e os servidores MCP continuam disponíveis. Servidores MCP são conexões que dão ao Claude acesso a ferramentas ou dados adicionais. Você não precisa recriar essa configuração local em um ambiente separado na nuvem só para continuar a sessão remotamente. Fonte: ambiente local.

Execução local não significa que todos os dados da sessão ficam no computador. A Anthropic armazena o histórico, incluindo suas mensagens, as respostas do Claude e a atividade das ferramentas, para sincronizar os dispositivos e permitir a reconexão. A conexão usa HTTPS de saída sobre TLS e credenciais de curta duração; não abre portas de entrada no seu computador. Fonte: conexão e segurança.

Organizações que usam Zero Data Retention ou a configuração HIPAA não podem ativar o Remote Control. A configuração disableRemoteControl também pode bloquear o recurso. Fonte: restrições de acesso.

Autorizar um diretório é diferente de autorizar um dispositivo

A autorização do diretório permite seu uso no computador que executa a sessão. Já Trusted Devices é um requisito opcional, em beta, para os dispositivos que visualizam ou controlam sessões.

Quando esse requisito está ativo, cada dispositivo precisa ser cadastrado, e sua autenticação não pode ter mais de 18 horas. Uma confirmação por biometria ou passkey pode renovar o acesso. Nos planos Team e Enterprise, um Owner ativa esse requisito separado em Organization settings > Capabilities > Remote sessions. Ele é independente da opção que libera o Remote Control. Fonte: Trusted Devices.

Configure o acesso remoto e as notificações para o dia a dia

Se você usa o recurso com frequência, pode ativar a conexão automática, sem precisar digitar o comando em cada sessão:

• CLI: abra /config e ative Enable Remote Control for all sessions, a opção que habilita o Remote Control em todas as sessões.
• VS Code: encontre essa opção na seção Settings do menu de comandos.
• Desktop: use Settings > Claude Code > Connect new sessions to Remote Control para conectar novas sessões automaticamente.

A configuração remoteControlAtStartup permite ativar a conexão automática nas configurações do usuário ou nas configurações gerenciadas. As configurações de projeto ou locais de um repositório podem desativá-la, mas não podem ativá-la para todas as pessoas que abrem esse repositório. A conexão automática usa sua própria conta. Fontes: configuração de inicialização, configurações do VS Code, configurações do Desktop.

Para receber notificações no celular, instale o aplicativo do Claude, use a mesma conta e organização do terminal e permita as notificações nas configurações do sistema operacional. No /config do terminal, ative Push when Claude decides, para receber notificações quando o Claude decidir enviá-las, Push when actions required, para receber avisos quando alguma ação for necessária, ou ambas. O Claude escolhe quando enviar notificações proativas; você pode pedir que ele avise ao terminar uma tarefa, mas não há configuração por evento. Fonte: notificações no celular.

Resolva o problema indicado na mensagem de erro

Comece pelo motivo que o Claude Code exibe. Uma sessão interativa pode continuar funcionando localmente mesmo quando a conexão de Remote Control falha. Por isso, o terminal estar funcionando não basta para confirmar que o acesso remoto está ativo.

O login não atende aos requisitos ou outra credencial tem prioridade

Execute claude auth login e escolha a opção de login pelo claude.ai. Se o erro mencionar ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN, remova essa credencial de todos os lugares em que estiver configurada, inclusive do ambiente do shell ou do bloco env de um arquivo de configurações. Se a mensagem mencionar apiKeyHelper, remova essa configuração.

Um token obtido com claude setup-token ou definido em CLAUDE_CODE_OAUTH_TOKEN também não permite estabelecer o Remote Control: esses tokens servem apenas para requisições ao modelo. Use claude auth login para obter o escopo de login necessário. Fontes: falhas de autenticação, limitações dos tokens.

Sem um login que atenda aos requisitos, claude remote-control encerra a execução. Já claude --remote-control inicia a sessão interativa local e depois exibe uma notificação de falha no acesso remoto. Fonte: requisitos de login.

Variáveis de ambiente bloqueiam as verificações de disponibilidade

As feature flags são as verificações de disponibilidade que o Claude Code usa para decidir se o recurso pode funcionar. A solução depende da variável indicada no erro:

A versão da última linha se aplica especificamente a essas configurações de variáveis de telemetria. Ela não indica uma versão mínima geral para usar o Remote Control. Fonte: solução de problemas com feature flags.

A sessão usa um gateway ou outro endpoint de API

O Remote Control não aceita login por um gateway corporativo de aplicativos Claude. Os provedores de API de terceiros citados acima também não são compatíveis.

Se o erro indicar uma variável que desvia da Anthropic uma sessão claude.ai que atenderia aos demais requisitos, como um ANTHROPIC_BASE_URL personalizado, a solução documentada é remover a variável indicada, excluí-la também do bloco env das configurações, caso esteja ali, e reiniciar a sessão. Fonte: requisitos e erros de endpoint.

Uma verificação da organização ou da conta falha

Se o bloqueio vier de uma política da organização, verifique se um Owner ativou o Remote Control. Uma política de dispositivo com disableRemoteControl é outra possível causa. Se você migrou para Pro ou Max, mas o Claude Code ainda usa o login de uma organização antiga, /status mostra o plano e a organização; executar claude auth logout e depois claude auth login renova o login.

Se a verificação de acesso da conta ainda refletir o plano anterior, a documentação também recomenda sair e entrar novamente, atualizar uma versão antiga do Claude Code e usar claude doctor para identificar a verificação que está falhando. Se não foi possível consultar a política, restabeleça o acesso à rede e tente de novo; o resultado da verificação de política da organização no diagnóstico explica as falhas persistentes. Fonte: problemas de conta e políticas.

Não foi possível obter as credenciais remotas

Use o comando de diagnóstico documentado para o servidor:

claude remote-control --verbose

As causas listadas são falta de autenticação no claude.ai, uma rede ou um proxy que bloqueia a requisição de saída à API da Anthropic na porta 443, ou uma falha anterior na criação da sessão. Nesse último caso, verifique se a assinatura está ativa. O comando /remote-control executado dentro da sessão não aceita --verbose. Fonte: falha na obtenção de credenciais.

Mantenha o computador ligado e saiba como reconectar

Fechar o terminal, sair do Desktop ou do VS Code, ou interromper o processo do Claude Code deixa a sessão indisponível para acesso remoto. Após uma suspensão breve ou uma interrupção curta da rede, a conexão pode ser restabelecida quando o computador voltar. Já uma falha prolongada de rede tem efeitos diferentes em cada modo:

• Modo servidor: após cerca de 10 minutos sem acesso à rede, o servidor encerra. Execute claude remote-control novamente.
• Modo interativo: o trabalho local pode continuar enquanto o Claude Code tenta reconectar e restabelece a conexão quando a rede volta.

Alguns comandos, incluindo /plugin e /resume, ainda exigem a CLI local. O acesso remoto não reproduz todas as interações do terminal. Fonte: limitações.

Se você encerrou um servidor normalmente, pode recuperar suas sessões ao reiniciá-lo no mesmo diretório dentro de uma janela de cerca de quatro horas. Isso pressupõe que você não estava rodando outro servidor nesse diretório e não usou --no-create-session-in-dir. Depois desse prazo, inicie uma nova sessão.

Para retomar uma conversa interativa, use claude --continue ou claude --resume; se a reconexão remota falhar, execute /remote-control dentro dela. Fonte: retomada de sessões.

Quando usar Remote Control ou uma sessão na nuvem?

Escolha o Remote Control quando o que importa é aproveitar o ambiente que já está no seu computador. Escolha uma sessão na nuvem quando quiser executar o trabalho em infraestrutura de nuvem.

Ambas podem aparecer em claude.ai/code. Portanto, esse endereço, por si só, não indica onde o trabalho está sendo executado. Fontes: comparação documentada, sessões na nuvem.

Cada processo interativo do Claude Code aceita uma sessão remota. O modo servidor pode gerenciar várias sessões locais. Seu modo padrão, same-dir, compartilha o diretório de trabalho, o que cria risco de edições conflitantes; --spawn worktree dá às sessões criadas sob demanda worktrees Git separadas, ou seja, cópias de trabalho distintas dentro de um repositório. A sessão criada inicialmente continua usando o diretório atual. Fonte: opções do servidor.

O Dispatch é uma opção separada para delegar tarefas do celular ao Desktop; este guia trata de continuar sessões do Claude Code. Para uma comparação mais ampla, incluindo ferramentas de acesso remoto de terceiros, veja agentes de programação com IA e controle remoto pelo celular.

Cinco formas de usar no trabalho

Estas sugestões práticas partem dos controles documentados e estão ordenadas pela ajuda direta que oferecem para dar continuidade ao trabalho de desenvolvimento:

1. Você está no meio de uma correção: ative /rc e responda à próxima pergunta pelo celular, sem reiniciar a conversa.
2. Você é fundador de uma empresa e está esperando os testes: peça uma notificação de conclusão e, depois de revisar o resultado, use a sessão no celular para escolher a próxima tarefa.
3. Você desenvolve com ferramentas MCP locais: continue o mesmo projeto remotamente, sem reconstruir as conexões com as ferramentas em outro ambiente.
4. Você revisa o trabalho em outro computador: abra a URL da sessão nesse navegador e envie comentários à sessão que continua rodando no computador da mesa.
5. Você é fundador de uma empresa e precisa mostrar um problema visual: anexe uma foto ou um arquivo pelo celular para dar mais contexto à conversa em andamento.

O ganho está em reduzir as interrupções entre uma tarefa em execução e sua próxima decisão. Não é preciso inventar uma estimativa de horas economizadas: o primeiro teste útil é verificar se você consegue dar continuidade a uma tarefa real pelo outro dispositivo sem voltar à mesa. O funcionamento da sincronização, dos anexos e das ferramentas locais está documentado no guia de Remote Control.

No próximo dia de trabalho, conecte um projeto existente com /remote-control, abra a sessão no celular enquanto ainda estiver à mesa e envie uma mensagem para continuar a conversa. Depois que isso funcionar, avalie se a conexão automática e as notificações combinam com sua rotina. Se você ainda está montando seu fluxo de trabalho local, comece pelo guia de como usar o Claude Code.

Se quiser ajuda para incorporar agentes de programação a um fluxo de trabalho confiável para sua equipe, veja sistemas de IA em produção.