10 de outubro de 20266 min de leitura

Claude Code Remote Control: configuração, limites e soluções (2026)

O Claude Code Remote Control permite continuar uma sessão do Claude Code pelo celular, tablet ou qualquer navegador. O Claude continua rodando no seu Mac, e você controla tudo pelo app do Claude ou pelo claude.ai/code.

É um dos melhores recursos que a Anthropic colocou no Claude Code. Veja como ativar, o que ele não faz e como resolver os erros mais comuns.

Como iniciar o Claude Code Remote Control

Existem três jeitos de ativar. Escolha o que combina com o seu jeito de trabalhar.

1. Modo servidor

claude remote-control

Rode na pasta do projeto. Ele espera conexões e mostra uma URL de sessão. Aperte a barra de espaço para ver um QR code. Use --spawn worktree para cada nova sessão ter seu próprio git worktree, e --capacity para limitar quantas sessões rodam ao mesmo tempo.

2. Uma sessão normal que você também controla de longe

claude --remote-control "My Project"

Você ganha uma sessão normal do Claude Code no terminal. Dá para digitar no Mac e no celular. A forma curta é --rc.

3. A partir de uma sessão já aberta

/remote-control

Digite /remote-control ou /rc no prompt do Claude Code. Também funciona no app Claude Desktop e na extensão do VS Code.

Quer que toda sessão conecte sozinha? Abra /config e ative o Remote Control para todas as sessões.

Conectar pelo iPhone ou Android

  • Escaneie o QR code para abrir a sessão no app do Claude.
  • Ou abra o app do Claude, toque em Code e escolha a sessão na lista.
  • Ou abra a URL da sessão em qualquer navegador.

Ainda não tem o app do Claude? Rode /mobile no Claude Code. Aparece um QR code que abre a loja certa para o seu celular.

Receba um aviso quando o Claude precisar de você

Abra /config e ative Push when actions required. Seu celular recebe uma notificação quando o Claude espera uma permissão ou faz uma pergunta. É essa configuração que deixa o Remote Control útil quando você sai de perto.

Requisitos

  • Um plano Claude Pro, Max, Team ou Enterprise.
  • Login pelo claude.ai com /login. Chaves de API não funcionam.
  • No Team e no Enterprise, um Owner precisa ativar o Remote Control antes nas configurações de admin do Claude Code.
  • O computador fica ligado e o processo claude continua rodando.

É seguro?

Seu Mac só faz requisições HTTPS de saída. Ele nunca abre uma porta de entrada. O código e os arquivos ficam na sua máquina, e o celular só manda mensagens para a sessão. No Pro e no Max você também pode ativar Trusted Devices, para que só aparelhos verificados controlem uma sessão.

O que o Claude Code Remote Control não faz

O Remote Control foi feito para uma coisa: sua conversa com o Claude Code. Para todo o resto, você precisa de um terminal. Veja a comparação com o Macky, que leva o seu Mac inteiro para o celular.

Claude Remote ControlMacky
Conversar com o Claude CodeSimSim, com um modo Claude Code
Rodar git, npm ou docker você mesmoSó pedindo ao ClaudeSim, zsh ou bash completo
Codex e outros agentesNãoSim, com um modo Codex
SSH nos seus servidoresNãoSim, com as chaves do seu Mac
Ver e controlar a tela do MacNãoSim
Com chave de API ou BedrockNãoSim, é o seu próprio terminal
PreçoIncluído no seu plano ClaudeGrátis, Pro US$ 29 uma vez

Mais um detalhe. Se o MacBook entrar em repouso, a sessão pausa. Ela reconecta quando o Mac acorda. Fechar a tampa costuma colocar o MacBook em repouso, então mantenha ele acordado com caffeinate durante tarefas longas.

Erros comuns e como resolver

"Remote Control requires a claude.ai subscription"

Você está deslogado, ou logado com uma conta sem plano compatível. Rode /login e entre com sua conta do claude.ai.

"ANTHROPIC_API_KEY is set, so this session is using API-key auth"

A chave de API tem prioridade sobre o login do claude.ai. Rode unset ANTHROPIC_API_KEY, tire ela do perfil do shell e abra o Claude Code de novo.

"Remote Control is only available when using Claude via api.anthropic.com"

Sua sessão passa pelo Amazon Bedrock, Google Cloud ou Microsoft Foundry, ou o ANTHROPIC_BASE_URL aponta para outro host. Remova essa variável. Se a empresa exige esse provedor, o Remote Control não vai funcionar.

"Remote Control isn't enabled for this account"

Isso costuma acontecer depois de mudar de plano. Rode claude auth logout e depois claude auth login.

"A sessão ficou offline"

O processo claude parou. Por cerca de quatro horas, claude remote-control --continue traz a sessão de volta.

Ainda com problema? Explicamos quedas de conexão e problemas de repouso em Claude Code Remote Control não funciona.

Quando você precisa de mais do que o Claude

Dá para usar o Remote Control e o Macky juntos. O Remote Control é ótimo para a conversa com o Claude. O Macky entrega o resto do seu Mac.

O Macky abre o terminal de verdade do seu Mac e a tela inteira no iPhone ou iPad. Claude Code e Codex têm cada um o seu modo. A barra de teclas tem Esc, Tab e Ctrl, além de teclas rápidas para y e Enter quando um agente pede aprovação.

Um terminal do Mac aberto no iPhone com o Macky
  • Seus servidores vêm junto. Digite ssh my-vps e pronto. Ele usa as chaves e a configuração que já estão no Mac. Nada é copiado para o celular.
  • Tampa fechada. Com o Pro, seu MacBook pode ficar fechado na mesa e você continua usando.
  • Conexão em segundo plano. Com o Pro, a sessão continua conectada mesmo com o celular bloqueado.
  • Seguro desde o início. Nenhuma porta para abrir. A conexão tem criptografia de ponta a ponta. Cada aparelho novo precisa ser aprovado no Mac, e uma senha mestra protege o terminal.

O Macky é grátis com sessões de 5 minutos. O Pro custa US$ 29 em pagamento único. Baixe na App Store.

Qual usar?

  • Só Claude Code, no Pro ou Max: O Remote Control é perfeito. Ative as notificações push.
  • Claude Code com chave de API ou Bedrock: O Remote Control não roda. Use o Macky para chegar ao terminal onde o Claude roda.
  • Claude mais git, Docker, Codex ou seus servidores: Macky, junto com o Remote Control se quiser.
  • Você precisa ver a tela do Mac: Macky.

Para ver lado a lado, leia Macky vs Claude Code Remote Control. Para todas as formas de usar o Claude Code no celular, veja Claude Code no iPhone.

Perguntas frequentes

O que é o Claude Code Remote Control?

Um recurso que deixa você continuar uma sessão do Claude Code do seu computador pelo app do Claude ou pelo claude.ai/code. O código continua rodando na sua máquina.

Como inicio o Claude Code Remote Control?

Rode claude remote-control no seu projeto, comece com claude --remote-control ou digite /rc numa sessão aberta.

O Claude Code Remote Control é grátis?

Ele vem incluído nos planos Claude Pro, Max, Team e Enterprise. Não funciona com chaves de API.

O Remote Control funciona com o Mac em repouso?

Não. A sessão pausa e reconecta quando o Mac acorda.

Posso usar o Remote Control com Bedrock ou chave de API?

Não. Ele precisa do login no claude.ai e da API da Anthropic. Mesmo assim, você pode controlar o Claude Code pelo celular com um terminal como o Macky.

Posso rodar outros comandos além do Claude?

Pelo Remote Control, não. Para git, Docker, Codex ou SSH, use um terminal completo como o Macky.

Experimente o Macky

Conecte-se ao terminal do seu Mac direto do iPhone.