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-controlRode 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-controlDigite /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
claudecontinua 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 Control | Macky | |
|---|---|---|
| Conversar com o Claude Code | Sim | Sim, com um modo Claude Code |
| Rodar git, npm ou docker você mesmo | Só pedindo ao Claude | Sim, zsh ou bash completo |
| Codex e outros agentes | Não | Sim, com um modo Codex |
| SSH nos seus servidores | Não | Sim, com as chaves do seu Mac |
| Ver e controlar a tela do Mac | Não | Sim |
| Com chave de API ou Bedrock | Não | Sim, é o seu próprio terminal |
| Preço | Incluído no seu plano Claude | Grá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.

- Seus servidores vêm junto. Digite
ssh my-vpse 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.
Guias e comparativos relacionados
Experimente o Macky
Conecte-se ao terminal do seu Mac direto do iPhone.