Claude Code Remote Control: Programe do Seu Celular Agora
Eu estava três horas dentro de uma sessão de refatoração na semana passada quando meu cachorro começou a fazer aquela coisa onde ele senta perto da porta e me olha como se eu fosse pessoalmente responsável pelo sofrimento dele. Ele precisava de um passeio. Meu agente do Claude Code estava no meio de uma tarefa — na metade da reestruturação de um módulo de autenticação em catorze arquivos. Normalmente, eu teria duas opções: abandonar a sessão e perder o contexto, ou ignorar o cachorro e me sentir culpado pela próxima hora.
Em vez disso, digitei /remote-control, escaneei um código QR com meu celular e saí pela porta da frente.
Da calçada, assisti ao Claude terminar a refatoração de autenticação na tela do meu celular. Aprovei uma edição de arquivo enquanto esperava meu cachorro investigar um hidrante suspeito. Enviei uma instrução de acompanhamento — "agora atualize os testes para corresponder à nova estrutura do módulo" — enquanto estava sentado em um banco do parque. Vinte minutos depois, voltei para dentro, sentei na minha mesa, e a sessão do terminal estava exatamente onde eu a havia deixado. Cada alteração de arquivo, cada turno de conversa, totalmente sincronizado.
Este é o novo recurso Remote Control do Claude Code, e resolve um problema que eu não percebia quanto me custava até que ele desapareceu. O problema não é que as sessões de programação são longas. O problema é que as sessões de programação são frágeis — presas à sua mesa, à janela do seu terminal, à sua presença física na frente de uma tela. Uma interrupção quebra o fluxo, e reconstruir o contexto após uma pausa custa mais tempo do que a própria pausa.
Remote Control corta essa corda. Mas a forma como funciona é diferente do que você pode esperar, e entender a arquitetura importa se você quiser usá-lo sem encontrar limitações frustrantes. Há um modelo mental específico para quando o Remote Control é a ferramenta certa versus quando o Claude Code na web é melhor, e eu errei nas duas primeiras vezes antes de entender.
O Que o Remote Control Realmente É (E o Que Não É)
O nome é preciso. Remote Control não move sua sessão para a nuvem. Não cria uma máquina virtual em algum lugar. Não replica seu ambiente nos servidores da Anthropic.
Sua sessão do Claude Code continua rodando na sua máquina local. Seu sistema de arquivos, seus servidores MCP, sua configuração de projeto, suas ferramentas — tudo fica exatamente onde está. Remote Control abre uma janela para essa sessão local a partir de outro dispositivo. Seu celular, um tablet, um navegador em um computador diferente. A janela é em tempo real e bidirecional — você pode ler e enviar mensagens de qualquer dispositivo conectado — mas a computação real nunca sai da sua máquina.
Essa distinção importa enormemente por duas razões.
Primeiro, seu ambiente local está disponível. Se seu projeto depende de servidores MCP locais, configurações de ferramentas personalizadas ou acesso ao sistema de arquivos que não existe em um sandbox na nuvem, o Remote Control preserva tudo isso. Ambientes de programação na nuvem eliminam sua configuração local. O Remote Control não a toca.
Segundo, seu terminal deve permanecer aberto. Como a sessão roda localmente, fechar seu terminal ou desligar sua máquina encerra a sessão. Este não é um recurso de "comece algo e volte amanhã". É um recurso de "afaste-se da sua mesa sem quebrar o fluxo". A distinção é sutil, mas importante, e vou explicar as implicações práticas quando chegarmos à seção de fluxos de trabalho.
A arquitetura de conexão é limpa. Sua instância local do Claude Code faz requisições HTTPS de saída para a API da Anthropic — nenhuma porta de entrada aberta na sua máquina, o que é significativo do ponto de vista de segurança. Quando você se conecta pelo celular ou navegador, a API roteia mensagens entre seu dispositivo e sua sessão local através de uma conexão streaming. Todo o tráfego viaja sobre TLS. Múltiplas credenciais de curta duração lidam com a autenticação, cada uma limitada a um propósito único e expirando independentemente.
Passei vinte minutos lendo a documentação de segurança antes de confiar neste recurso com acesso a projetos de clientes. O modelo é sólido — é funcionalmente a mesma segurança de transporte de uma sessão normal do Claude Code, apenas com uma camada de roteamento adicional.
Agora que você sabe o que é, veja como realmente usá-lo. E há um jeito certo que economiza tempo e um jeito errado que o desperdiça.
Configurando — Dois Minutos, Não Vinte
A configuração é deliberadamente mínima, o que eu aprecio depois de anos de ferramentas de desenvolvimento que exigem rituais de configuração de trinta minutos.
Pré-requisitos que você provavelmente já tem:
Você precisa de um plano Pro ou Max — chaves de API não funcionam com o Remote Control. Você precisa estar logado via /login no Claude Code. E precisa ter executado claude no diretório do seu projeto pelo menos uma vez para aceitar o diálogo de confiança do workspace.
Se você já usa o Claude Code há algum tempo, já atende aos três requisitos. Se é completamente novo, a configuração leva menos de dois minutos.
Iniciando uma nova sessão de Remote Control:
Navegue até o diretório do seu projeto e execute:
claude remote-control
É isso. O processo fica rodando no seu terminal, esperando conexões remotas. Ele exibe uma URL de sessão e — este é o detalhe chave de qualidade de vida — você pode pressionar a barra de espaço para mostrar um código QR. Aponte a câmera do seu celular para o código QR e você está conectado.
O comando suporta duas flags úteis:
--verbosemostra logs detalhados de conexão e sessão, que eu uso ao debugar problemas de conexão--sandbox/--no-sandboxhabilita ou desabilita o sandboxing de sistema de arquivos e rede durante a sessão. O sandboxing está desabilitado por padrão, o que faz sentido para a maioria dos fluxos de trabalho de desenvolvimento onde você precisa de acesso completo ao sistema de arquivos
Conectando-se a partir de uma sessão existente (o cenário mais comum):
Se você já está no meio de uma conversa no Claude Code e quer ir para o mobile, digite:
/remote-control
Ou o alias mais curto:
/rc
Este é o comando que uso 90% das vezes. Ele carrega todo o seu histórico de conversa — cada mensagem, cada edição de arquivo, cada chamada de ferramenta — e gera a URL da sessão e o código QR na hora. Você não perde uma única linha de contexto.
Dica profissional: Antes de executar /remote-control, use /rename para dar à sua sessão um nome descritivo. "Refatoração de auth - Fev 2026" é muito mais fácil de encontrar na lista de sessões entre dispositivos do que "Sessão de Remote Control", que é o nome padrão quando não há histórico de conversa.
Conectando-se do seu celular ou outro dispositivo:
Três opções, escolha a que melhor se adapta à sua situação:
- Escaneie o código QR — caminho mais rápido do terminal ao celular. Abre diretamente no app do Claude se você o tiver instalado.
- Abra a URL da sessão — exibida no seu terminal junto ao código QR. Funciona em qualquer navegador.
- Encontre na lista de sessões — abra claude.ai/code ou o app do Claude e procure sua sessão pelo nome. Sessões de Remote Control mostram um ícone de computador com um ponto verde de status quando estão online e conectadas.
Se você ainda não tem o app móvel do Claude, o comando /mobile dentro do Claude Code exibe um código QR de download para iOS ou Android. Toque de classe.
Modo sempre ativo (para os comprometidos):
Se você quer que cada sessão do Claude Code seja remotamente acessível sem executar explicitamente /remote-control toda vez, execute /config dentro do Claude Code e defina "Enable Remote Control for all sessions" como true. Estou rodando com isso habilitado há uma semana e não olhei para trás. A sobrecarga é desprezível, e a opcionalidade vale a pena.
A configuração é simples. O design do fluxo de trabalho é onde fica interessante — e onde a maioria das pessoas vai amar esse recurso ou subutilizá-lo.
Os Fluxos de Trabalho Que Realmente Importam
Após duas semanas de uso diário, encontrei três padrões onde o Remote Control genuinamente muda como eu trabalho, e duas situações onde é a ferramenta errada.
Padrão 1: O Fluxo de Trabalho de Levantar e Sair
Este é o óbvio, e é o da minha história inicial. Você está no meio de uma tarefa complexa. A vida interrompe — um cachorro, uma entrega, uma reunião, o almoço, um ser humano que quer falar com você sobre algo que não é código.
Antes do Remote Control, você tinha duas opções ruins: pausar a IA (perdendo impulso e potencialmente contexto) ou ignorar a interrupção (perdendo sua humanidade, lentamente).
Agora você digita /rc, escaneia o código QR e sai caminhando. A sessão continua. Você pode monitorar passivamente o progresso, aprovar alterações de arquivos ou enviar instruções de acompanhamento do seu celular. Quando se senta de novo, o terminal está totalmente sincronizado.
Comecei a estruturar meus dias em torno disso. Inicio uma tarefa, vou fazer café, verifico o progresso da cozinha. Começo uma suíte de testes, caminho até uma reunião, confiro resultados pelo celular durante um momento de calmaria. As sessões de trabalho têm a mesma duração, mas estão entrelaçadas com o resto do meu dia em vez de exigir blocos ininterruptos.
Padrão 2: A Revisão do Sofá
Final do dia. Estive na minha mesa por horas. Não quero mais sentar na frente de um monitor, mas tenho uma sessão do Claude Code com código gerado que preciso revisar antes de amanhã.
O Remote Control transforma isso em uma atividade de sofá. Conecto pelo celular, navego pela conversa e alterações de arquivos, deixo comentários de revisão e instruções de acompanhamento, e fecho meu laptop sem culpa. A sessão me espera até de manhã (desde que o terminal permaneça aberto — mais sobre isso na seção de limitações).
Esse padrão é menos sobre produtividade e mais sobre conforto físico e sustentabilidade mental. Revisar código gerado por IA na tela de um celular não é ideal para análise profunda, mas é perfeitamente adequado para revisão de alto nível e feedback direcional. A análise detalhada pode acontecer na mesa amanhã, com uma perspectiva fresca e todo o contexto preservado.
Padrão 3: A Programação em Par Multi-Dispositivo
Este me surpreendeu. Comecei a manter o Claude Code rodando no meu desktop enquanto trabalho em uma tarefa diferente no meu laptop. Quando preciso referenciar algo da sessão do Claude — um trecho de código, uma decisão de arquitetura, um caminho de arquivo — confiro no meu celular em vez de trocar de contexto entre máquinas.
Parece menor. Não é. Trocar de contexto entre janelas ou telas interrompe a atenção de uma forma que dar uma olhada no celular não faz. O celular se torna um dashboard somente leitura para a sessão de IA enquanto minha tela principal permanece focada no que quer que eu esteja trabalhando ativamente.
Quando o Remote Control é a ferramenta errada:
Se você quer iniciar uma tarefa sem nenhuma configuração local — sem projeto clonado, sem ambiente configurado — use o Claude Code na web. O Remote Control requer uma sessão local rodando. Sem sessão local, sem controle remoto.
Se você precisa executar múltiplas tarefas paralelas em um projeto, o Remote Control suporta uma sessão por vez por instância do Claude Code. Para trabalho paralelo, o Claude Code na web com infraestrutura na nuvem é a melhor escolha.
Cometi esse erro no primeiro dia. Tentei iniciar uma segunda sessão de Remote Control no mesmo projeto enquanto a primeira ainda estava ativa. O sistema lidou com isso elegantemente — perguntou se eu queria continuar a sessão existente ou iniciar uma nova — mas percebi que o fluxo de trabalho paralelo que eu queria precisava de infraestrutura na nuvem, não de acesso remoto a uma única sessão local.
O modelo mental é simples: Remote Control estende sua mesa. Claude Code na web a substitui. Ferramentas diferentes para situações diferentes.
O Que Acontece Quando as Coisas Dão Errado
Testei os modos de falha para que você não tenha que descobri-los durante uma demo com um cliente.
O laptop dorme: A sessão se reconecta automaticamente quando sua máquina acorda. Testei isso fechando a tampa do meu MacBook, esperando cinco minutos, abrindo novamente. A sessão do celular se reconectou em aproximadamente oito segundos. Sem mensagens perdidas, sem contexto perdido. Este é o melhor detalhe de qualidade de vida do recurso.
Queda temporária de rede: A mesma recuperação elegante. A sessão tolera desconexões breves sem nenhuma intervenção. Testei isso alternando o modo avião no meu celular por trinta segundos. A reconexão foi perfeita.
Queda de rede prolongada: Se sua máquina está acordada mas não consegue alcançar a rede por aproximadamente dez minutos, a sessão expira e o processo termina. Você precisará executar claude remote-control novamente para iniciar uma nova sessão. O histórico de conversa não é perdido — você pode retomar de onde parou — mas a conexão remota ativa precisa ser restabelecida.
O terminal fecha: A sessão termina. Ponto final. Este é o único cenário não recuperável. Se seu processo do terminal morre — fechando acidentalmente a janela, um reinício do sistema, um crash — a sessão de Remote Control termina. Você pode iniciar uma nova, mas a continuidade sem interrupções se quebra.
Minha mitigação: executo o Claude Code em uma sessão tmux na minha máquina de desenvolvimento. Mesmo se eu acidentalmente fechar o aplicativo do terminal, a sessão tmux persiste e o processo do Claude Code continua vivo. Se você planeja usar o Remote Control regularmente, recomendo fortemente essa abordagem. Cinco minutos de configuração do tmux te salvam do modo de falha mais comum.
# Inicie uma sessão tmux para o Claude Code
tmux new -s claude
# Dentro do tmux, navegue e inicie o remote control
cd /path/to/your/project
claude remote-control
# Desconecte com Ctrl+B depois D — a sessão continua rodando
# Reconecte depois com: tmux attach -t claude
Dica profissional: Configure um alias simples no seu .zshrc ou .bashrc:
alias ccr='tmux new -s claude -d "cd /path/to/project && claude remote-control"'
Um comando, e você tem uma sessão persistente de Remote Control que sobrevive a fechamentos de terminal.
A Pergunta de Segurança Que Você Deveria Estar Fazendo
Sempre que uma ferramenta diz "acesse seu sistema de arquivos local do seu celular pela internet", seus instintos de segurança devem ser ativados. Os meus foram.
Aqui está o que verifiquei antes de usar isso em projetos de clientes:
Sem portas de entrada. Sua máquina só faz conexões HTTPS de saída. Nada escuta tráfego de entrada. Isso elimina toda a categoria de ataques "alguém escaneia minhas portas abertas e encontra minha sessão de programação".
TLS em todo lugar. Todo o tráfego entre sua máquina e a API da Anthropic, e entre seu celular e a API, viaja sobre TLS. O mesmo padrão de criptografia do seu uso normal do Claude Code.
Credenciais com escopo definido. A autenticação usa múltiplos tokens de curta duração, cada um limitado a um propósito específico e expirando independentemente. Se um token é comprometido, o raio de explosão é contido.
Isolamento de sessão. Cada instância do Claude Code tem sua própria sessão remota. Sem contaminação cruzada entre projetos ou instâncias.
É tão seguro quanto rodar o Claude Code puramente local sem envolvimento de rede? Não — qualquer recurso em rede introduz superfície de ataque. Mas o modelo de segurança é bem projetado para o que faz. O perfil de risco é comparável a usar qualquer serviço na nuvem autenticado sobre TLS, que é uma barra que a maioria de nós já ultrapassa diariamente com dezenas de outras ferramentas.
Para projetos de clientes com código sensível, uso a flag --sandbox para habilitar isolamento de sistema de arquivos e rede durante sessões remotas. Cinto e suspensório.
Minha Configuração Diária Real Após Duas Semanas
Veja como meu fluxo de trabalho se parece agora que o Remote Control faz parte da minha rotina diária:
Manhã: Abro o terminal, inicio uma sessão tmux, executo claude remote-control no diretório do meu projeto principal. A sessão fica viva o dia todo.
Blocos de trabalho: Programo na minha mesa usando o terminal diretamente. O Claude Code roda normalmente — não estou usando pela interface remota quando estou sentado na minha máquina.
Pausas: Escaneio o código QR, saio. Monitoro pelo celular. Aprovo alterações, envio instruções rápidas, mantenho o impulso sem ficar preso à tela.
Trocas de contexto: Quando preciso pivotar para uma tarefa diferente mas quero que a sessão do Claude continue trabalhando, deixo ela rodando e verifico o progresso pelo celular periodicamente.
Final do dia: Revisão do sofá pelo celular. Deixo instruções para a primeira tarefa de amanhã. Fecho o laptop.
Manhã seguinte: Reconecto a sessão tmux. Tudo está esperando exatamente onde deixei.
O efeito cumulativo após duas semanas: passo aproximadamente 30% menos tempo fisicamente na minha mesa com zero perda em qualidade ou volume de produção do Claude Code. As pausas não são mais perdas de produtividade — são recursos de produtividade porque não estou perdendo o contexto da sessão toda vez que me levanto.
É isso que o anúncio do recurso não captura totalmente sobre o Remote Control. A capacidade técnica — "continue sessões do seu celular" — soa como uma conveniência. E é. Mas o efeito de segunda ordem é maior. Ele muda a forma do seu dia de trabalho. Programar deixa de ser algo que requer presença contínua em uma mesa e se torna algo que flui ao redor do resto da sua vida.
Meu cachorro é passeado na hora agora. Eu almoço longe da minha tela. Atendo ligações sem ansiedade sobre perder o estado da sessão. E o código continua sendo escrito.
Todo desenvolvedor que conheço reclama de estar preso à mesa durante longas sessões de programação com IA. A corrente acabou de ficar muito mais longa. /rc, escanear, caminhar.
Experimente hoje à noite. Inicie uma tarefa de refatoração que você vem adiando. Digite /rc. Vá para algum lugar que não seja sua mesa.
Você pode se surpreender com o quão bem o código fica quando você o revisa de um banco do parque.
Vamos Trabalhar Juntos
Procurando construir sistemas de IA, automatizar fluxos de trabalho ou escalar sua infraestrutura tecnológica? Adoraria ajudar.
- Fiverr (builds personalizados e integrações): fiverr.com/s/EgxYmWD
- Portfolio: mejba.me
- Ramlit Limited (soluções empresariais): ramlit.com
- ColorPark (design e branding): colorpark.io
- xCyberSecurity (serviços de segurança): xcybersecurity.io
