Wendov1.0 · iOS e Android
Português (Brasil)

Aprender

Como usar o Claude Code pelo celular

· 5 min de leitura

Você começa uma refatoração grande, vai tomar um café e o Claude Code para para perguntar se pode rodar as migrations. Você não está na mesa, então o agente fica ali parado. Este guia mostra como deixar o computador trabalhando e acompanhar tudo pelo celular: o que configurar e em que ordem.

Por que fazer isso

Um agente de código nem sempre trabalha em rajadas de dois minutos. Uma tarefa longa pode durar meia hora ou mais e, no caminho, o Claude Code pede permissão para rodar comandos, editar arquivos ou mexer em algo fora do projeto. Sem ninguém para responder, ele espera.

Com o celular no bolso você vê em que pé está, lê o que ele está pedindo e decide. Não precisa ficar grudado na mesa, nem aprovar tudo de antemão só por precaução.

O que você precisa

Três coisas no computador onde o Claude Code roda, mais um app no celular.

Um servidor SSH. O celular se conecta ao computador por SSH, do mesmo jeito que outro notebook faria.

  • No macOS: Ajustes do Sistema › Geral › Compartilhamento › Login Remoto.
  • No Linux (Debian ou Ubuntu):
sudo apt install openssh-server
sudo systemctl enable --now ssh

Um jeito de chegar até ele de fora da rede de casa. No mesmo Wi-Fi, o IP local basta. Longe de casa, uma VPN como o Tailscale é o caminho sensato: o celular e o computador se enxergam como se estivessem na mesma rede, e você não precisa expor a porta 22 à internet. Não faça isso, principalmente com login por senha.

Um multiplexador de terminal, como o tmux. Sem um, se o celular perde a conexão ou você fecha o app, a sessão do terminal morre junto. Com o tmux, o Claude Code continua rodando no computador e você só se reconecta à mesma sessão.

brew install tmux        # macOS
sudo apt install tmux    # Debian/Ubuntu

Passo a passo

  1. Ative o SSH no computador e confira que funciona a partir de outra máquina: ssh your-user@computer-ip.
  2. Instale a VPN nas duas pontas se quiser se conectar longe de casa, e anote o nome ou o IP que o computador tem nessa rede.
  3. Inicie o Claude Code dentro do tmux:
tmux new-session -A -s claude
claude

A opção -A significa que, se já existir uma sessão chamada claude, você entra nela em vez de criar uma segunda.

  1. Conecte-se pelo celular por SSH e entre nessa sessão do tmux. A partir daí você pode digitar para o Claude, ler o que ele está fazendo e responder.

Isso funciona. O que falta é comodidade: você precisa abrir o app a cada poucos minutos para ver se o Claude ainda está esperando por você. É para isso que serve a última peça.

Onde o Wendo entra

O Wendo é um cliente SSH para iOS e Android, feito pela Lirafy, criado para acompanhar agentes de código. Ainda não está nas lojas; chega em breve à App Store e ao Google Play.

O que ele acrescenta ao SSH puro são os avisos e as aprovações. No computador, você roda um comando:

curl -fsSL https://wendo.lirafy.dev/install.sh | sh

O script baixa o hook e o script de pareamento para ~/.wendo, instala jq e qrencode se faltarem, registra o hook em ~/.claude/settings.json (salvando antes uma cópia como settings.json.bak-wendo), avisa se nada estiver escutando SSH na porta 22 e imprime um QR code. Você pode rodar de novo sem que nada seja duplicado.

No celular, vá em Máquinas › Adicionar e escolha escanear o QR code. O Wendo fixa a impressão digital da chave do host do servidor desde esse primeiro momento, então você não aceita uma chave às cegas. Depois o app mostra um comando para rodar no computador que instala a chave do celular em authorized_keys.

A partir daí, tudo o que o Claude Code precisa de você aparece na Caixa de entrada: pedidos de permissão, perguntas e tarefas concluídas, de todas as suas máquinas em um só lugar. Cada pedido de permissão pode ser aprovado ou negado direto na linha. Se você não responder, nada estranho acontece: o hook espera 90 segundos e, depois disso, o Claude Code pergunta no terminal, como sempre. Os detalhes estão na página de avisos e aprovações.

Se você roda o Claude dentro do tmux, tocar em um aviso leva ao painel exato onde ele está rodando. A configuração está na página do tmux, e o que acontece quando a rede cai está em sessões que sobrevivem a quedas.

Mais duas coisas ajudam numa tela pequena: o visualizador de diff para revisar o que o Claude mudou e colar imagens na conversa. Se você está construindo algo para a web, há também a prévia web.

O plano grátis inclui 5 aprovações de teste pela Caixa de entrada; com o Pro não há limite.

Com o app fechado

A Caixa de entrada se atualiza sozinha enquanto o Wendo está aberto. Com o app fechado, os avisos chegam pelo ntfy, um serviço de notificações push que você pode hospedar por conta própria. Como configurar, e por que o tópico é na prática uma senha, está no artigo sobre notificações do Claude Code no celular.

E se eu preferir outro cliente

Qualquer cliente SSH cobre o básico: conectar, entrar no tmux, conversar com o Claude Code. O que você perde é todo o resto. Sem o hook não há Caixa de entrada, nem aprovar direto na linha, nem aviso quando a sessão precisa de você, então você tem que lembrar de ir olhar. Se isso for suficiente para você, os passos acima são tudo de que precisa.

Limites que vale conhecer

  • No Windows você precisa do WSL2: o app envia comandos de shell POSIX por SSH, e o tmux não existe no Windows. Rode o Claude Code dentro do WSL para que os hooks rodem lá.
  • Por enquanto o hook só é registrado para o Claude Code.
  • As perguntas e as aprovações de plano do Claude não bloqueiam: você as responde pela Visualização de chat, não por uma linha da Caixa de entrada.
  • A integração com tmux, zellij e herdr faz parte do Wendo Pro.