SpyBara
Go Premium

remote-control.md 2026-09-28 22:59 UTC to 2026-09-29 04:01 UTC

This page contains 152 additions and 160 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58 Mon 28 22:59 Tue 29 04:01

Continue sessões locais de qualquer dispositivo com Remote Control

Continue uma sessão local do Claude Code do seu telefone, tablet ou qualquer navegador usando Remote Control. Funciona com claude.ai/code e o aplicativo Claude para dispositivos móveis.

Remote Control conecta claude.ai/code ou o aplicativo Claude para iOS e Android a uma sessão do Claude Code em execução na sua máquina. Inicie uma tarefa na sua mesa, depois continue a partir do seu telefone no sofá ou de um navegador em outro computador.

Quando você inicia uma sessão de Remote Control na sua máquina, Claude continua executando localmente o tempo todo, portanto sua execução de código e acesso ao sistema de arquivos permanecem na sua máquina. Com Remote Control você pode:

  • Usar seu ambiente local completo remotamente: seu sistema de arquivos, MCP servers, ferramentas e configuração do projeto permanecem disponíveis, e digitar @ autocompleta caminhos de arquivo do seu projeto local.
  • Trabalhar em ambas as superfícies ao mesmo tempo: a conversa e o progresso de subagentes e fluxos de trabalho dinâmicos permanecem sincronizados em todos os dispositivos conectados, para que você possa enviar mensagens do seu terminal, navegador e telefone de forma intercambiável.
  • Enviar imagens e arquivos do seu telefone ou navegador: anexe uma foto ou arquivo no aplicativo Claude ou em claude.ai/code, com ou sem legenda. Claude vê fotos anexadas diretamente como parte da sua mensagem. Claude Code faz o download de outros arquivos para sua máquina e os passa para Claude como referências de arquivo @.
  • Sobreviver a interrupções: se seu laptop dormir ou sua rede cair, Claude Code se reconecta automaticamente quando sua máquina voltar a ficar online.

Diferentemente do Claude Code na web, que é executado em infraestrutura em nuvem, as sessões de Remote Control são executadas diretamente na sua máquina e interagem com seu sistema de arquivos local. As interfaces web e móvel são uma janela para essa sessão local, portanto seu computador precisa permanecer ligado e o processo claude precisa continuar em execução.

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 Owner deve primeiro ativar o toggle Remote Control nas configurações de administrador do Claude Code.
  • Autenticação: execute claude e use /login para fazer login através de claude.ai se você ainda não fez isso. Sem um login elegível, claude remote-control sai com um erro, enquanto claude --remote-control ainda inicia uma sessão interativa e mostra uma notificação de falha de Remote Control logo após o lançamento.
  • Endpoint de API: não disponível em nenhuma destas configurações:
    • Você usa Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.
    • Você aponta ANTHROPIC_BASE_URL para um host diferente de api.anthropic.com, como um gateway LLM ou proxy. Desative a variável para usar Remote Control.
    • Você faz login através de um gateway de aplicativos Claude empresarial.
  • Avaliação de feature-flag: se você definir uma variável de ambiente que desativa a avaliação de feature-flag, a disponibilidade de Remote Control depende de qual:
    • Se você definir CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_GROWTHBOOK, Remote Control não está disponível. Desative a variável onde quer que esteja definida, no seu ambiente de shell ou no bloco env de um arquivo settings.json, para usar Remote Control.
    • Se você definir apenas DISABLE_TELEMETRY ou DO_NOT_TRACK, Remote Control permanece disponível a menos que sua organização exija Trusted Devices. Se exigir, desative a variável para usar Remote Control. Usar Remote Control com qualquer uma dessas variáveis definidas requer Claude Code v2.1.283 ou posterior.
  • Confiança do workspace: em um diretório que você ainda não confiou, claude remote-control imprime o que confiar nele ativa e pergunta Trust <directory>? [y/N] antes de iniciar. Responder y salva a escolha, exceto no seu diretório home, onde a confiança nunca é salva e a pergunta retorna a cada execução. Quando sua entrada ou saída padrão não é um terminal, o comando não pode perguntar e sai com um erro Workspace not trusted.

Iniciar uma sessão de Remote Control

Você pode iniciar uma sessão de Remote Control a partir da CLI, do aplicativo Claude Desktop, ou da extensão VS Code. A CLI oferece três modos de invocação; o aplicativo Desktop e VS Code usam o comando /remote-control.

No diretório do seu projeto, execute:

claude remote-control

Até que você aceite a confirmação única do Remote Control, claude remote-control explica o que faz e pergunta Enable Remote Control? (y/n) antes de iniciar o servidor. Responda y para aceitar e iniciar o servidor. Se você recusar, Claude Code sai sem iniciar o servidor e pergunta novamente na próxima vez que você executar o comando.

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.
-c, --continue Recupere a sessão que o último servidor neste diretório iniciou, em vez de criar uma nova. Consulte Retomar sessões após parar o servidor. Não pode ser combinado com --session-id, --spawn, --capacity ou --create-session-in-dir. Requer Claude Code v2.1.200 ou posterior.
--session-id <id> Recupere uma sessão por seu ID. Consulte Retomar sessões após parar o servidor. Não pode ser combinado com --continue, --spawn, --capacity ou --create-session-in-dir. Requer Claude Code v2.1.200 ou posterior.
--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. Defina 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.
--[no-]create-session-in-dir Pré-crie uma sessão no diretório atual quando o servidor inicia, para que você tenha um lugar para digitar imediatamente. Em modo worktree, essa sessão permanece no diretório atual enquanto as sessões sob demanda obtêm worktrees isoladas. Ativado por padrão. Se você passar --no-create-session-in-dir para iniciar sem nenhuma, Claude Code arquiva as sessões do servidor quando você o para, portanto não há nada para retomar.
--permission-mode <mode> Define o modo de permissão inicial para as sessões do servidor, como acceptEdits. Aceita manual como um alias para default; um modo não reconhecido para o servidor na inicialização e lista os modos válidos.
-d, --debug[=<filter>] Ative o registro de depuração para o servidor, opcionalmente filtrado por categoria. Passe um filtro apenas na forma =, como --debug=api,hooks. Requer Claude Code v2.1.282 ou posterior; versões anteriores rejeitam o sinalizador como um argumento desconhecido.
--debug-file <path> Escreva logs de depuração no arquivo fornecido.
--verbose Mostre logs detalhados de conexão e sessão.
--sandbox / --no-sandbox Ative ou desative sandboxing para isolamento de sistema de arquivos e rede. Desativado por padrão.

Forneça esses sinalizadores após remote-control.

Se você passar um sinalizador global claude antes de remote-control, ou um script wrapper adicionar um, Claude Code não leva o sinalizador para as sessões que o servidor cria. Claude Code deixa o sinalizador passar apenas quando soltá-lo é conhecido por não alterar o que essas sessões podem fazer, como --verbose ou --model. Para qualquer outro sinalizador, como --settings, Claude Code recusa iniciar e nomeia o sinalizador a remover.

Claude Code verifica a elegibilidade do Remote Control antes de imprimir a ajuda, portanto claude remote-control --help retorna um erro em vez dessa lista de sinalizadores quando você não está conectado com uma conta elegível.

Verificar status da conexão

Em uma sessão interativa, enquanto Remote Control está conectado, o terminal mostra um indicador /rc active que vincula à sessão em claude.ai. O indicador fica oculto quando o terminal é muito estreito para ajustá-lo. Para ver a URL da sessão e um código QR para conectar de outro dispositivo, execute /remote-control novamente para abrir o painel de status. O painel também permite que você desconecte Remote Control enquanto sua sessão local continua em execução.

Se a conexão falhar em uma sessão interativa, o indicador muda para mostrar a falha, e Claude Code mostra o motivo em uma notificação e o adiciona à conversa. Execute /remote-control para reconectar, a menos que o motivo diga que a sessão mudou em outro lugar:

  • Another connection took over this session: outro dispositivo ou sessão de Claude Code a tem agora. Execute /remote-control apenas se você quiser recuperá-la.
  • This session was ended or archived from another device or app: execute /remote-control apenas se você quiser a sessão de volta. Claude Code reabre uma sessão arquivada.
  • The server no longer reports this session: ela pode ter sido excluída de outro dispositivo ou aplicativo.

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 à sessão em claude.ai/code.
  • Digitalize 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 por nome na lista de sessões. No aplicativo móvel Claude, toque em Code na navegação para acessar a lista de sessões. As sessões de Remote Control mostram um ícone de computador com um ponto de status verde quando online.

Quando você se conecta, o dispositivo mostra quaisquer subagentos e fluxos de trabalho que a sessão já tem em execução em segundo plano. Pare um deles do dispositivo, e Claude Code para essa tarefa na sua máquina.

O título da sessão remota é escolhido nesta ordem:

  1. O nome que você passou para --name, --remote-control ou /remote-control
  2. O título que você definiu com /rename
  3. A última mensagem significativa no histórico de conversa existente
  4. Um nome gerado automaticamente como myhost-graceful-unicorn, onde myhost é o nome do host da sua máquina ou o prefixo que você definiu com --remote-control-session-name-prefix

Se você não definiu um nome explícito, Claude Code atualiza o título para refletir seu prompt depois que você envia um. Quando você renomeia uma sessão a partir de claude.ai ou do aplicativo Claude, Claude Code também atualiza o título local mostrado em claude --resume.

Se você ainda não tem o aplicativo Claude, execute /mobile dentro de Claude Code para mostrar um código QR para claude.ai/mobile, que abre a loja de aplicativos correta para seu telefone.

O que os dispositivos conectados veem

Um dispositivo conectado mostra a conversa no seu terminal conforme acontece. Estes casos vão além de mensagens ordinárias:

  • Compactação e /clear: enquanto Claude Code compacta a conversa, os dispositivos conectados mostram o progresso e então onde a conversa foi compactada. Quando você executa /clear, a conversa é redefinida nos dispositivos conectados também.
  • Alternando conversas com /resume: o dispositivo conectado não recebe o título ou histórico anterior da conversa alternada, mas novas mensagens em ambas as direções vão para e vêm de qualquer conversa que esteja aberta no seu terminal. Para trabalhar na conversa original do dispositivo novamente, execute /resume no seu terminal e volte para ela.
  • Puxando uma sessão com /teleport: quando você puxa uma sessão na nuvem para seu terminal com /teleport, o dispositivo conectado não recebe o histórico anterior da conversa puxada. Novas mensagens em ambas as direções vão para e vêm da conversa puxada, que agora é a que está aberta no seu terminal.
  • Mensagens de suas outras sessões: com mensagens entre sessões, a mesma conexão carrega mensagens entre suas próprias sessões em máquinas diferentes e de suas sessões na nuvem.
  • Diff de suas alterações: quando o diretório da sessão está em um repositório git, o painel de diff de um dispositivo conectado mostra suas alterações. Em uma ramificação que tem commits à frente da ramificação padrão do repositório, o painel mostra as alterações desde que a ramificação se dividiu dela, incluindo suas edições não confirmadas. Na ramificação padrão em si, ou em uma ramificação que não está à frente dela, o painel mostra apenas suas alterações não confirmadas.
  • Modelo: quando você escolhe um modelo de um dispositivo conectado, Claude Code executa a sessão nesse modelo. Requer Claude Code v2.1.238 ou posterior. Um modelo que você escolhe do controle de modelo do dispositivo se aplica apenas à sessão atual. Quando você envia /model <name> do dispositivo para uma sessão interativa, Claude Code também define seu padrão para novas sessões.
  • Nível de esforço: quando você define o nível de esforço de um dispositivo conectado, com /effort ou o controle de esforço do dispositivo, Claude Code o aplica à sessão na sua máquina. Se você fixou um nível com CLAUDE_CODE_EFFORT_LEVEL, a sessão mantém esse nível, e Claude Code recusa uma escolha diferente do controle de esforço. Escolher um nível do controle de esforço requer Claude Code v2.1.234 ou posterior na sua máquina.
  • Reconectando após uma falha de conexão: execute /remote-control para reconectar. Se a compactação reescreveu a conversa ou você alternou conversas com /resume enquanto isso, Claude Code arquiva a sessão do servidor que estava usando em vez de deixá-la na lista de sessões. Você ainda pode encontrá-la filtrando por sessões arquivadas. Alternar conversas enquanto um dispositivo ainda está conectado não arquiva a sessão.

Ativar Remote Control para todas as sessões

Remote Control só é ativado quando você executa explicitamente claude remote-control, claude --remote-control ou /remote-control, a menos que a conexão automática esteja ativada. Para ativar a conexão automática para cada sessão interativa, execute /config dentro de Claude Code e defina Enable Remote Control for all sessions. O alternador assume três valores:

  • true: conecte automaticamente quando uma sessão interativa inicia.
  • false: desative a conexão automática, embora um true de configurações gerenciadas o supere, porque Claude Code salva a escolha em suas configurações de usuário. Um false em configurações de projeto ou local (.claude/settings.json, .claude/settings.local.json) desativa a conexão automática mesmo sobre um true gerenciado.
  • default: limpe sua escolha e siga o padrão do administrador da sua organização se um estiver definido, caso contrário, o padrão atual de Claude Code.

O mesmo alternador aparece fora da CLI:

  • Aplicativo Desktop: Settings > Claude Code > Enable remote control by default.
  • Extensão VS Code: Enable Remote Control for all sessions na seção Settings do menu de comandos.

Para ativar a conexão automática a partir de um arquivo de configurações, defina remoteControlAtStartup como true em seu ~/.claude/settings.json de usuário ou em configurações gerenciadas. Em configurações de projeto ou local (.claude/settings.json, .claude/settings.local.json), Claude Code honra um false e desativa a conexão automática para esse repositório, mas ignora um true, para que um arquivo verificado não possa ativar Remote Control para todos que abrem o repositório.

A conexão automática se conecta com sua própria conta claude.ai, portanto uma sessão que ela inicia aparece apenas nos seus próprios aplicativos Claude e não concede acesso a ninguém mais.

Com essa configuração ativada, cada processo interativo de Claude Code registra uma sessão remota. Se você executar várias instâncias, cada uma obtém sua própria sessão remota. Para executar várias sessões simultâneas a partir de um único processo, use modo servidor em vez disso.

Retomar sessões após parar o servidor

Quando você para claude remote-control com Ctrl+C, as sessões que ele estava servindo param de responder do seu telefone ou navegador. Contanto que você não estivesse executando outro claude remote-control no mesmo diretório e não tenha iniciado este com --no-create-session-in-dir, Claude Code não as arquiva. Para recuperá-las, execute um destes comandos no mesmo diretório:

  • claude remote-control: recupera cada sessão que o servidor estava servindo.
  • claude remote-control --continue: recupera apenas a sessão que o servidor iniciou, e sai quando essa sessão termina. Se este diretório não tem registro, Claude Code usa a mais recente dos outros git worktrees deste repositório.
  • claude remote-control --session-id <id>: recupera apenas a sessão cujo ID você passa, e sai quando essa sessão termina. O ID é a parte da URL da sessão em claude.ai/code entre /code/ e qualquer ?.

Esses comandos funcionam por cerca de quatro horas após o servidor parar. Depois disso, execute claude remote-control para iniciar uma nova sessão. Se você arquivou uma sessão enquanto isso, --continue e --session-id a desarchivam no Claude Code v2.1.228 ou posterior.

Para recuperar uma sessão que você iniciou com claude --remote-control ou /remote-control, retome a conversa com claude --continue ou claude --resume. Se Remote Control não se reconectar, consulte Não foi possível reconectar à sua sessão de Remote Control.

Se você retomar a conversa em um segundo terminal enquanto o primeiro ainda tem Remote Control ativado, Claude Code imprime um aviso Remote Control not started here no segundo terminal e deixa Remote Control desativado lá em vez de tirar a sessão do primeiro. Execute /remote-control no segundo terminal para mover Remote Control para ele.

Quando você retoma uma conversa no Claude Desktop ou em uma extensão IDE que tinha Remote Control ativado, Claude Code o reanexa à sessão claude.ai existente em vez de adicionar uma nova à lista de sessões.

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.

Enquanto Remote Control está conectado, a transcrição da sessão, incluindo suas mensagens, respostas do Claude e atividade de ferramentas, é armazenada nos servidores Anthropic. A transcrição armazenada mantém a conversa sincronizada em seus dispositivos e permite que a sessão se reconecte após uma queda de rede. A execução e o acesso ao sistema de arquivos permanecem na sua máquina, e as transcrições armazenadas são retidas sob a política de Uso de dados.

Para desativar Remote Control completamente, use a configuração disableRemoteControl. Organizações com requisitos de conformidade, como Zero Data Retention, não podem ativar Remote Control.

Dispositivos Confiáveis

Dispositivos Confiáveis requer que cada membro da sua organização, ou você sozinho em um plano Pro ou Max, verifique seu dispositivo antes de poder visualizar ou controlar sessões de Remote Control a partir de claude.ai, dos aplicativos Claude para dispositivos móveis ou Claude Desktop. Ele vincula o acesso ao Remote Control a um dispositivo conhecido e uma autenticação recente, não apenas a uma conta conectada.

Quando a configuração está ativada, interagir com uma sessão de Remote Control requer ambos os seguintes:

  • Um dispositivo inscrito: cada navegador, telefone ou aplicativo desktop que um membro usa para Remote Control inscreve sua própria credencial. A inscrição é oferecida apenas pouco tempo após um login completo, portanto um dispositivo entra na lista confiável como parte de uma autenticação real em vez de silenciosamente em segundo plano.
  • Um login recente: o login do membro não deve ter mais de 18 horas. Em vez de fazer login novamente a cada dia, os membros confirmam presença com Face ID, Touch ID, Windows Hello ou uma passkey. Esta etapa de autenticação biométrica atualiza a sessão imediatamente.

Verificações biométricas são executadas no dispositivo através do sistema operacional ou navegador, o mesmo mecanismo que o login com passkey. Anthropic nunca recebe ou armazena impressões digitais, dados faciais ou qualquer outra informação biométrica. Apenas a chave pública do dispositivo e metadados básicos como nome de exibição, plataforma e hora de inscrição são armazenados.

A configuração se aplica apenas ao Remote Control. Chat regular do Claude, Claude Code no terminal e uso de API não são afetados.

Ativar Dispositivos Confiáveis para uma organização Team ou Enterprise

Um Owner ativa a configuração a partir das configurações de organização do claude.ai.

1

Acesse a página Capabilities

Vá para Organization settings > Capabilities > Remote sessions. O toggle Require trusted devices aparece nessa seção.

2

Ative Require trusted devices

A configuração se aplica a cada membro da organização e a sessões de Remote Control iniciadas após você ativar. Sessões que já estavam em execução antes do toggle ser ativado não são retroativamente protegidas e continuam sem o requisito de dispositivo até que terminem. Escopo por equipe ou por projeto não está disponível.

3

Informe aos membros o que esperar

A primeira vez que um membro visualiza ou controla uma nova sessão de Remote Control a partir de um navegador, telefone ou aplicativo desktop após a configuração ser ativada, ele é solicitado a inscrever esse dispositivo. Informá-los com antecedência evita confusão.

O que os membros veem

A inscrição é uma etapa única por dispositivo. Depois disso, a única mudança visível é um prompt biométrico ocasional.

  • Primeiro uso em cada dispositivo: o membro é solicitado a se inscrever. Se seu login não for recente, ele faz login primeiro através do seu fluxo normal, incluindo SSO se configurado, depois confirma a inscrição.
  • Dia a dia: membros com um dispositivo inscrito e um login recente não veem prompts. Quando o login envelhece além de 18 horas, a próxima interação de Remote Control mostra um único prompt de Face ID, Touch ID, Windows Hello ou passkey.
  • Dispositivos não inscritos: sessões de Remote Control não podem ser visualizadas ou controladas até que o dispositivo seja inscrito. Chat regular do Claude nesse dispositivo não é afetado.
  • Sem autenticador de plataforma: membros em uma máquina sem Face ID, Touch ID ou Windows Hello podem usar uma chave de segurança de hardware ou fazer login novamente em vez de fazer uma autenticação.
  • No terminal: a máquina executando Claude Code recebe sua própria credencial automaticamente quando o desenvolvedor faz login na CLI. Não há etapa de inscrição separada no terminal.

Gerenciar dispositivos inscritos

Os membros podem revisar e revogar seus próprios dispositivos a partir das configurações de conta.

Abra claude.ai/settings/account e encontre a seção Trusted devices para ver cada dispositivo inscrito com seu nome, plataforma e data de inscrição. Remover um dispositivo revoga sua credencial imediatamente, e o dispositivo pode se inscrever novamente mais tarde após um novo login. Credenciais também expiram por conta própria se não forem renovadas, portanto um dispositivo não utilizado sai da lista confiável automaticamente.

Para um dispositivo perdido ou roubado, o membro o remove desta página. Se o membro não conseguir fazer login, um administrador pode usar Sign out everywhere no console de administrador para revogar cada sessão e dispositivo inscrito para esse membro, após o qual o membro inscreve novamente os dispositivos que ainda possui.

Remote Control vs sessões em nuvem

Remote Control e sessões em nuvem usam a interface claude.ai/code. A diferença principal é onde a sessão é executada: Remote Control executa na sua máquina, portanto seus servidores MCP locais, ferramentas e configuração de projeto permanecem disponíveis. Uma sessão em nuvem é executada na infraestrutura em nuvem, gerenciada pela Anthropic por padrão.

Use Remote Control quando você estiver no meio de um trabalho local e quiser continuar de outro dispositivo. Use uma sessão em nuvem quando quiser 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. Um projeto combina os dois: seus threads são executados na nuvem e ele usa Remote Control para executar um thread no seu computador quando você solicita um lá.

Claude Code oferece várias maneiras de trabalhar quando você não está no seu terminal. Elas diferem no que dispara o trabalho, onde Claude é executado e quanto você precisa configurar.

Gatilho Claude é executado em Configuração Melhor para
Dispatch Envie uma tarefa a partir do aplicativo móvel Claude Sua máquina (Desktop) Emparelhe o aplicativo móvel com Desktop Delegar trabalho enquanto você está ausente, configuração mínima
Remote Control Dirija uma sessão em execução a partir de claude.ai/code ou do aplicativo móvel Claude Sua máquina (CLI, Desktop ou VS Code) Execute claude remote-control ou /remote-control Orientar trabalho em andamento de outro dispositivo
Channels Envie eventos de um aplicativo de chat como Telegram ou Discord, ou seu próprio servidor Sua máquina (CLI) Instale um plugin de canal ou crie o seu próprio Reagir a eventos externos como falhas de CI ou mensagens de chat
Slack Mencione @Claude em um canal de equipe Nuvem Anthropic Instale o aplicativo Slack com Claude Code na web ativado PRs e revisões do chat da equipe
Self-hosted environments Inicie uma sessão na nuvem e escolha o ambiente da sua organização Infraestrutura da sua organização Implante runners, em planos Team e Enterprise Sessões na nuvem que devem ser executadas dentro da sua rede
Scheduled tasks Defina um cronograma CLI, Desktop, ou nuvem Escolha uma frequência Automação recorrente como revisões diárias

Notificações push móveis

Quando o 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 exemplo notify me when the tests finish. Além dos dois toggles on/off abaixo, não há configuração por evento.

Para configurar notificações push móveis:

1

Instale o aplicativo móvel Claude

Baixe o aplicativo Claude para iOS ou Android.

2

Faça login com sua conta Claude Code

Use a mesma conta e organização que você usa para Claude Code no terminal.

3

Permita notificações

Aceite o prompt de permissão de notificação do sistema operacional.

4

Ative push no Claude Code

No seu terminal, execute /config e ative Push when Claude decides para notificações proativas, Push when actions required para prompts de permissão e perguntas, ou ambas.

Se as notificações não chegarem:

  • Se /config mostrar No mobile registered, abra o aplicativo Claude no seu telefone para que ele possa atualizar seu token de push. O aviso é limpo 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 Settings → Notifications → 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.

Claude Code pula notificações push móveis enquanto você está digitando ou focado no terminal conectado. Para estender isso para qualquer momento em que você esteja na máquina, mesmo em outra janela, defina CLAUDE_CLIENT_PRESENCE_FILE para um caminho de arquivo marcador: as notificações são puladas enquanto o arquivo existe. Configure um listener de bloqueio de tela ou ferramenta similar para criar o arquivo quando sua tela é desbloqueada e excluí-lo quando sua tela é bloqueada.

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 modo servidor para executar múltiplas 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 aplicativo Desktop ou VS Code, ou de outra forma parar o processo claude, a sessão fica offline até que você a traga de volta. Para manter uma sessão em execução em uma máquina remota após desconectar do SSH, inicie-a dentro de tmux ou screen.
  • Sessões travadas em modo servidor: se uma sessão servida por claude remote-control travar, envie uma mensagem para ela a partir de um dispositivo conectado. Claude Code a serve novamente. Você não precisa reiniciar o servidor. Requer Claude Code v2.1.238 ou posterior.
  • Recusas HTTP 403 em uma sessão conectada: uma vez que uma sessão interativa está conectada, Claude Code continua tentando novamente por até três minutos quando algo entre sua máquina e os servidores da Anthropic responde com HTTP 403, o que pode acontecer após uma mudança de VPN ou rede. Se as recusas durarem mais tempo, Claude Code se desconecta e o motivo nomeia o que recusou: uma borda de rede, ou um proxy, VPN ou firewall em sua própria rede.
  • Interrupção de rede estendida: se sua máquina estiver ligada mas não conseguir alcançar a rede, o que você faz a seguir depende do modo:
    • Modo servidor: Claude Code desiste após aproximadamente 10 minutos e o processo claude remote-control sai. Execute claude remote-control novamente para iniciar uma nova sessão.
    • Sessão interativa: continue trabalhando localmente. Claude Code tenta novamente enquanto a interrupção durar e se reconecta automaticamente quando a rede retorna.
  • Falhas de heartbeats de presença: se uma sessão interativa se desconectar com could not reach the Remote Control server for about 30 minutes, execute /remote-control para se reconectar.
  • Diálogos encaminhados expiram: Claude Code mantém prompts de permissão e perguntas AskUserQuestion abertas até que você as responda. Quando Claude Code encaminha outro tipo de diálogo para a sessão remota, como o prompt de escolha de modelo mostrado após uma recusa de segurança, ele aguarda cinco minutos por padrão, depois fecha o diálogo e continua com o padrão sem ação do diálogo. Defina dialogExpiry para ajustar ou desabilitar o prazo. Requer Claude Code v2.1.224 ou posterior.
  • O prompt de consentimento de créditos de uso do Fable não é encaminhado: Claude Code mostra o prompt de consentimento de créditos de uso do Fable no meio da sessão apenas onde a sessão é executada, não em seu dispositivo. Quando a sessão é executada em um terminal e ninguém lá responde antes de Claude Code fechar o prompt, a vez termina sem enviar a solicitação; veja O prompt para confirmar não foi respondido.
  • Alguns comandos são apenas locais: comandos que só são executados na interface do terminal, como /plugin ou /resume, funcionam apenas a partir da CLI local, independentemente de você passar um argumento ou não. Os seguintes funcionam em dispositivos móveis e web:
    • Comandos de saída de texto: /compact, /clear, /context, /usage, /exit, /usage-credits, /recap e /reload-plugins. /usage-credits imprime a URL de faturamento em vez de abrir um navegador. /reload-plugins funciona apenas quando a sessão é executada em um terminal interativo; uma sessão sem um a recusa.
    • /model, /effort, /fast, /color e /rename: passe o valor como um argumento, por exemplo /model sonnet ou /effort high. De dispositivos móveis e web, /model e /effort usam o argumento no lugar do seletor de terminal ou controle deslizante.
    • /mcp: a partir do aplicativo móvel, retorna um resumo de texto do status do servidor em vez de abrir o seletor. Na web, /mcp por si só abre um diretório de conectores claude.ai em vez de retornar o resumo. Os subcomandos reconnect, enable e disable funcionam em ambos. Ao contrário da CLI local, /mcp reconnect sem um nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação.
    • /config: a partir do aplicativo móvel, passe key=value para definir uma configuração, ou execute-o sem argumento para listar as chaves que você pode definir. Na web, /config abre a seção Claude Code de suas configurações, e ignora o texto após o comando.
    • Em Team e Enterprise, /usage-credits de dispositivos móveis ou web não envia uma solicitação de créditos de uso para seu administrador. O envio requer uma confirmação que aparece apenas na CLI interativa, então o comando diz para você executá-lo lá.
    • /autocompact, a partir de v2.1.221: passe o tamanho da janela como um argumento, por exemplo /autocompact 500k. Sem argumento, ele imprime o tamanho da janela atual como texto em vez de abrir o diálogo que o comando mostra em uma sessão de terminal.
    • /advisor, a partir de v2.1.260: passe o modelo como um argumento, por exemplo /advisor opus, ou passe off para desativar o advisor. Ambas as formas se aplicam apenas à sessão atual e deixam seu padrão salvo inalterado. Sem argumento, ele imprime o advisor atual como texto em vez de abrir o seletor.
    • /output-style, a partir de v2.1.269: passe o nome do estilo como um argumento, por exemplo /output-style concise, ou execute-o sem argumento para listar os estilos. De dispositivos móveis e web, você pode listar e selecionar apenas estilos integrados. Para usar um estilo personalizado, selecione-o na sessão em si.
    • /focus, a partir de v2.1.281: passe on ou off como um argumento, por exemplo /focus on, ou execute-o sem argumento para alternar a visualização de foco. Ambas as formas se aplicam apenas à sessão atual e deixam sua seleção salva inalterada.

Troubleshooting

"Remote Control requires a claude.ai subscription"

Você não está conectado com uma conta claude.ai, ou outra credencial está tendo precedência sobre seu login. A mensagem assume uma destas formas:

  • Desconectado, de /remote-control ou --remote-control: Remote Control requires a claude.ai subscription. ou /remote-control requires a claude.ai subscription.
  • Desconectado, de claude remote-control: You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.
  • Conectado, mas uma chave de API ou token está em uso: Remote Control requires claude.ai subscription auth. seguido pela credencial em uso, como ANTHROPIC_API_KEY is set, so this session is using API-key auth. Uma configuração apiKeyHelper e ANTHROPIC_AUTH_TOKEN são nomeadas da mesma forma.

Execute claude auth login e escolha a opção claude.ai. Se a mensagem nomear ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN, remova-a onde quer que esteja definida: seu ambiente de shell ou o bloco env de um arquivo de configurações. Se nomear apiKeyHelper, remova essa configuração.

"Remote Control requires a full-scope login token"

Você está autenticado com um token de longa duração de claude setup-token ou da variável de ambiente CLAUDE_CODE_OAUTH_TOKEN. Esses tokens podem apenas fazer solicitações de modelo, então não conseguem 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 obsoletas ou incompletas. Execute claude auth login para atualizá-las.

"Remote Control isn't enabled for this account"

Claude Code verificou a disponibilidade de Remote Control para a conta com a qual você está conectado e a verificação retornou desativada. A causa usual é direitos em cache que estão desatualizados após uma mudança de plano. Execute claude auth logout e depois claude auth login para atualizá-los, e atualize Claude Code se você estiver em uma versão antiga.

Execute claude doctor para ver qual verificação de elegibilidade individual falhou. Conflitos de variáveis de ambiente, verificações inacessíveis e a configuração de Remote Control da sua organização cada um produzem sua própria mensagem, então esse erro significa que a verificação no nível da conta em si.

Antes da v2.1.239, essa mensagem lia "Remote Control is not yet enabled for your account".

"Couldn't verify Remote Control eligibility"

Claude Code não conseguiu alcançar o serviço de sinalizador de recurso para verificar se Remote Control está habilitado para sua conta, normalmente porque você está offline ou um proxy está bloqueando a solicitação. Tente novamente assim que tiver acesso à rede, ou execute claude doctor para obter detalhes. A mensagem relacionada "Couldn't verify your organization's Remote Control policy" significa que Claude Code encontrou um erro ao ler essa política, e tem a mesma solução.

"Remote Control requires feature-flag evaluation"

Uma variável de ambiente que desativa a avaliação de sinalizador de recurso está definida, e a mensagem completa nomeia a variável que Claude Code encontrou. Em versões anteriores a 2.1.154, a mesma configuração produz "Remote Control is not yet enabled for your account" em vez disso. O que fazer depende da variável que a mensagem nomeia:

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_GROWTHBOOK: desdefina a variável onde quer que esteja definida, em seu ambiente de shell ou no bloco env de um arquivo settings.json.
  • DISABLE_TELEMETRY ou DO_NOT_TRACK: em um plano Pro, Max, Team ou Enterprise com DISABLE_GROWTHBOOK desativado, essas variáveis deixam Remote Control disponível a menos que sua organização exija Trusted Devices. Se exigir, desdefina a variável onde quer que esteja definida para usar Remote Control. Da v2.1.154 até v2.1.282, qualquer variável produzia essa mensagem, então atualize Claude Code para v2.1.283 ou posterior.

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

A sessão não está falando com a API Anthropic diretamente, então não há backend claude.ai para emparelhar. Isso acontece no Amazon Bedrock, na Agent Platform do Google Cloud e no Microsoft Foundry. Também acontece quando ANTHROPIC_BASE_URL aponta para um host diferente de api.anthropic.com, como um gateway LLM ou proxy, mesmo se você se conectar com claude.ai. Veja a referência de erros para a lista completa de causas.

A mensagem nomeia o que roteou a sessão para longe da API Anthropic, como CLAUDE_CODE_USE_BEDROCK ou um ANTHROPIC_BASE_URL personalizado. Se você tiver um login claude.ai elegível, desdefina a variável nomeada, remova-a da chave env em configurações se você a definiu lá, e reinicie a sessão.

"Remote Control is disabled by your organization's policy"

Uma política bloqueia Remote Control. Verifique essas causas em ordem:

  • O erro menciona disableRemoteControl: seu administrador de TI desabilitou Remote Control neste dispositivo através de configurações gerenciadas, independentemente do alternador em toda a organização e de como você está conectado.
  • Seu plano claude.ai é Pro ou Max: Claude Code ainda está conectado sob uma organização Team ou Enterprise de um login anterior, então verifica a política de Remote Control dessa organização. Execute /status para ver qual plano e organização seu login usa. Execute claude auth logout e depois claude auth login para se conectar novamente sob seu plano atual.
  • A mensagem não diz para entrar em contato com seu administrador de organização: sua organização tem uma configuração HIPAA que é incompatível com Remote Control, e /status lista HIPAA em sua linha Compliance. Neste estado, o alternador de Remote Control do painel de administração está esmaecido, então um Owner não consegue alterá-lo lá. Entre em contato com o suporte Anthropic para discutir opções. Antes da v2.1.267, este caso mostrava "Remote Control isn't available for your organization due to its compliance policy" em vez disso.
  • Caso contrário, um Owner não o habilitou para sua organização: Remote Control está desativado por padrão em planos Team e Enterprise. Um Owner pode habilitá-lo em claude.ai/admin-settings/claude-code ativando o alternador Remote Control. Este alternador é uma configuração de organização no lado do servidor.

Antes da v2.1.281, essa mensagem também aparecia quando Claude Code não tinha carregado a política da sua organização nesta máquina, por exemplo após iniciar offline. Versões posteriores relatam esse estado como Couldn't verify your organization's policy for remote control em vez disso.

"Couldn't verify your organization's policy for remote control"

Claude Code não conseguiu buscar a política da sua organização e não tem uma cópia salva nesta máquina para usar em vez disso, então mantém Remote Control desativado até que possa confirmar que sua organização o permite. Isso geralmente acontece quando você inicia Claude Code offline ou antes de uma VPN se conectar, ou quando um proxy interfere na solicitação. Em uma conexão lenta, também pode aparecer enquanto a primeira solicitação ainda está em andamento.

A mensagem assume uma destas formas:

  • De /remote-control, claude remote-control, ou claude --remote-control: Couldn't verify your organization's policy for remote control. Check your network connection and try again.
  • De auto-connect quando uma sessão inicia: couldn't verify your organization's policy — check your network connection and try again, prefixado com Remote Control failed na notificação e Remote Control disconnected na conversa. A sessão então deixa Remote Control desativado.

Restaure sua conexão de rede, então execute /remote-control ou execute o comando novamente. Cada tentativa verifica a política novamente, então você não precisa reiniciar Claude Code. Se a mensagem continuar aparecendo, execute claude doctor e leia sua linha Organization policy, que diz por que a política não foi carregada.

Antes da v2.1.281, esse estado mostrava Remote Control is disabled by your organization's policy em vez disso.

"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:

claude remote-control --verbose

Causas comuns:

  • Não conectado: execute claude e use /login para autenticar com sua conta claude.ai. Autenticação de 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 mais cedo na configuração. Verifique se sua assinatura está ativa.

"Couldn't reconnect to your Remote Control session"

Quando você retoma uma conversa com claude --resume ou claude --continue, Claude Code se reconecta à sessão de Remote Control registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, então Claude Code não consegue confirmar se a sessão remota ainda existe.

Execute /remote-control para tentar a conexão novamente, ou inicie uma nova sessão com claude --remote-control para criar uma nova sessão de Remote Control. Sua sessão local continua funcionando sem Remote Control enquanto isso.

"Previous session is unavailable — run /remote-control to start a new one"

Claude Code não conseguiu trazer de volta a sessão anterior de Remote Control e parou em vez de iniciar uma nova por conta própria. Você pode ver esta mensagem depois de retomar uma conversa com claude --resume ou claude --continue, ou depois que Claude Code se reconecta por conta própria após uma desconexão.

Execute /remote-control para iniciar uma nova sessão de Remote Control sob o login atual; sua sessão local continua funcionando sem Remote Control enquanto isso. A mensagem relacionada Remote Control could not verify the signed-in account — run /remote-control to reconnect tem a mesma solução. Se você executar /remote-control após Previous session is unavailable sem reiniciar Claude Code primeiro, Claude Code deixa as mensagens anteriores da conversa fora da nova sessão.

"Remote Control got an unexpected server response"

O servidor de Remote Control aceitou uma solicitação mas respondeu de uma forma que esta versão de Claude Code não conseguiu ler, ao criar a sessão remota ou buscar suas credenciais. Tentar novamente na mesma versão falha da mesma forma. Execute claude update, então execute /remote-control para se reconectar.

"Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

Sua organização tem Trusted Devices habilitado e esta máquina ainda não se inscreveu. Execute /login em Claude Code. A inscrição acontece como parte do sign-in, e não há comando de inscrição separado.

"session expired for trusted-device check"

Seu sign-in tem mais de 18 horas. Execute /login em Claude Code, ou confirme com Face ID, Touch ID, Windows Hello, ou uma passkey quando claude.ai ou o aplicativo móvel solicitar. Veja Trusted Devices.

  • Claude Code na web: execute sessões na nuvem em vez de na sua máquina, configurado através de ambientes em nuvem
  • Mensagens entre sessões: deixe Claude enviar mensagens para suas sessões em outras máquinas ou em sessões em nuvem
  • 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 /login e 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, Remote Control e em nuvem