O Que Você Vai Aprender

Este guia orienta você em todos os métodos de uso do Claude Code remotamente — desde o recurso oficial Remote Control da Anthropic até configurações DIY de SSH com tmux, mosh e Tailscale. Ao final, você terá uma configuração de codificação móvel funcional onde poderá iniciar tarefas em seu desktop, sair do escritório e manter o controle total pelo seu celular.

Claude Code Remote Control: O Guia Completo 2026

Em February 25, 2026, a Anthropic lançou o Remote Control — a capacidade de iniciar uma tarefa de codificação em seu terminal, colocar seu laptop na mochila e manter o controle total pelo seu celular. Sem VPN, sem redirecionamento de portas, sem a necessidade de ferramentas de terceiros. Fonte

Mas o recurso oficial é apenas uma parte da história. A comunidade de desenvolvedores construiu um ecossistema inteiro de configurações de codificação móvel em torno do Claude Code, variando de túneis SSH simples a fluxos de trabalho multi-ferramentas sofisticados com notificações push e entrada de voz. Este guia cobre todos eles.

Parte 1: Remote Control Oficial

O Que É

Remote Control é o recurso integrado da Anthropic para continuar sessões do Claude Code entre dispositivos. Ele funciona fazendo com que sua instância local do Claude Code se registre na Anthropic API como um servidor, permitindo que clientes autorizados (seu celular) se conectem e controlem a sessão remotamente. Fonte

Como Funciona por Baixo do Capô

O modelo de segurança é direto e conservador:

Seu Desktop (Claude Code)           Anthropic API           Seu Celular (Claude App)
        │                                │                          │
        ├──── Registrar sessão ──────────►│                          │
        │                                │                          │
        │◄─── Atribuir URL da sessão ────┤                          │
        │                                │                          │
        │     Exibir QR code             │                          │
        │                                │◄──── Escanear QR / Auth ─┤
        │                                │                          │
        │◄─── Roteamento de mensagens ───┤──── Roteamento de msgs ─►│
        │                                │                          │
        │     (Todo o tráfego via TLS)   │                          │

Propriedades de segurança principais:

• Sem portas de entrada — sua máquina local faz apenas requisições HTTPS de saída.
• Sem conexão direta — seu celular nunca se conecta diretamente ao seu desktop.
• Criptografia TLS — todo o tráfego flui através da Anthropic API via TLS.
• Escopo de sessão — cada sessão de Remote Control tem uma URL única que expira.

Fonte

Passos de Configuração

Passo 1: Atualize o Claude Code

O Remote Control requer o Claude Code v2.1.51 ou superior:

# Check your version
claude --version

# Update if needed
npm update -g @anthropic-ai/claude-code

Passo 2: Inicie uma Sessão

Comece a trabalhar em seu projeto normalmente:

cd ~/projects/my-app
claude

Passo 3: Ative o Remote Control

Dentro da sua sessão do Claude Code, execute:

/rc
# or
/remote-control

Isso inicia o servidor de Remote Control. Seu terminal exibirá:

Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control

Passo 4: Conecte pelo Seu Celular

Duas opções:

1. QR Code: Pressione a barra de espaço em seu terminal para exibir um QR code. Abra o app Claude em seu celular e escaneie-o.
2. URL: Copie a URL da sessão e abra-a no app Claude em seu celular.

Seu celular agora tem controle total da sessão do Claude Code. Você pode enviar mensagens, aprovar alterações de arquivos e revisar saídas — a conversa permanece sincronizada em todos os dispositivos conectados. Fonte

Ativando o Remote Control por Padrão

Se você usa o Remote Control com frequência, ative-o para todas as sessões:

/mobile

Isso exibe um QR code para instalar o app Claude se você ainda não o fez, e alterna a configuração "Enable Remote Control for all sessions" para true. Uma vez ativado, cada sessão do Claude Code inicia automaticamente no modo Remote Control. Fonte

Requisitos de Plano

Fonte

Limitações do Remote Control

• Requer o app Claude — você não pode usar um navegador genérico; o app móvel Claude é obrigatório.
• Dependência da Anthropic — todo o tráfego é roteado pelos servidores da Anthropic; se a API deles estiver fora do ar, o Remote Control também estará.
• Sem suporte offline — ambos os dispositivos devem ter conectividade com a internet.
• Timeout de sessão — sessões inativas eventualmente expiram.
• Provedor único — funciona apenas com modelos Claude, não se você estiver usando OpenCode ou outras ferramentas multi-provedor.

Parte 2: SSH + tmux + mosh (A Abordagem DIY)

Para desenvolvedores que desejam controle total do terminal, suporte a multi-provedores ou trabalham em redes instáveis, a abordagem baseada em SSH é mais robusta. Como escreveu o desenvolvedor Harper Reed: "Ao descobrir como usar o Claude Code em um telefone, a resposta óbvia foi fazer ssh em um computador a partir de um telefone e rodar o claude." Fonte

Por Que Três Ferramentas?

Você precisa de dois tipos diferentes de resiliência:

• mosh lida com a conexão móvel instável — transições de WiFi para dados móveis, zonas mortas, celular em modo de repouso.
• tmux lida com a persistência da sessão — mantém a sessão do Claude Code viva mesmo quando seu celular desconecta completamente.

Juntos, eles tornam o desenvolvimento móvel realmente viável. Fonte

Configurando a Pilha

Passo 1: Instale o Tailscale (Rede Privada)

O Tailscale cria uma malha WireGuard privada entre seus dispositivos. Sem redirecionamento de portas, sem configuração de roteador, sem regras de firewall.

Em seu desktop:

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Start Tailscale
sudo tailscale up

Em seu celular:

• Instale o app Tailscale da sua loja de aplicativos.
• Faça login com a mesma conta.
• Ambos os dispositivos estão agora na mesma rede privada.

Seu desktop recebe um IP Tailscale (algo como 100.64.x.x) que seu celular pode acessar diretamente, independentemente de qual WiFi ou rede móvel qualquer um dos dispositivos esteja usando. Fonte

Passo 2: Instale o tmux (Persistência de Sessão)

O tmux mantém suas sessões de terminal vivas independentemente da sua conexão SSH. Quando seu celular desconecta (bloqueio de tela, troca de rede, bateria descarregada), a sessão tmux continua rodando.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

Crie uma configuração de tmux otimizada para uso móvel:

# ~/.tmux.conf

# Increase scrollback buffer
set -g history-limit 50000

# Enable mouse support (useful on mobile)
set -g mouse on

# Reduce escape-time for responsive mobile input
set -sg escape-time 10

# Status bar with useful info
set -g status-right '#H | %H:%M'

# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'

Passo 3: Instale o mosh (Resiliência de Conexão)

O mosh (Mobile Shell) usa UDP em vez de TCP, o que lida com transições de rede de forma graciosa. Quando seu celular muda de WiFi para dados móveis ou passa por um túnel, o mosh reconecta automaticamente.

Em seu desktop:

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

Em seu celular:

• iOS: Instale Blink Shell ou Termius — ambos suportam mosh nativamente.
• Android: Instale JuiceSSH ou Termux com o pacote mosh.

Passo 4: Conecte e Inicie o Claude Code

Do cliente SSH do seu celular:

# Connect via mosh through Tailscale
mosh user@100.64.x.x

# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude

# Launch Claude Code
cd ~/projects/my-app
claude

Agora você tem uma sessão do Claude Code que:

• Sobrevive a trocas de rede (mosh).
• Sobrevive a desconexões de celular (tmux).
• É acessível de qualquer dispositivo em sua rede Tailscale.
• Funciona com qualquer provedor de AI, não apenas o Claude.

Reconectando Após a Desconexão

Quando você pegar seu celular mais tarde:

# mosh will auto-reconnect if the session is still alive
# If mosh session died, start a new one:
mosh user@100.64.x.x

# Reattach to your tmux session
tmux attach -t claude

Sua sessão do Claude Code está exatamente onde você a deixou — mesma conversa, mesmo diretório de trabalho, mesmas alterações pendentes.

Parte 3: Notificações Push com ntfy

O problema com as configurações de Remote Control e SSH é que você precisa ficar checando seu celular para ver se o Claude Code terminou sua tarefa. A solução são as notificações push.

O que é ntfy?

ntfy é um serviço de notificação push simples e de código aberto. Você pode hospedá-lo por conta própria para privacidade ou usar a instância pública em ntfy.sh. Fonte

ntfy Auto-Hospedado com Tailscale

Para máxima privacidade, execute o ntfy em seu desktop e acesse-o através do Tailscale:

# Install ntfy
brew install ntfy  # macOS
# or
sudo apt install ntfy  # Linux

# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090

Como seu celular e desktop estão na mesma rede Tailscale, seu celular pode acessar o ntfy em http://100.64.x.x:8090. Nenhum dado sai da sua rede privada.

Configurando Hooks do Claude Code

Hooks do Claude Code permitem que você acione comandos personalizados quando certos eventos ocorrem. Configure um hook para enviar uma notificação quando o Claude Code precisar de entrada:

// ~/.claude/settings.json
{
  "hooks": {
    "notification": {
      "command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
      "event": "stop"
    }
  }
}

Fonte

Configuração do App Móvel ntfy

1. Instale o app ntfy em seu celular (iOS ou Android).
2. Adicione uma assinatura para o tópico claude-code em seu servidor auto-hospedado (http://100.64.x.x:8090/claude-code).
3. Ative as notificações push para o tópico.

Agora, sempre que o Claude Code parar e precisar de entrada — seja porque terminou uma tarefa, encontrou um erro ou precisa de aprovação — você receberá uma notificação push em seu celular. Não há necessidade de manter o terminal aberto ou verificar constantemente.

Configuração Avançada de Notificações

Para notificações com mais contexto, você pode incluir a última mensagem do Claude Code:

#!/bin/bash
# ~/.claude/hooks/notify.sh

# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")

# Send notification with context
curl -s \
  -H "Title: Claude Code" \
  -H "Priority: high" \
  -H "Tags: robot" \
  -d "$LAST_OUTPUT" \
  http://100.64.x.x:8090/claude-code

Fonte

Parte 4: Happy Coder (Alternativa Gratuita de Código Aberto)

Happy Coder é uma ferramenta gratuita e de código aberto que fornece uma interface web para controlar o Claude Code remotamente, com notificações push integradas e entrada de voz. Fonte

Recursos Principais

• Gratuito e código aberto — nenhuma assinatura necessária além do seu plano do Claude Code.
• Notificações push — sistema de notificação integrado, sem necessidade de configurar ntfy.
• Entrada de voz — fale comandos em vez de digitar em uma tela pequena.
• Suporte multi-agente — funciona com Codex junto ao Claude Code.
• Baseado na web — funciona em qualquer navegador móvel, sem necessidade de instalação de app.

Configuração

# Install Happy Coder
npm install -g happy-coder

# Start the server
happy-coder start --port 3000

# Access from your phone via Tailscale
# http://100.64.x.x:3000

O Happy Coder fornece uma interface web otimizada para dispositivos móveis que exibe sua conversa com o Claude Code, permite enviar mensagens e mostra alterações de arquivos — tudo através do seu navegador.

Parte 5: Comparação Completa de Configurações

Matriz de Comparação de Métodos

Configuração Recomendada por Caso de Uso

Usuário casual (checa tarefas ocasionalmente): → Remote Control. Um comando, um escaneamento de QR, pronto.

Codificador móvel diário (codifica frequentemente do celular): → SSH + tmux + mosh + ntfy. Máxima resiliência e controle.

Líder de equipe (monitora múltiplas sessões): → Happy Coder. Baseado na web, suporta múltiplos agentes, notificações integradas.

Desenvolvedor multi-provedor (usa Claude, Codex e modelos locais): → SSH + tmux + mosh. Funciona com qualquer ferramenta que rode em um terminal.

Parte 6: Configurações Avançadas

Executando Múltiplas Sessões do Claude Code

Com o tmux, você pode executar múltiplas sessões do Claude Code em paralelo e alternar entre elas:

# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests

# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m

# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend

Configuração de VM Linux Headless

Para equipes que desejam um ambiente de codificação remoto dedicado, o Claude Code Remote Control funciona em VMs Linux headless via SSH + tmux. Fonte

# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Start in a tmux session
tmux new-session -s remote-claude

# Launch Claude Code
claude

# Start Remote Control
/rc

Em seguida, escaneie o QR code do seu celular. Isso oferece um poderoso ambiente de desenvolvimento baseado em nuvem controlado inteiramente pelo celular.

Combinando Remote Control com SSH

Você pode usar ambos os métodos juntos para máxima flexibilidade:

1. SSH + tmux para persistência de sessão e acesso total ao terminal.
2. Remote Control dentro da sessão tmux para a interface de chat amigável para dispositivos móveis.

# SSH into your machine
mosh user@100.64.x.x

# Attach to tmux
tmux attach -t claude

# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc

Agora você tem:

• tmux mantendo a sessão viva.
• mosh mantendo a conexão SSH estável.
• Remote Control fornecendo uma interface móvel polida.
• Acesso total ao terminal quando você precisar.

Parte 7: Construindo Apps Enquanto Móvel

O Fluxo de Trabalho de Desenvolvimento Móvel

A combinação de Claude Code + acesso remoto muda fundamentalmente quando e onde você pode ser produtivo. Um fluxo de trabalho prático:

1. Comunidade matinal: Revise os resultados de CI da noite para o dia em seu celular, inicie tarefas de correção via Remote Control.
2. Intervalo de almoço: Verifique o progresso via notificações ntfy, aprove ou redirecione alterações.
3. Noite: Pegue seu laptop e a sessão tmux estará exatamente onde você a deixou.

Quando a Codificação Móvel Faz Sentido

Codificação móvel via Claude Code é mais adequada para:

• Iniciação de tarefas — descreva o que você quer construir e deixe o Claude Code trabalhar enquanto você está fora.
• Revisão de código — leia diffs e aprove alterações do seu celular.
• Triagem de bugs — investigue problemas e aponte correções para o Claude Code.
• Monitoramento de progresso — verifique tarefas de longa duração.

É menos adequada para:

• Depuração complexa — telas pequenas tornam a leitura de stack traces penosa.
• Trabalho visual — ajustes de CSS e layout precisam de uma tela cheia.
• Refatoração em larga escala — você vai querer revisar alterações extensas em um monitor adequado.

Construindo com ZBuild de Qualquer Lugar

Para desenvolvedores que desejam construir e iterar em aplicações enquanto móveis, plataformas como ZBuild complementam o fluxo de trabalho remoto do Claude Code. O ZBuild fornece um construtor de apps visual que funciona bem em tablets e pode ser emparelhado com o Claude Code para lógica de backend mais complexa — oferecendo uma capacidade de desenvolvimento full-stack que não requer uma estação de trabalho desktop.

Parte 8: Solução de Problemas

Problemas Comuns e Soluções

Problema: "Remote Control não disponível em seu plano" Solução: Verifique se você está no Pro, Max, Team ou Enterprise. O nível gratuito não suporta o Remote Control.

Problema: QR code não escaneia Solução: Certifique-se de que seu app Claude esteja atualizado para a versão mais recente. Tente a URL da sessão diretamente em vez de escanear.

Problema: Conexão mosh cai e não reconecta Solução: Verifique se o mosh-server está rodando em seu desktop (which mosh-server). Verifique se o Tailscale está conectado em ambos os dispositivos. Certifique-se de que a porta UDP 60000-61000 está aberta se não estiver usando Tailscale.

Problema: Sessão tmux mostra tela em branco após reconectar Solução: Execute tmux attach -t claude em vez de criar uma nova sessão. Se a sessão morreu, verifique se o Claude Code travou revisando ~/.claude/logs/.

Problema: Notificações ntfy não chegam Solução: Verifique se o servidor ntfy está rodando (curl http://100.64.x.x:8090/health). Verifique se a URL de assinatura do app ntfy corresponde ao endereço do seu servidor. Certifique-se de que a conexão Tailscale do seu celular está ativa.

Problema: Sessão do Claude Code expirou enquanto o celular estava desconectado Solução: Isso acontece com o Remote Control após inatividade prolongada. Use a configuração baseada em tmux para sessões que precisam persistir por horas. Sessões tmux sobrevivem indefinidamente, independentemente das conexões do cliente.

Problema: Digitação lenta no celular Solução: Use entrada de voz (Happy Coder) ou mantenha as mensagens curtas e orientadas a tarefas. Alternativamente, prepare prompts em um app de notas e cole-os no terminal.

Parte 9: Considerações de Segurança

Segurança do Remote Control

• Todo o tráfego é criptografado via TLS através da Anthropic API.
• URLs de sessão são únicas e expiram após o uso.
• Nenhuma porta de entrada é aberta em sua máquina.
• Suas credenciais e arquivos nunca saem da sua máquina (apenas a saída de texto do Claude Code é transmitida).

Melhores Práticas de Segurança SSH

Ao expor o SSH para acesso móvel:

# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes

# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x

# Use a non-standard port
Port 2222

Segurança do Tailscale

A rede mesh baseada em WireGuard do Tailscale fornece:

• Criptografia de ponta a ponta entre dispositivos.
• Sem roteamento de dados pelos servidores do Tailscale (conexões diretas).
• MagicDNS para fácil resolução de hostname.
• Listas de controle de acesso (ACLs) para configurações de equipe.

Conclusão

Usar o Claude Code remotamente em 2026 varia do extremamente simples (um comando /rc) ao totalmente personalizado (SSH + tmux + mosh + ntfy + Tailscale). A configuração correta depende do seu fluxo de trabalho:

• Remote Control para check-ins móveis rápidos com configuração zero.
• Pilha SSH para desenvolvedores que vivem no terminal e precisam de resiliência máxima.
• Happy Coder para um meio-termo gratuito e rico em recursos.

O impacto prático é significativo. O desenvolvimento não está mais atrelado a sentar em uma mesa com um laptop aberto. Você pode iniciar uma tarefa, sair e manter o controle. Esteja você construindo um projeto pessoal, gerenciando a base de código de uma equipe ou prototipando um app com ZBuild, o acesso móvel ao Claude Code significa que seu fluxo de trabalho de desenvolvimento segue você, e não o contrário.

Fontes

• Documentação do Claude Code Remote Control — Anthropic
• Remote Claude Code: Programando como no início dos anos 2000 — Harper Reed
• Claude Code da Praia: mosh, tmux e ntfy — Rogs
• Claude Code Remote Control: Programe do Seu Celular — Medium
• Claude Code no Celular — Builder.io
• Notificações Perfeitas do Claude Code com Tailscale e ntfy — Felipe Elias
• 3 Maneiras de Rodar o Claude Code do Seu Celular — Zilliz
• Como Rodar o Claude Code do Seu iPhone — Pete Sena / Medium
• Análise de Lançamento do Claude Code Remote Control — Blockchain News
• Remote Control em VM Linux Headless — GitHub Issue #29479
• Configuração Móvel do Claude Code com tmux e Bitvise — GitHub Gist
• Como Usar o Claude Code no Seu Celular — FelloAI
• Configuração Móvel do Claude Code — Sealos Blog