Como usar o Claude Code Remote Control? Controle remoto pelo celular, limitações oficiais e alternativas (2026)

A maneira oficial mais rápida: atualize o Claude Code para a versão atual, execute claude remote-control no diretório do projeto, e abra claude.ai/code no app Claude do celular ou no navegador para iniciar e controlar a sessão que continua rodando no seu computador. Se a sessão já estiver aberta, digite /remote-control; se quiser continuar operando também no terminal local, use claude --remote-control.

Se você usa apenas o Claude Code oficial e a assinatura do Claude.ai, priorize o Remote Control oficial. Se você usa API Key, Bedrock, Vertex, ANTHROPIC_BASE_URL personalizado, ou deseja controlar remotamente Codex, PandaCode, DeepSeek harness e várias máquinas de desenvolvimento em uma mesma interface, considere então o PandaNpc. Este artigo explica claramente os dois caminhos, sem a necessidade de adivinhar qual é o adequado para você.

As informações e comandos foram verificados em 30 de agosto de 2026 de acordo com a documentação oficial do Anthropic Remote Control. O Claude Code é atualizado rapidamente; os comandos realmente disponíveis ainda seguem o claude --help e /help da sua máquina.

Três formas de iniciar o Claude Code Remote Control

Os três comandos não são sinônimos; a diferença está de onde você quer começar:

A execução do Remote Control oficial permanece na sua máquina: arquivos do projeto, MCP, ferramentas e configurações não são movidos para um novo contêiner em nuvem; o celular e o navegador são apenas interfaces de controle remoto. Isso difere do Claude Code on the web, que roda no ambiente de nuvem gerenciado pela Anthropic.

Usando o Remote Control oficial: da verificação à conexão bem-sucedida

Passo 1: Confirme a versão, o login e o workspace

Primeiro, execute na máquina de desenvolvimento:

claude --version

A documentação oficial exige o Claude Code v2.1.51 ou posterior. Em seguida, inicie o claude normalmente no diretório do projeto e conclua o /login e a confirmação de confiança do workspace. O Remote Control usa a identidade do Claude.ai; atualmente a documentação oficial afirma explicitamente que API Key não é suportada. Se organizações Team ou Enterprise não virem a opção, o administrador também precisa habilitar o Remote Control nas configurações de gerenciamento do Claude Code.

Passo 2: Escolha um modo de inicialização

Se quiser escolher o diretório pelo celular e iniciar uma nova sessão, execute:

cd /path/to/project
claude remote-control --name "My Project"

Se quiser continuar digitando no terminal da máquina de desenvolvimento e permitir que o celular assuma, execute:

cd /path/to/project
claude --remote-control "My Project"

Se já houver uma sessão, digite diretamente:

/remote-control My Project

O terminal mostrará a URL da sessão; no modo claude remote-control, pressionar a barra de espaço também exibe o código QR.

Passo 3: Conecte-se pelo celular ou navegador

Use a mesma conta Claude:

• No navegador, abra https://claude.ai/code e escolha a sessão com o ícone de computador na lista de sessões;
• No iOS ou Android, abra o app Claude e entre na aba Code;
• Ou abra diretamente a URL fornecida pelo terminal ou escaneie o código QR.

Após a primeira conexão, envie um prompt de verificação somente leitura e não aprove imediatamente a gravação de arquivos:

Imprima o diretório de trabalho atual e mostre git status --short. Não modifique nada.

Somente quando o caminho estiver correto, o status do Git estiver de acordo com o esperado e a confirmação de permissão aparecer no celular ou navegador é que a conexão estará realmente estabelecida.

Como escolher entre Remote Control oficial, Claude Code Web e PandaNpc

Portanto, a escolha é simples: use o oficial se os recursos oficiais atenderem à sua necessidade. O valor do PandaNpc não é reembalar o mesmo comando oficial, mas preencher os cenários de mecanismos cruzados, API/modelos personalizados, gerenciamento unificado de várias máquinas e redes privadas de dispositivos.

Quando a solução oficial não se aplica: use o PandaNpc para controlar remotamente o agente local

O PandaPaw do PandaNpc roda ao lado da máquina de desenvolvimento e registra mecanismos locais como Claude Code, Codex, etc., como conexões remotas. As chamadas de modelo continuam seguindo a conta e a configuração do provedor de cada mecanismo; o lado remoto apenas envia instruções, exibe resultados e lida com aprovações.

Passo 1: Instale e faça login no PandaPaw na máquina de desenvolvimento

macOS / Linux:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows (PowerShell como administrador):

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

O instalador abrirá uma página de autorização no navegador. Após aprovar, verifique:

pandapaw status

Passo 2: Escolha o host e o projeto na página do agente

Abra o PandaNpc Agent no navegador, confirme que a máquina de destino está online em verde, selecione Claude Code e o diretório correto do projeto e envie o prompt de verificação somente leitura de antes. Os clientes mobile e desktop usam a mesma lista de conexões.

Se você só se preocupa com os cartões de permissão, cartões de perguntas e Live Activity no iPhone, continue lendo o fluxo de trabalho iOS para conectar o Claude Code pelo celular.

Várias máquinas e vários agentes: não faça mapeamento de portas uma a uma

Quando você tem apenas uma máquina de desenvolvimento, uma sessão remota é suficiente; quando Claude Code, Codex e outros agentes estão distribuídos entre desktops, notebooks, NAS, servidores em nuvem ou contêineres de desenvolvimento, o problema real passa a ser descoberta de hosts e interconexão segura.

O dispositivos conectados do PandaNpc adiciona as máquinas da sua conta a uma rede privada criptografada, atribui a cada máquina um IP privado estável e registra automaticamente os agentes que ela pode executar. Os dispositivos preferem conexão ponto a ponto e caem para retransmissão quando a perfuração de NAT não é possível; todo o processo não exige IP público ou mapeamento de portas no roteador. Assim, o celular só precisa escolher "qual máquina, qual agente, qual projeto", sem precisar guardar um conjunto de portas SSH, DDNS e chaves de longo prazo.

Esse tipo de rede de dispositivos resolve "se os agentes conseguem se alcançar uns aos outros com segurança"; a divisão de tarefas, o compartilhamento de contexto e a consolidação de resultados ainda pertencem à camada de orquestração de múltiplos agentes. As duas coisas não devem ser confundidas.

Perguntas frequentes e solução de problemas

`claude remote-control` ou `/remote-control` não existe

Primeiro verifique claude --version. O comando principal requer pelo menos a v2.1.51; o suporte ao VS Code exige uma versão mais recente. Após atualizar, reabra o terminal e a sessão. Se ainda não aparecer, execute /help e confirme se a política da organização não desativou o Remote Control.

Não encontro o computador ou a sessão no celular

Confirme se o celular, o navegador e a CLI estão logados na mesma conta e organização Claude, e se o processo claude remote-control ainda está em execução na máquina de desenvolvimento. No celular, entre na aba Code, não na lista de conversas comum.

Não consigo ativar ao usar API Key, Bedrock, Vertex ou gateway personalizado

O Remote Control oficial atualmente exige login no Claude.ai e não oferece suporte a API Key. Primeiro confirme se essa é a autenticação que você precisa manter; se puder voltar ao login por assinatura, use o oficial; se não puder, use uma solução que consiga conectar a CLI local, como o PandaNpc. Não altere secretamente o gateway ou a política de identidade do ambiente de produção apenas para controle remoto.

O computador pode ser desligado ou ter a tampa fechada?

Não. A tela pode ser desligada, mas o host que executa o agente precisa permanecer ligado, os processos Claude/PandaPaw precisam estar ativos e com acesso à internet. O Remote Control oficial reconecta automaticamente após o host se recuperar; se houver suspensão frequente, troca de rede ou aparecer "online, mas sem novas mensagens", verifique item por item seguindo a lista de verificação para desconexões remotas do Claude Code.

Várias sessões remotas podem modificar o mesmo arquivo?

Há risco de conflito. O modo servidor oficial, por padrão, pode criar várias sessões a partir do mesmo diretório; para modificações paralelas, use claude remote-control --spawn worktree para que a sessão tenha um Git worktree independente. No PandaNpc, também devem ser escolhidos workspaces ou worktrees diferentes para agentes paralelos; não deixe duas sessões de escrita operarem no mesmo checkout simultaneamente.

O PandaNpc mostra a máquina offline

Execute pandapaw status no host e confirme, nesta ordem, a autorização da conta, o serviço em segundo plano, o HTTPS/WebSocket de saída e o login do mecanismo correspondente. Abrir uma porta de entrada pública não corrige uma conexão de saída bloqueada pelo proxy da empresa.

Limites de segurança: o código está local, mas isso não significa que nada passa pela rede

O Remote Control oficial estabelece uma conexão HTTPS de saída ativamente a partir da máquina local e não abre portas de entrada no roteador; as mensagens são transmitidas entre a interface remota e a sessão local por uma conexão TLS da API da Anthropic. Os arquivos do projeto e a execução de ferramentas permanecem no host, mas, para exibir a conversa e processar instruções, os dados da sessão ainda precisam passar pelos serviços oficiais.

O PandaNpc também faz o host se conectar ativamente à retransmissão de autenticação, e a execução permanece no host; as mensagens, status, diffs e aprovações que o lado remoto precisa exibir passam pela retransmissão. Independentemente da solução usada, você deve:

• Verificar o host e o diretório de trabalho antes de aprovar gravação de arquivos ou execução de comandos;
• Não compartilhar a conexão remota com pessoas não confiáveis;
• Em projetos sensíveis, priorizar a aprovação padrão ou o modo somente edição;
• Em dispositivos da empresa, cumprir os requisitos de VPN, VDI, identidade e auditoria aprovados pela empresa.

FAQ

What is Claude Code Remote Control?

Ele permite que o Claude App ou o claude.ai/code controlem um Claude Code que continua rodando no seu computador. O celular e o navegador são a interface remota; os arquivos locais, MCP, ferramentas e configurações do projeto permanecem na máquina de desenvolvimento.

Como uso o Claude Code pelo meu celular?

Na máquina de desenvolvimento, execute claude remote-control, claude --remote-control ou digite /remote-control em uma sessão existente; em seguida, com a mesma conta, abra a aba Code do Claude App ou claude.ai/code. Se também precisar controlar Codex, modelos personalizados ou várias máquinas, use a página Agent do PandaNpc.

O Claude Code Remote Control é compatível com navegadores?

Sim. A entrada oficial é claude.ai/code; o PandaNpc também oferece clientes para navegador, iOS e desktop. Ambos fazem o agente executar no host, em vez de copiar todo o projeto para o navegador atual.

O Claude Code Remote Control suporta API Key?

Atualmente, a documentação oficial afirma explicitamente que API Key não é suportada; é necessário fazer login via Claude.ai. Se o seu Claude Code precisar usar API, Bedrock, Vertex ou um ANTHROPIC_BASE_URL personalizado, mantenha a autenticação original e escolha uma solução remota que consiga conectar a CLI local.

Se o celular ficar sem internet, o Claude Code vai parar?

Enquanto a máquina de desenvolvimento e o processo do agente continuarem online, o celular ficar sem internet ou a página ser fechada não equivale a interromper a sessão no host. Após reconectar, você pode continuar visualizando. Mas quando a máquina de desenvolvimento dorme, desliga ou fica sem internet por muito tempo, não é possível executar novos trabalhos.

O Remote Control oficial pode controlar o Codex ou vários agentes?

Não; ele é um recurso do Claude Code. Para gerenciar Claude Code, Codex, PandaCode, DeepSeek harness, Pi e várias máquinas na mesma interface, é necessária uma camada adicional de conexão multi-mecanismo; o PandaPaw e os dispositivos conectados do PandaNpc foram projetados para esse cenário.

Conclusão

Se você só quer continuar uma sessão oficial do Claude Code pelo celular ou navegador: execute claude remote-control, a solução oficial é a mais curta e direta. Se precisar de API/modelos personalizados, outros mecanismos como Codex, várias máquinas ou redes privadas de dispositivos: mantenha a configuração do agente local e use o PandaPaw para unificar as conexões no PandaNpc.

Independentemente do caminho escolhido, o critério de sucesso não é "a página mostra online", mas sim que o lado remoto consiga ler o diretório de trabalho correto, ver o status real do Git, receber a confirmação de permissão e continuar a mesma sessão local após reconexão.