Remote Control está disponível em todos os planos. Em Team e Enterprise, ele fica desativado por padrão até que um administrador ative o toggle Remote Control nas configurações de administrador do Claude Code.
- Usar seu ambiente local completo remotamente: seu sistema de arquivos, MCP servers, ferramentas e configuração do projeto permanecem disponíveis
- Trabalhar em ambas as superfícies ao mesmo tempo: a conversa permanece sincronizada em todos os dispositivos conectados, para que você possa enviar mensagens do seu terminal, navegador e telefone de forma intercambiável
- Sobreviver a interrupções: se seu laptop dormir ou sua rede cair, a sessão se reconecta automaticamente quando sua máquina voltar a ficar online
Remote Control requer Claude Code v2.1.51 ou posterior. Verifique sua versão com
claude --version.Requisitos
Antes de usar Remote Control, confirme que seu ambiente atende a estas condições:- Assinatura: disponível nos planos Pro, Max, Team e Enterprise. Chaves de API não são suportadas. Em Team e Enterprise, um administrador deve primeiro ativar o toggle Remote Control nas configurações de administrador do Claude Code.
- Autenticação: execute
claudee use/loginpara fazer login através de claude.ai se você ainda não fez isso. - Confiança do workspace: execute
claudeno diretório do seu projeto pelo menos uma vez para aceitar o diálogo de confiança do workspace.
Inicie uma sessão de Remote Control
Você pode iniciar uma sessão de Remote Control a partir da CLI ou da extensão VS Code. A CLI oferece três modos de invocação; VS Code usa o comando/remote-control.
- Modo servidor
- Sessão interativa
- De uma sessão existente
- VS Code
Navegue até o diretório do seu projeto e execute:O processo continua em execução no seu terminal em modo servidor, aguardando conexões remotas. Ele exibe uma URL de sessão que você pode usar para conectar de outro dispositivo, e você pode pressionar a barra de espaço para mostrar um código QR para acesso rápido do seu telefone. Enquanto uma sessão remota está ativa, o terminal mostra o status da conexão e a atividade da ferramenta.Sinalizadores disponíveis:
| Sinalizador | Descrição |
|---|---|
--name "My Project" | Define um título de sessão personalizado visível na lista de sessões em claude.ai/code. |
--remote-control-session-name-prefix <prefix> | Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. Defina CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para o mesmo efeito. |
--spawn <mode> | Como o servidor cria sessões. • same-dir (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.• worktree: cada sessão sob demanda obtém seu próprio git worktree. Requer um repositório git.• session: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Definido apenas na inicialização.Pressione w em tempo de execução para alternar entre same-dir e worktree. |
--capacity <N> | Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com --spawn=session. |
--verbose | Mostra logs detalhados de conexão e sessão. |
--sandbox / --no-sandbox | Ativa ou desativa sandboxing para isolamento de sistema de arquivos e rede. Desativado por padrão. |
Conectar de outro dispositivo
Depois que uma sessão de Remote Control está ativa, você tem algumas maneiras de conectar de outro dispositivo:- Abra a URL da sessão em qualquer navegador para ir diretamente para a sessão em claude.ai/code.
- Escaneie o código QR mostrado ao lado da URL da sessão para abri-lo diretamente no aplicativo Claude. Com
claude remote-control, pressione a barra de espaço para alternar a exibição do código QR. - Abra claude.ai/code ou o aplicativo Claude e encontre a sessão pelo nome na lista de sessões. As sessões de Remote Control mostram um ícone de computador com um ponto de status verde quando online.
- O nome que você passou para
--name,--remote-controlou/remote-control - O título que você definiu com
/rename - A última mensagem significativa no histórico de conversa existente
- Um nome gerado automaticamente como
myhost-graceful-unicorn, ondemyhosté o nome do host da sua máquina ou o prefixo que você definiu com--remote-control-session-name-prefix
/mobile dentro do Claude Code para exibir um código QR de download para iOS ou Android.
Ativar Remote Control para todas as sessões
Por padrão, Remote Control só é ativado quando você executa explicitamenteclaude remote-control, claude --remote-control ou /remote-control. Para ativá-lo automaticamente para cada sessão interativa, execute /config dentro do Claude Code e defina Enable Remote Control for all sessions como true. Defina-o de volta para false para desativar.
Com essa configuração ativada, cada processo interativo do Claude Code registra uma sessão remota. Se você executar várias instâncias, cada uma obtém seu próprio ambiente e sessão. Para executar várias sessões simultâneas a partir de um único processo, use o modo servidor em vez disso.
Conexão e segurança
Sua sessão local do Claude Code faz apenas solicitações HTTPS de saída e nunca abre portas de entrada na sua máquina. Quando você inicia Remote Control, ele se registra na API Anthropic e faz polling para trabalho. Quando você conecta de outro dispositivo, o servidor roteia mensagens entre o cliente web ou móvel e sua sessão local através de uma conexão de streaming. Todo o tráfego viaja através da API Anthropic sobre TLS, o mesmo transporte de segurança que qualquer sessão do Claude Code. A conexão usa múltiplas credenciais de curta duração, cada uma com escopo para um único propósito e expirando independentemente.Remote Control vs Claude Code na web
Remote Control e Claude Code na web usam a interface claude.ai/code. A diferença fundamental é onde a sessão é executada: Remote Control é executado na sua máquina, portanto seus MCP servers locais, ferramentas e configuração do projeto permanecem disponíveis. Claude Code na web é executado em infraestrutura em nuvem gerenciada pela Anthropic. Use Remote Control quando você está no meio do trabalho local e deseja continuar de outro dispositivo. Use Claude Code na web quando você deseja iniciar uma tarefa sem nenhuma configuração local, trabalhar em um repositório que você não tem clonado ou executar várias tarefas em paralelo.Notificações push móveis
Quando Remote Control está ativo, Claude pode enviar notificações push para seu telefone. Claude decide quando fazer push. Normalmente envia uma quando uma tarefa de longa duração termina ou quando precisa de uma decisão sua para continuar. Você também pode solicitar um push em seu prompt, por exemplonotify me when the tests finish. Além do toggle on/off abaixo, não há configuração por evento.
Notificações push móveis requerem Claude Code v2.1.110 ou posterior.
Faça login com sua conta do Claude Code
Use a mesma conta e organização que você usa para Claude Code no terminal.
- Se
/configmostrar No mobile registered, abra o aplicativo Claude no seu telefone para que ele possa atualizar seu token de push. O aviso desaparece na próxima vez que Remote Control se conectar. - No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.
- No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.
Limitações
- Uma sessão remota por processo interativo: fora do modo servidor, cada instância do Claude Code suporta uma sessão remota por vez. Use o modo servidor para executar várias sessões simultâneas a partir de um único processo.
- O processo local deve continuar em execução: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo
claude, a sessão termina. - Interrupção de rede estendida: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute
claude remote-controlnovamente para iniciar uma nova sessão. - Ultraplan desconecta Remote Control: iniciar uma sessão ultraplan desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.
Solução de problemas
”Remote Control requires a claude.ai subscription”
Você não está autenticado com uma conta claude.ai. Executeclaude auth login e escolha a opção claude.ai. Se ANTHROPIC_API_KEY estiver definida em seu ambiente, desative-a primeiro.
”Remote Control requires a full-scope login token”
Você está autenticado com um token de longa duração declaude setup-token ou da variável de ambiente CLAUDE_CODE_OAUTH_TOKEN. Esses tokens são limitados apenas a inferência e não podem estabelecer sessões de Remote Control. Execute claude auth login para autenticar com um token de sessão de escopo completo em vez disso.
”Unable to determine your organization for Remote Control eligibility”
Suas informações de conta em cache estão desatualizadas ou incompletas. Executeclaude auth login para atualizá-las.
”Remote Control is not yet enabled for your account”
A verificação de elegibilidade pode falhar com certas variáveis de ambiente presentes:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICouDISABLE_TELEMETRY: desative-as e tente novamente.CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEXouCLAUDE_CODE_USE_FOUNDRY: Remote Control requer autenticação claude.ai e não funciona com provedores de terceiros.
/logout e depois /login para atualizar.
”Remote Control is disabled by your organization’s policy”
Este erro tem três causas distintas. Execute/status primeiro para ver qual método de login e assinatura você está usando.
- Você está autenticado com uma chave de API ou conta Console: Remote Control requer OAuth claude.ai. Execute
/logine escolha a opção claude.ai. SeANTHROPIC_API_KEYestiver definida em seu ambiente, desative-a. - Seu administrador de Team ou Enterprise não ativou: Remote Control fica desativado por padrão nesses planos. Um administrador pode ativá-lo em claude.ai/admin-settings/claude-code ativando o toggle Remote Control. Esta é uma configuração de organização no lado do servidor, não uma chave de configurações gerenciadas.
- O toggle do administrador está acinzentado: sua organização tem uma configuração de retenção de dados ou conformidade que é incompatível com Remote Control. Isso não pode ser alterado no painel de administração. Entre em contato com o suporte da Anthropic para discutir opções.
”Remote credentials fetch failed”
Claude Code não conseguiu obter uma credencial de curta duração da API Anthropic para estabelecer a conexão. Execute novamente com--verbose para ver o erro completo:
- Não conectado: execute
claudee use/loginpara autenticar com sua conta claude.ai. A autenticação por chave de API não é suportada para Remote Control. - Problema de rede ou proxy: um firewall ou proxy pode estar bloqueando a solicitação HTTPS de saída. Remote Control requer acesso à API Anthropic na porta 443.
- Falha na criação de sessão: se você também vir
Session creation failed — see debug log, a falha aconteceu anteriormente na configuração. Verifique se sua assinatura está ativa.
Escolha a abordagem correta
Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.| Trigger | Claude runs on | Setup | Best for | |
|---|---|---|---|---|
| Dispatch | Message a task from the Claude mobile app | Your machine (Desktop) | Pair the mobile app with Desktop | Delegating work while you’re away, minimal setup |
| Remote Control | Drive a running session from claude.ai/code or the Claude mobile app | Your machine (CLI or VS Code) | Run claude remote-control | Steering in-progress work from another device |
| Channels | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | Install a channel plugin or build your own | Reacting to external events like CI failures or chat messages |
| Slack | Mention @Claude in a team channel | Anthropic cloud | Install the Slack app with Claude Code on the web enabled | PRs and reviews from team chat |
| Scheduled tasks | Set a schedule | CLI, Desktop, or cloud | Pick a frequency | Recurring automation like daily reviews |
Recursos relacionados
- Claude Code na web: execute sessões em ambientes em nuvem gerenciados pela Anthropic em vez de na sua máquina
- Ultraplan: inicie uma sessão de planejamento em nuvem a partir do seu terminal e revise o plano no seu navegador
- Channels: encaminhe Telegram, Discord ou iMessage para uma sessão para que Claude reaja a mensagens enquanto você está ausente
- Dispatch: envie uma mensagem com uma tarefa do seu telefone e ela pode gerar uma sessão Desktop para lidar com isso
- Autenticação: configure
/logine gerencie credenciais para claude.ai - Referência de CLI: lista completa de flags e comandos incluindo
claude remote-control - Segurança: como as sessões de Remote Control se encaixam no modelo de segurança do Claude Code
- Uso de dados: quais dados fluem através da API Anthropic durante sessões locais e remotas