O que \"Claude remote agents\" quer dizer de verdade: uma cloud session, uma sessão local controlada à distância ou uma máquina sua

Todo mês, algumas centenas de pessoas digitam "claude remote agents" ou "claude code remote agent" no Google e caem na nossa página sobre como controlar o Claude Code pelo celular. Quase ninguém clica, e com razão: essa página responde a uma pergunta, e a busca faz três.

"Remote" carrega muita coisa nessa busca. Dependendo de quem digita, quer dizer um agente que roda nos servidores da Anthropic enquanto o notebook está fechado, um agente que roda no notebook mas é controlado por um celular, ou um agente que roda em um servidor de build que pertence à pessoa. São três produtos diferentes, com três conjuntos de regras diferentes, e a própria Anthropic renomeou o primeiro este ano, o que explica boa parte da confusão.

Este artigo separa os três, com os fatos conferidos na documentação da Anthropic em 28 de setembro de 2026, e depois conta o que a gente faz no AgentsRoom para cada caso, com qualquer CLI de agente.

A palavra "remote" cobre três coisas diferentes

1. As cloud sessions (sessões na nuvem): o agente roda em uma infraestrutura na nuvem, não na sua máquina. O antigo nome da flag do CLI na Anthropic era --remote, e é por isso que o termo de busca pegou.
2. O Remote Control: o agente roda na sua máquina, e você o controla pelo claude.ai ou pelo app do Claude no celular.
3. Uma máquina sua: o agente roda em um servidor, no computador do escritório ou no de casa, e você chega até ele via SSH ou por um túnel.

Duas das três são recursos do Claude Code. A terceira é infraestrutura comum, e é a única que funciona com todos os CLIs de agentes.

1. As cloud sessions: o agente roda nas máquinas da Anthropic

A documentação da Anthropic chama isso de cloud session: "uma sessão do Claude Code que roda em uma infraestrutura na nuvem em vez de na sua máquina". Por padrão, essa infraestrutura é uma VM isolada gerenciada pela Anthropic; uma organização pode direcionar as sessões para o seu próprio ambiente auto-hospedado. A sessão continua rodando depois que você fecha o notebook, e você pode acompanhá-la ou controlá-la de qualquer dispositivo.

Você pode iniciar uma a partir de cinco lugares, e todos compartilham os mesmos ambientes na nuvem (regras de acesso à rede, variáveis de ambiente, script de configuração):

A forma do terminal é a que explica o termo de busca. A grafia antiga, --remote, ainda funciona como alias obsoleto de --cloud. A política de organização que permite ou proíbe o recurso inteiro ainda se chama allow_remote_sessions. Então "remote" foi a palavra oficial por um tempo, e ela sobrevive em flags, mensagens de erro e configurações de administração.

O que acontece de fato quando você roda claude --cloud: uma nova sessão é criada no claude.ai, e a VM na nuvem clona o remote do GitHub do seu repositório no seu branch atual. Ela clona o remote, não a sua árvore de trabalho, então você faz push antes se tiver commits locais. Se o repositório não tiver remote, ou se a Claude GitHub App não estiver instalada nele, o Claude Code empacota o repositório local (menos de 100 MB, só os arquivos rastreados) e o envia, deixando de fora os .env, *.tfvars e arquivos de chaves não commitados. A tarefa roda na nuvem enquanto você continua trabalhando localmente. Quando ela termina, você cria um pull request pelo claude.ai/code, ou traz a sessão de volta para o seu terminal:

claude --teleport                 # session picker
claude --teleport <session-id>    # a specific session

O teleport confere quatro coisas: um diretório de trabalho limpo, uma cópia do mesmo repositório, o branch da sessão enviado ao remote e a mesma conta do claude.ai. Depois ele baixa o branch e carrega a conversa inteira no seu terminal. A partir do CLI a transferência só vai em um sentido: você pode trazer uma cloud session para baixo, mas não pode mandar uma sessão de terminal existente para cima. Só o app de desktop tem um menu Continue in que envia uma sessão local para a nuvem.

As Routines são a forma agendada da mesma coisa: um prompt salvo, um ou mais repositórios, um conjunto de conectores, executados em um horário, em uma chamada HTTP ou em um evento do GitHub, cada execução sendo uma cloud session completa sem pedidos de permissão. Elas estão em research preview, são criadas em claude.ai/code/routines ou com /schedule no CLI, e acrescentam um teto diário de execuções por conta.

Três limites que vale conhecer antes de depender disso. As cloud sessions precisam do GitHub: o clone e os pull requests passam pela Claude GitHub App ou pelo seu token do gh enviado com /web-setup. Elas dividem os limites de uso com todo o resto da sua conta, sem cobrança de computação separada mas com um consumo proporcional quando você roda várias em paralelo. E elas exigem login no claude.ai com Pro, Max ou Team (Enterprise com as licenças certas): --cloud e --teleport não funcionam com uma chave de API, nem quando o Claude Code está configurado para Bedrock ou Vertex.

2. O Remote Control: o agente roda na sua máquina, você o controla de outro lugar

O Remote Control é a imagem espelhada. A documentação diz isso em uma frase: "Ao contrário das cloud sessions, que rodam em infraestrutura na nuvem, as sessões do Remote Control rodam diretamente na sua máquina e interagem com o seu sistema de arquivos local". O claude.ai/code e o app do Claude no iOS e no Android são uma janela para um processo que continua rodando no seu notebook, com os seus arquivos, os seus servidores MCP, os seus hooks e a configuração do seu projeto. Digitar @ no celular até autocompleta caminhos do seu projeto local.

Três formas de iniciar:

claude remote-control            # server mode: serves sessions to your devices
claude --remote-control          # an interactive session you can also drive remotely
/remote-control                  # from inside a session that is already running

Na primeira vez, o Claude Code pede uma confirmação. Ele precisa de login no claude.ai com Pro, Max, Team ou Enterprise (chaves de API não são suportadas), e no Team e no Enterprise um proprietário precisa ativar a opção antes. Se o notebook entrar em suspensão ou a rede cair, a sessão se reconecta quando a máquina volta. E a observação na própria documentação da Anthropic é a que vale guardar: --cloud cria cloud sessions, --remote-control não tem relação.

Os dois recursos se encontram em um único ponto. O --teleport passa pela infraestrutura de sessões do Remote Control, então um teleport expirado mostra erros escritos com o vocabulário do Remote Control. É um detalhe de encanamento, não um sinal de que os dois são a mesma coisa.

Se a sua dúvida é sobre tokens, a gente mediu: o Remote Control não consome mais tokens, e veja o que o Codex tem no lugar.

3. Uma máquina sua: SSH, um túnel, um servidor de build

O terceiro sentido não tem nada a ver com a conta da Anthropic. O agente roda em um computador que é seu e que não é o que está na sua frente: um servidor de build, o computador do escritório, uma VPS. Você chega até ele via SSH, roda claude ou codex lá, e a sessão vive naquela máquina.

Os editores de código estão começando a empacotar isso. O VS Code 1.121 adicionou "Remote agents (Preview)": a janela Agents pode rodar sessões de agente em uma máquina remota sua, via SSH ou dev tunnels, por meio de um processo host de agente de longa duração, de forma que uma sessão em andamento continua mesmo se o seu cliente desconectar. A mesma ideia, um CLI, um editor.

A versão simples é um terminal e ssh. Funciona com todos os CLIs, mantém o seu código em um hardware que você controla, e tem os custos de sempre: a sessão morre junto com a conexão, a menos que você a envolva em tmux ou screen, e o celular não é um grande cliente SSH.

Como escolher

A pergunta certa não é "qual é o melhor", e sim onde você quer que o código rode e o que você precisa manter.

Duas coisas para ter em mente. As cloud sessions e o Remote Control são recursos do Claude Code: não existe um equivalente de --teleport no Codex, e o Antigravity CLI traz o seu próprio Remote Control desde a versão 2.0. E "remote" não quer dizer "sem supervisão": uma cloud session que faz uma pergunta espera por você até o ambiente dela expirar, e uma sessão do Remote Control espera uma resposta de permissão como qualquer sessão local.

O que a gente faz para cada caso

O AgentsRoom roda os agentes, não hospeda, então ele toma partido em cada um dos três casos em vez de substituí-los.

Controlar um agente local pelo celular, com qualquer CLI: o app mobile do AgentsRoom assume o terminal de cada agente rodando no seu desktop, Claude Code, Codex, GitHub Copilot CLI, Cursor e os outros CLIs de agentes, por um relay criptografado de ponta a ponta, com notificações push quando um agente está esperando por você. Ele convive com o Remote Control da Anthropic em uma sessão do Claude Code: um é uma janela para a conversa, o outro para o terminal.

Um agente em uma máquina sua: as conexões SSH salvam o servidor uma vez e rodam o CLI lá, com os mesmos cards, status e notificações de um agente local; a Frota Remota faz o mesmo em todos os computadores da sua conta, escritório, casa e servidor de build em uma única visão.

Nenhuma máquina sua: os Cloud Agents sobem uma máquina descartável que clona o repositório, roda o Claude Code ou o Codex em headless com a instrução que você enviou pelo celular, faz commit, envia um branch e se destrói. É um job, não uma sessão: não existe tela à qual se conectar, e essa é exatamente a diferença em relação aos dois casos acima.

Nada disso muda o que as cloud sessions da Anthropic fazem. Se você usa o Claude Code e quer que a Anthropic rode a VM, claude --cloud é a ferramenta, e o branch que ele envia aparece no seu repositório como qualquer outro.

Perguntas frequentes

Os remote agents do Claude são a mesma coisa que o Claude Code on the web?

Sim. O nome atual na Anthropic é cloud session: uma sessão do Claude Code que roda em uma infraestrutura gerenciada pela Anthropic (ou no ambiente auto-hospedado da sua organização) em vez de rodar na sua máquina. Você inicia uma pelo claude.ai/code, pela aba Code do app do Claude, pelo app de desktop escolhendo Cloud em vez de Local, ou pelo terminal com claude --cloud. A palavra remote sobrevive da flag antiga, --remote, que ainda funciona como alias obsoleto de --cloud, e da política de organização que controla o recurso, allow_remote_sessions.

O claude --cloud roda alguma coisa no meu computador?

Não. Ele cria uma nova sessão no claude.ai, e a VM na nuvem clona o remote do GitHub do seu repositório no seu branch atual, não a sua cópia local, então você faz push antes se tiver commits locais. Se o repositório não tiver remote, ou se a Claude GitHub App não estiver instalada nele, o Claude Code empacota o repositório local e o envia no lugar, deixando de fora os arquivos .env, as chaves e as credenciais não commitados. A tarefa então roda na nuvem enquanto o seu terminal fica livre.

O Remote Control roda na nuvem?

Não. O Remote Control faz o contrário de uma cloud session: o processo do Claude Code continua rodando na sua própria máquina, com o seu sistema de arquivos, os seus servidores MCP e a configuração do seu projeto, e o claude.ai/code ou o app do Claude no iOS e no Android viram uma janela para ele. Você inicia com claude remote-control (modo servidor), claude --remote-control em uma sessão interativa, ou /remote-control dentro de uma sessão já em andamento. A documentação da Anthropic diz com todas as letras que --cloud e --remote-control não têm relação.

Posso usar as cloud sessions ou o Remote Control do Claude com o Codex, o Antigravity ou outro CLI?

Não. Os dois são recursos do Claude Code, ligados a uma assinatura do claude.ai. O Antigravity CLI tem o seu próprio Remote Control desde a versão 2.0. Para os outros CLIs, a peça que você pode acrescentar é a que não depende do fornecedor: o app mobile do AgentsRoom assume o terminal de qualquer agente rodando no seu desktop, seja qual for o CLI, por um relay criptografado de ponta a ponta, e convive com o Remote Control do Claude em uma sessão do Claude Code.

As cloud sessions custam mais?

Não há cobrança de computação separada pela VM na nuvem, mas as cloud sessions dividem os limites de uso com todo o resto do seu uso do Claude e do Claude Code na sua conta, e várias sessões em paralelo consomem esses limites na mesma proporção. Elas estão disponíveis nos planos Pro, Max e Team, e no Enterprise com licenças premium ou licenças Chat + Claude Code. As Routines, que rodam como cloud sessions, acrescentam um teto diário de execuções por conta.

Como trago uma cloud session de volta para o meu terminal?

Com claude --teleport, que abre um seletor de sessões, ou claude --teleport <session-id> para uma sessão específica; /teleport faz o mesmo de dentro de uma sessão em andamento. O Claude Code confere se o seu diretório de trabalho está limpo, se você está em uma cópia do mesmo repositório e logado na mesma conta, depois baixa o branch da sessão e carrega o histórico da conversa. O terminal recebe a sua própria cópia: o que você fizer depois fica local e não aparece na cloud session. A partir do CLI a transferência só vai em um sentido; só o app de desktop consegue enviar uma sessão local para a nuvem.