Claude Code Remote Control não funciona? Todos os erros e soluções (2026)
Quando o Claude Code Remote Control não funciona, quase sempre é por um destes três motivos. O login não é o certo. Uma configuração manda o Claude para um servidor que não é da Anthropic. Ou a sessão no seu Mac parou.
Procure abaixo a mensagem que aparece para você. Cada erro tem uma solução curta baseada na documentação oficial da Anthropic.
| Erro ou sintoma | Causa | Solução |
|---|---|---|
| "Remote Control requires a claude.ai subscription" | Sem login com claude.ai | claude auth login |
| "Remote Control requires claude.ai subscription auth" | Há uma chave de API ou token definido | Remover a variável |
| "Remote Control requires a full-scope login token" | Token do claude setup-token | claude auth login |
| "Remote Control isn't enabled for this account" | Dados antigos do plano em cache | Sair e entrar de novo |
| "Couldn't verify Remote Control eligibility" | Offline ou bloqueado por um proxy | Tentar de novo e depois claude doctor |
| "Remote Control is only available when using Claude via api.anthropic.com" | Bedrock, Google Cloud, Foundry ou ANTHROPIC_BASE_URL | Remover a variável |
| "Remote Control is disabled by your organization's policy" | Desativado no Team ou Enterprise | Ver /status e pedir a um Owner |
| "could not reach the Remote Control server for about 30 minutes" | Sem contato por muito tempo | Rodar /remote-control |
| Sessão não aparece no app | O Remote Control nunca foi iniciado | Rodar /rc |
| Sessão ficou offline | O processo claude parou | claude remote-control --continue |
| Sessão do app Desktop não aparece no celular | Bug conhecido, issue #92306 | Iniciar no Terminal |
| Sessão bifurcada não aparece | Bug conhecido, issue #94396 | Rodar /remote-control nela |
/remote-control não mostra nada | Relatado na issue #96591 | Usar claude remote-control |
| Sessão some após horas sem mensagens | Relatado na issue #98879 | Mandar mensagem ou /remote-control |
| "Couldn't reconnect to your Remote Control session" | App fechado, reaberto ou atualizado | Tentar de novo e depois nova sessão |
“Remote Control requires a claude.ai subscription”
Essa mensagem aparece quando o Claude Code não está logado com uma conta claude.ai. Pelo claude remote-control ela diz "You must be logged in to use Remote Control."
O Remote Control funciona nos planos Pro, Max, Team e Enterprise. Chaves de API não funcionam. Entre com a sua conta claude.ai:
claude auth login“Remote Control requires claude.ai subscription auth”
Você está logado, mas uma chave de API ou um token tem prioridade. A mensagem mostra qual, por exemplo "ANTHROPIC_API_KEY is set, so this session is using API-key auth".
Remova essa variável do seu perfil do shell e do bloco env das configurações do Claude. Depois inicie o Claude de novo:
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN
claude --remote-controlSe a mensagem citar apiKeyHelper, remova essa configuração.
“Remote Control requires a full-scope login token”
Você está usando um token de longa duração do claude setup-token ou do CLAUDE_CODE_OAUTH_TOKEN. Esses tokens só servem para pedidos ao modelo. Faça o login normal:
claude auth login“Remote Control isn't enabled for this account”
O Claude Code verificou sua conta e a resposta foi negativa. Isso costuma acontecer depois de trocar de plano, quando dados antigos ainda estão guardados. Versões antigas mostravam "Remote Control is not yet enabled for your account".
Saia, entre de novo e atualize o Claude Code. O claude doctor mostra qual verificação falhou:
claude auth logout
claude auth login
claude doctor“Couldn't verify Remote Control eligibility”
O Claude Code não conseguiu falar com o serviço que verifica sua conta. Você está offline ou um proxy está bloqueando o pedido. Tente de novo com uma conexão normal ou rode claude doctor para ver detalhes.
“Remote Control is only available when using Claude via api.anthropic.com”
É um dos erros mais comuns. O Remote Control precisa que o Claude Code fale direto com a API da Anthropic. Ele não funciona no Amazon Bedrock, no Google Cloud nem no Microsoft Foundry. Também falha quando ANTHROPIC_BASE_URL aponta para um proxy ou gateway de LLM, mesmo com login no claude.ai.
A mensagem mostra a causa, como CLAUDE_CODE_USE_BEDROCK ou uma ANTHROPIC_BASE_URL própria. Remova do shell e do bloco env das configurações. Depois reinicie a sessão:
env | grep -i -e ANTHROPIC -e CLAUDE_CODE_USE
unset ANTHROPIC_BASE_URL
claude --remote-control“Remote Control is disabled by your organization's policy”
Nos planos Team e Enterprise, o Remote Control começa desativado. Um Owner ativa nas configurações de admin do Claude Code. Se você paga Pro ou Max, o Claude Code pode ainda estar logado numa organização Team antiga.
Rode /status para ver seu plano e sua organização. Se aparecer a errada, rode claude auth logout e depois claude auth login. Se a mensagem citar disableRemoteControl, a equipe de TI desativou neste aparelho.
“could not reach the Remote Control server for about 30 minutes”
Sua sessão ficou muito tempo sem contato com os servidores da Anthropic. Rode isto dentro da sessão para reconectar:
/remote-controlA sessão não aparece no app do Claude
O Remote Control só começa quando você pede. Rode /rc na sua sessão ou inicie o Claude com claude --remote-control. No app do Claude, toque em Code para ver suas sessões. Os dois aparelhos precisam da mesma conta.
Para conectar toda sessão automaticamente, abra /config e ative Enable Remote Control for all sessions. No app de desktop, vá em Ajustes > Claude Code > Connect new sessions to Remote Control.
A sessão ficou offline
O Remote Control roda dentro do processo claude no seu Mac. Se você fechar o terminal ou sair do app, a sessão fica offline.
Se você usou o modo servidor, dá para recuperar em cerca de quatro horas:
claude remote-control --continuePara uma sessão iniciada com --remote-control ou /rc, rode claude --continue e depois /rc. Rode tarefas longas dentro do tmux para que fechar uma janela não as interrompa.
Para quando meu Mac entra em repouso
O trabalho pausa enquanto o Mac está em repouso. O Claude Code reconecta sozinho quando o Mac acorda.
Para manter o Mac acordado durante uma tarefa, inicie o Claude com caffeinate:
caffeinate -i claude --remote-controlA maioria dos MacBooks entra em repouso ao fechar a tampa, a não ser com um monitor externo e o carregador conectados.
A sessão não aparece no seu celular ou some
São bugs conhecidos, relatados no GitHub. Em outubro de 2026, a maioria ainda está aberta. Veja o que acontece em cada caso e o que você pode fazer agora.
Sessões do app Claude Desktop nunca aparecem
No macOS, sessões interativas do Code no app Desktop podem não se registrar no Remote Control, mesmo com a conexão automática ligada. Tarefas agendadas do mesmo app aparecem no celular normalmente. Isso foi relatado na issue #92306, que continua aberta.
Ainda não há correção oficial. Segundo o relato, a CLI instalada à parte não é afetada. Iniciar a sessão no Terminal com claude --remote-control pode resolver.
Uma sessão bifurcada nunca aparece
Uma sessão bifurcada de outra nunca é marcada para o Remote Control. Por isso ela não aparece na aba Code do celular. Veja a issue #94396, ainda aberta.
A solução do autor: ative na mão com /remote-control dentro dessa sessão. Mande uma mensagem antes. Se não mandar, aparece "Remote Control requires an active session. Send a message first."
/remote-control não mostra nada e a sessão nunca aparece
Algumas pessoas rodam /remote-control e não recebem link nem confirmação. Ao rodar de novo, aparece "Remote Control disconnected." Isso foi relatado na issue #96591 e fechado como não planejado.
Rode claude doctor para conferir seu login e sua rede. Depois tente o modo servidor com claude remote-control. Ele mostra uma URL da sessão e um QR code para abrir a sessão direto.
A sessão some após horas sem mensagens
Um relato no Android diz que uma sessão sumiu da lista Code depois de cerca de 8 horas sem mensagens. O computador continuava ligado. Ela voltou depois que o app Desktop foi usado de novo. Veja a issue #98879, ainda aberta.
Ainda não há correção. Mande uma mensagem do seu Mac para trazê-la de volta ou reconecte com /remote-control.
"Couldn't reconnect to your Remote Control session"
Quando o app Desktop fecha, reinicia ou se atualiza, as sessões param e o Remote Control não volta a ligar. Ao tentar ligar de novo, pode aparecer "Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume." Veja a issue #98504, ainda aberta.
Faça o que a mensagem diz. Tente mais uma vez e depois comece uma sessão nova. Uma sessão parada precisa rodar uma rodada no seu Mac antes de você poder ligar o Remote Control de novo.
Uma solução da comunidade nesse tópico: rode o claude dentro do tmux, fora do app Desktop. Assim reiniciar o app não para a sessão.
Quando você precisa de mais que a sessão do Claude
O Remote Control é ótimo para conversar com o Claude Code. Às vezes você também precisa do resto do Mac. O Macky abre o terminal e a tela do seu Mac no iPhone.
- Funciona com chave de API, Bedrock ou proxy. É o seu próprio shell, então sua configuração continua igual.
- Modos próprios para Claude Code e Codex, mais um terminal normal para git, Docker e o que mais precisar.
- Uma barra de teclas com Esc, Tab e Ctrl. Aprove com y e Enter.
- Suas chaves SSH ficam no Mac. Digite
ssh my-vpse pronto. - Com o Pro, use o MacBook com a tampa fechada e mantenha as sessões conectadas em segundo plano.
Instale o Macky no Mac e no iPhone, entre nos dois e conecte. É grátis com sessões de 5 minutos. O Pro custa US$ 29 uma única vez. Baixe na App Store.
Primeira vez com o Remote Control? Leia o guia do Claude Code Remote Control. Para comparar os dois, veja Macky vs Claude Code Remote Control.
Perguntas frequentes
Por que o Claude Code Remote Control não funciona?
Quase sempre é o login, uma chave de API ou ANTHROPIC_BASE_URL, ou o processo claude parado no Mac. A mensagem de erro mostra qual.
Como corrigir "Remote Control is only available when using Claude via api.anthropic.com"?
Remova ANTHROPIC_BASE_URL ou a variável de Bedrock, Google Cloud ou Foundry citada na mensagem. Depois reinicie o Claude Code logado com claude.ai.
O Remote Control funciona com chave de API?
Não. Você precisa de login no claude.ai com plano Pro, Max, Team ou Enterprise.
Por que minha sessão não aparece no app do Claude?
O Remote Control só começa com /rc ou claude --remote-control, a não ser que você ative a conexão automática no /config. Os dois aparelhos precisam da mesma conta.
O que acontece se o Mac entrar em repouso?
A sessão pausa. O Claude Code reconecta quando o Mac acorda.
Posso controlar o Claude Code pelo celular sem o Remote Control?
Sim. O Macky abre o terminal do seu Mac no iPhone, então o Claude Code funciona com qualquer login, inclusive chave de API.
Guias e comparativos relacionados
Experimente o Macky
Conecte-se ao terminal do seu Mac direto do iPhone.