Conecte o celular ao Claude Code: visualize sessões e aprove ferramentas no iOS a qualquer momento

Como desenvolvedor, você certamente já passou por esta situação: você está usando o Claude Code para refatorar código ou depurar um problema e, de repente, precisa se afastar do computador — reunião, deslocamento ou apenas para pegar um café. Nesse momento, o Claude Code pode estar gerando código, aguardando sua aprovação para chamadas de ferramentas ou exibindo uma pergunta que precisa da sua confirmação. As abordagens tradicionais — ou ficar olhando o celular enquanto faz SSH de volta para o computador, ou simplesmente pausar o trabalho — têm uma experiência ruim no primeiro caso: a saída do terminal ocupa a tela pequena e o fluxo de aprovação depende de digitar comandos manualmente. A melhor solução para conectar o celular ao Claude Code é usar o app PandaNpc para iOS e levar o fluxo de sessão da área de trabalho inteiro para a palma da sua mão: visualize, aprove e responda a qualquer momento.

Por que você precisa conectar o celular ao Claude Code

O modo de interação do Claude Code é "geração em fluxo + confirmação de permissão". Chamadas típicas ferramentas (por exemplo, ler/escrever arquivos, executar comandos) exigem sua autorização, e o cartão de pergunta AskUserQuestion exige que você insira uma resposta para continuar. Se você não estiver na frente do computador, o Claude Code ou trava ou é forçado a desistir após o tempo limite. Pior ainda: você não consegue saber em que etapa ele está — está gerando ou já está esperando por você há muito tempo?

O app PandaNpc para iOS (lançado em junho de 2026) resolve completamente esse problema. Por meio do componente pandapaw (cc-bridge / cc-tty), ele "expõe" a sessão do Claude Code na máquina de desenvolvimento para o celular — basta escanear o código QR para parear; depois, você vê no celular o fluxo de sessão completo, incluindo os cartões de aprovação de permissão de cada chamada de ferramenta e cada cartão de pergunta. Isso significa que você pode, como se estivesse sentado diante do computador, deslizar o dedo no celular para aprovar ou recusar operações a qualquer momento, ou até digitar uma resposta direto para o Claude Code continuar.

Três passos para controlar o Claude Code remotamente pelo celular

Passo 1: Implante o serviço de ponte pandapaw na máquina de desenvolvimento

A PandaNpc não substitui diretamente o modo de execução do Claude Code; em vez disso, ela usa a camada de ponte leve pandapaw para encaminhar a saída padrão do terminal para o celular em tempo real. De acordo com sua preferência, você pode escolher entre dois modos:

cc-bridge (modo padrão): executa em modo headless com claude -p (stream-json), usa créditos da Claude API / SDK, adequado para automação em segundo plano e tarefas de longa duração.
cc-tty (recomendado): assume o terminal do Claude Code no modo REPL, usa a cota da sua assinatura Max, sem consumir créditos adicionais da API, ideal para uso interativo diário de alta frequência.

A instalação também é muito simples: execute um único comando na máquina de desenvolvimento macOS, Windows ou Linux (consulte a documentação em pandanpc.com). O pandapaw gera um token de pareamento exclusivo e um código QR. Todo o processo dispensa configuração manual de firewall ou encaminhamento de porta — o pandapaw se conecta por um túnel WebSocket seguro; seu celular só precisa ter acesso à internet.

Passo 2: Use o app iOS para escanear o código e concluir o pareamento

Abra o app PandaNpc para iOS, que estará disponível em breve; a tela principal exibirá um ícone de câmera. Toque nele e escaneie o código QR exibido no terminal da máquina de desenvolvimento; o celular analisará automaticamente as informações de pareamento e estabelecerá uma conexão segura. Não é preciso digitar token, IP ou chave manualmente; o código QR de pareamento é válido por pouco tempo e, se expirar, basta gerar um novo.

Após o pareamento, o app puxa imediatamente o estado completo da sessão atual do Claude Code: se você já estiver executando uma tarefa, o celular mostrará o histórico recente da conversa e os cartões que aguardam autorização.

Passo 3: Visualize a sessão, aprove ferramentas e responda perguntas no celular

Esta é a experiência mais essencial de conectar o celular ao Claude Code. A visualização de sessão do app distingue claramente três tipos de informação:

Saída normal: códigos, explicações ou logs gerados pelo Claude, exibidos em fluxo cronológico, com rolagem para revisar.
Cartão de permissão: quando o Claude Code precisar executar uma ferramenta (como Read, Bash, Edit), um cartão com botões "Aprovar/Recusar/Modificar parâmetros" aparecerá na tela do celular. Basta tocar para autorizar, sem precisar digitar nenhum comando.
Cartão de pergunta: quando o Claude fizer uma pergunta (por exemplo, "Confirme a string de conexão do banco de dados"), o cartão exibirá a pergunta completa e um campo de entrada. Você digita no teclado do celular e envia; o Claude Code recebe a resposta imediatamente e continua a execução.

Melhor ainda: mesmo com a tela bloqueada, Live Activity mostra o estado atual em tempo real: "Gerando", "Aguardando permissão" ou "Concluído". Você vê rapidamente na tela de bloqueio se o Claude Code está esperando por você, sem precisar desbloquear o celular e ficar atualizando.

Observações e perguntas frequentes

🔒 Segurança e rede

A conexão pandapaw usa um canal criptografado por padrão, mas é recomendável usá-la apenas em redes confiáveis (como Wi-Fi doméstico ou VPN da empresa). Em Wi-Fi público, você pode reforçar a segurança usando os nós relay oficiais da PandaNpc (opcional).
O código QR de pareamento é válido por 2 minutos por padrão; se expirar, basta gerar um novo, evitando que terceiros o capturem.

💡 Modo cc-tty vs cc-bridge

cc-tty é ideal para usuários que usam com frequência e já assinaram o Max: não consome créditos da API e todas as interações usam a cota Max do Claude Code, com latência menor.
cc-bridge é adequado para cenários que exigem controle refinado da API (como medir o uso), mas consome chamadas de API. Recomendamos que a maioria dos desenvolvedores use cc-tty diretamente.
A propósito: uma assinatura Max também permite compartilhar a assinatura do Claude com amigos ou colegas com segurança — sem compartilhar senha ou conta, e você pode revogar o acesso a qualquer momento.

❓ Solução de problemas comuns

Não consigo conectar após escanear? Verifique se a máquina de desenvolvimento está executando o pandapaw e se o celular e a máquina têm acesso à internet pública (ou estão na mesma rede local).
Sessão não sincronizada? No app, puxe para atualizar e forçar a sincronização do estado; se o processo do Claude Code for reiniciado, você precisará escanear novamente para parear.
O botão de aprovação não responde? Verifique se a rede do iOS está normal e se o app tem permissão de atividade em segundo plano (permita a atualização em segundo plano nas configurações).

Resumo

Conectar o celular ao Claude Code não é mais um "plano de emergência", mas parte do fluxo de desenvolvimento diário. O app PandaNpc para iOS, com a ponte pandapaw e a sincronização de sessão em tempo real, permite que você continue o trabalho de codificação perfeitamente em qualquer cenário: aprovar uma gravação de arquivo enquanto espera o metrô, responder a uma pergunta durante uma reunião ou até revisar os resultados da geração de código deitado na cama. Todas as operações são baseadas na sessão real do Claude Code; nenhum estado é falsificado e a lógica de execução não é alterada.

Quando sua tarefa de desenvolvimento exigir que você se afaste do computador, abra o PandaNpc, escaneie o código e o controle do Claude Code estará no seu bolso.