Controle o Claude Code pelo celular de graça: use seu iPhone ou Android com o Pinky

Resposta rápida: o controle do telefone pelo Claude Code é gratuito com o Pinky, um aplicativo desktop de código aberto (Apache-2.0, sem conta) que expõe um iPhone ou celular Android real ao Claude Code como um servidor MCP. Instale o Pinky, conecte o celular, ative a depuração USB (Android) ou o Modo Desenvolvedor (iPhone), adicione o Pinky ao Claude Code com um comando e peça para ele fazer algo no telefone. Toques arriscados esperam o seu clique.

As ferramentas custam $0. O Claude Code em si, não: em claude.com/pricing (verificado em 09/11/2026), o Claude Code aparece como “Não” no plano Free e está incluído em todos os planos pagos, com o Pro a $17 por mês cobrado anualmente ou $20 mensalmente. Se você já paga pelo Claude, dar acesso ao seu telefone não adiciona custo nenhum. Se não paga, nosso guia sobre como usar o Claude Code gratuitamente cobre as alternativas existentes.

A seguir: o Pinky de ponta a ponta e, depois, uma comparação com o Poki, uma alternativa exclusiva para iPhone.

O que significa deixar o Claude Code controlar seu telefone

Deixar o Claude Code controlar seu telefone significa conectar um servidor MCP que transforma ações do celular em ferramentas que o agente pode chamar: ler a tela, tocar, digitar, deslizar, abrir um aplicativo. O agente planeja cada etapa, o servidor a executa no dispositivo real via USB ou Wi-Fi, e você acompanha tudo em uma janela espelhada no computador.

Isso é o inverso de enviar prompts do seu telefone para uma sessão no laptop, o que abordamos em 3 maneiras de usar o Claude Code no celular.

Dois projetos tornaram isso prático no início de novembro de 2026:

• Pinky, de DIYgod: iPhone e Android, aplicativo desktop para macOS, Windows e Linux, 1.183 estrelas no GitHub em 09/11/2026.
• Poki, de Joseph Zhou: apenas iPhone, um servidor MCP local mais seu próprio agente, 636 estrelas no mesmo dia.

Ambos falam o Model Context Protocol, então qualquer cliente MCP pode usá-los.

O que você precisa antes de começar

Requisitos do Pinky, conforme seu README em 09/11/2026:

No iOS 27 e posteriores, nada é instalado no telefone: o Pinky monta a imagem de disco de desenvolvedor da Apple, que vem com o Xcode (download gratuito). No iOS 17.4 a 26, um auxiliar assinado com um Apple ID gratuito expira a cada 7 dias, e o Pinky avisa dois dias antes.

O Pinky se descreve como pré-alfa. Seu README diz que o Claude Code já usou um celular Android via USB e um iPhone no iOS 27 de ponta a ponta; iPhones abaixo do iOS 27 ainda não foram testados em hardware real.

Como configurar o Pinky com o Claude Code, passo a passo

Passo 1: Instale o Pinky

Baixe a versão para o seu sistema na última release (v2026.1109.13 em 09/11/2026). No Mac, pinky-<version>-arm64.dmg é para Apple silicon e amd64.dmg para Intel. Usuários de Homebrew podem executar:

brew install --cask diygod/tap/pinky

No Windows, execute pinky-setup-<version>-amd64.exe. Ele ainda não é assinado, então o SmartScreen pode exibir um aviso: escolha Mais informações e depois Executar assim mesmo. No Debian ou Ubuntu, instale o .deb com apt. O download tem 16 a 22 MB.

Passo 2: Conecte um celular Android

1. Abra Configurações › Sobre o telefone e toque em Número da versão 7 vezes para desbloquear as Opções do desenvolvedor.
2. Ative a Depuração USB em Configurações › Sistema › Opções do desenvolvedor.
3. Conecte o celular e toque em Permitir quando ele perguntar sobre a depuração USB.
4. No Pinky, escolha Add phone › Android e aceite o Pinky Companion, que lê a tela em cerca de 70 ms em vez de 2 s.

O Pinky inclui seu próprio adb, então você não precisa do Android Studio. No Android 11 e posteriores, você pode parear via Wi-Fi em vez de usar o cabo.

Passo 3: Ou conecte um iPhone

1. Conecte o iPhone, desbloqueie-o, toque em Confiar e digite o código de acesso.
2. Ative o Modo Desenvolvedor em Ajustes › Privacidade e Segurança. O telefone reinicia; toque em Ativar.
3. No Mac, instale o Xcode uma vez e abra-o, para que o Pinky possa usar sua imagem de disco de desenvolvedor. O Pinky então exibirá o telefone como pronto.
4. No iOS 17.4 a 26, instale o auxiliar WebDriverAgent pelo Xcode. Sem ele, o Pinky pode mostrar e ler a tela, mas não consegue tocar, deslizar ou digitar.

Passo 4: Adicione o Pinky ao Claude Code

Clique em Settings › Agents › Connect ao lado do Claude Code, e o Pinky se registra e instala seu guia de agente como uma skill. Manualmente, é uma linha:

claude mcp add --scope user pinky -- pinkyctl mcp

O comando é pinkyctl porque muitos sistemas já têm um programa chamado pinky. A documentação de MCP do Claude Code explica os escopos.

Passo 5: Dê uma tarefa ao Claude Code

Inicie o Claude Code e peça em linguagem natural:

Open Messages on my phone and tell Sam I'm running late.

Na primeira vez, o Pinky pergunta se deseja permitir o novo agente e o que ele pode fazer. O Claude Code então chama ferramentas como phone_connect, phone_observe, phone_tap e phone_type. Quando uma etapa precisa de você, a chamada retorna approval_pending e nada acontece até que você clique em Allow. Ausência de resposta em 60 segundos conta como recusa.

Sem um celular à mão? Reinicie o Pinky com --fake para dois celulares de demonstração com roteiro.

Como o Pinky mantém o agente sob controle

As regras de segurança ficam no gateway do Pinky, entre o agente e o telefone, e não no prompt, para que o texto na tela não consiga convencer o agente a se autoaprovar. Ativos por padrão:

• Pagamentos, negociações e transferências esperam o seu clique. Settings › Safety pode adicionar envios, exclusões, instalações ou todas as etapas.
• Aplicativos de banco, carteira e gerenciador de senhas ficam invisíveis, e os agentes não podem digitar em campos de senha ou códigos de uso único.
• Você pode assumir o controle a qualquer momento. Clique no espelhamento e o agente pausa.
• Cada execução é registrada com etapas, capturas de tela e uma gravação da tela, mantidas no seu computador.

Uma ressalva do próprio FAQ do Pinky: um agente que pode executar comandos shell poderia alcançar um celular Android via adb e burlar o gateway. Se isso preocupa você, isole o agente em um sandbox e conecte-o ao Pinky via HTTP.

Pinky vs Poki: qual opção gratuita se encaixa melhor

Escolha o Pinky se você tem um celular Android, trabalha no Windows ou Linux, ou quer aprovações que não dependem do agente.

Escolha o Poki se você está em um Mac com Xcode e quer um agente para iPhone com o qual possa conversar pelo Telegram ou iMessage. Seu início rápido é orientado pelo agente: você pede ao Claude Code para instalar o Poki a partir do repositório dele, e ele para quando o iOS precisar de você. A via do aplicativo também exige um app de VPN ou proxy no iPhone, como Karing ou Shadowrocket, que roteie 10.7.0.1 de volta para o Mac [VERIFICAR: se esse app é gratuito na App Store na sua região].

O README do Poki diz que iPhones físicos foram verificados até agora apenas na orientação retrato. Ambos os projetos têm poucos dias de vida, então espere mudanças incompatíveis. Para emuladores e dispositivos de teste, consulte nosso guia do servidor MCP Mobile Next.

Deixe o Claude Code verificar as APIs por trás de cada tela com o Apidog CLI

Cada tela pela qual seu agente navega chama um backend: um login, um carrinho, um pedido. Quando uma tela mostra a coisa errada, você precisa saber se o problema foi na UI ou na API. Seu agente pode responder isso com o Apidog CLI enquanto o Pinky cuida do telefone.

Configure uma vez:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Depois dê ao Claude Code um único prompt:

Import ./openapi.json into Apidog project <projectId>. Create a test case for
POST /auth/login, GET /cart and POST /orders that checks status codes and the
fields each screen shows. Then use Pinky to log in on my phone, add one item
and place a test order. After each screen, run the matching Apidog test case
against the staging environment and tell me whether the app or the API failed.

O agente importa a especificação, valida os payloads e cria os casos antes de tocar no telefone:

apidog import --project <projectId> --format openapi --file ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file login-case.json
apidog test-case create --project <projectId> --file login-case.json
apidog test-case list --project <projectId>

Após cada etapa no telefone, ele executa o caso daquela tela e lê o resultado:

apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Adicione --upload-report para ver a execução no app do Apidog. O mesmo comando com -r junit entra no CI; nosso guia de CI/CD do Apidog CLI mostra o pipeline. Para o lado do agente, veja Apidog CLI no Claude Code. O plano Free do Apidog cobre até 4 usuários.

Solução de problemas comuns de configuração

• Telefone não aparece na lista: abra o Checkup dele no menu ··· do Pinky, que indica qual opção está faltando.
• O pareamento por Wi-Fi nunca termina: redes de convidados e corporativas frequentemente isolam os dispositivos. Pareie com um código ou use o cabo.
• Os toques no iPhone não fazem nada no iOS 26 ou inferior: o auxiliar WebDriverAgent está ausente ou sua assinatura de 7 dias expirou. Reinstale-o pelo Xcode.

FAQ

É realmente gratuito deixar o Claude Code controlar meu telefone? O Pinky e o Poki são gratuitos e de código aberto, e uma conta Apple gratuita funciona. O Claude Code exige um plano pago do Claude, a partir de $17 por mês cobrado anualmente.

Preciso fazer jailbreak ou root no meu telefone? Não. O Pinky usa a depuração USB do Android e o Modo Desenvolvedor da Apple com a imagem de disco de desenvolvedor. O Poki também diz que não é necessário jailbreak.

O Pinky funciona com Codex ou Cursor também? Sim. Settings › Agents conecta Claude Code, Codex, Cursor, Gemini CLI e outros, e qualquer cliente MCP pode executar pinkyctl mcp.

A tela do meu telefone vai para a nuvem? Não através do Pinky: as gravações ficam no seu computador. O que o agente lê vai para o seu provedor de modelo, como com qualquer ferramenta.

O agente pode gastar meu dinheiro? Com o Pinky, pagamentos esperam o seu clique e os aplicativos de banco ficam ocultos. O README do Poki avisa que ele fará pagamentos se você pedir, então mantenha as tarefas restritas.