20 de março de 20267 min de leitura

Como executar e acompanhar o Claude Code pelo iPhone

O Claude Code é um agente de inteligência artificial para terminal criado pela Anthropic. Você o executa na linha de comando, indica seu projeto e atribui uma tarefa. Ele lê arquivos, programa, roda testes e corrige problemas de forma autônoma. Não se trata de uma janela de bate-papo tradicional, mas de um agente que atua diretamente nos arquivos do seu projeto.

O detalhe é que tarefas de desenvolvimento levam tempo. Um refatoramento completo ou a depuração de um bug complexo podem consumir de 15 a 30 minutos. Durante esse processo, o Claude Code frequentemente faz pausas para pedir confirmação de alterações, encontra erros que demandam orientação ou conclui uma etapa e fica aguardando novas instruções.

Se você estiver sentado em frente ao Mac, ótimo. Mas ninguém quer ficar preso à cadeira esperando a conclusão de cada etapa.

O risco de deixar o processo rodando às cegas

Você pode disparar um comando no terminal e se afastar, mas sem visibilidade você não sabe se a tarefa terminou, se está travada esperando aprovação ou se pegou um rumo equivocado desperdiçando recursos.

O tmux protege a sessão contra desconexões acidentais, mas ainda obriga você a voltar fisicamente até o computador para conferir a tela e digitar.

O que você realmente precisa é de um terminal interativo no iPhone, conectado em tempo real ao seu Mac, permitindo interagir de onde estiver.

Como o Macky resolve isso

O Macky é um aplicativo para Mac e iPhone que entrega uma sessão real de terminal do seu computador no smartphone. Sem notificações atrasadas nem resumos genéricos: é o terminal autêntico exibindo os dados em tempo real e aceitando comandos exatamente como no teclado físico.

A conexão utiliza WebRTC, ultrapassando roteadores e firewalls domésticos de forma automática sem necessidade de abrir portas ou configurar SSH. O setup completo leva menos de dois minutos.

Configurando o Claude Code no Mac

Passo 1: Instalar o Claude Code

Instale o pacote globalmente via npm:

npm install -g @anthropic-ai/claude-code

Configure sua chave de API da Anthropic no arquivo de configuração do seu shell:

export ANTHROPIC_API_KEY=your_key_here

Passo 2: Instalar o Macky

Baixe o Macky para Mac em macky.dev e instale o app do iOS pela App Store. Faça login com a mesma conta em ambos os dispositivos e defina sua Senha Mestra.

Passo 3: Iniciar a sessão

No Mac, vá até a pasta do projeto. Abra o Macky no iPhone e conecte. No terminal, digite:

claude

Dicas práticas para usar no iPhone

Aprovação de alterações de código

Quando o Claude Code mostrar um diff de código solicitando permissão, basta digitar y para aprovar ou n para recusar.

Se a tarefa estiver bem delimitada e você quiser pular as confirmações manuais:

claude --dangerously-skip-permissions "refactor the auth module to use JWT"

Monitoramento e interrupção

O Macky inclui uma tecla Ctrl na barra de ferramentas do teclado no iPhone. Você pode pressionar Ctrl+C a qualquer momento para interromper o fluxo e dar novas instruções.

Sessões persistentes com tmux

Para tarefas longas, execute o Claude Code dentro de uma sessão do tmux. Caso você perca o sinal de rede móvel temporariamente, o processo continua rodando no Mac:

tmux new-session -s claude
claude "your task here"

Para reconectar depois:

tmux attach -t claude

Cenários onde essa combinação se destaca

  • No deslocamento diário: Inicie a tarefa antes de sair de casa e acompanhe o progresso no transporte público.
  • No sofá: Continue desenvolvendo sem precisar abrir um laptop pesado no colo.
  • Pausa para um café: Afaste-se da mesa sem perder o controle dos builds e refatoramentos longos.
  • Execuções noturnas: Inicie uma refatoração antes de dormir e confira o relatório pela manhã no iPhone.

Recomendações importantes

Lembre-se de impedir que o Mac entre em repouso durante tarefas demoradas, ajustando os Ajustes do Sistema ou usando utilitários como o Amphetamine.

Experimente o Macky

Conecte-se ao terminal do seu Mac direto do iPhone. Gratuito e sem configurações complicadas.