Você deixou o Claude Code rodando num servidor, saiu de casa e lembrou de uma tarefa. Abrir o notebook, conectar por SSH e digitar comandos no ônibus não é exatamente prático.
O canal MeticsMedia mostrou, no vídeo “Run Claude Code 24/7 on a VPS (Always-On AI Agent Tutorial)”, de 14 de outubro de 2026, como deixar o agente sempre ligado num VPS e mandar tarefas direto do celular. Os capítulos finais, a partir de 10:31, tratam exatamente dessa conexão.
Neste tutorial, você aprende a controlar o Claude Code pelo celular usando o Remote Control, o recurso oficial que liga o app do Claude a uma sessão rodando no seu servidor. Explicamos cada comando com base na documentação oficial da Anthropic.
Como funciona o Claude Code pelo celular
O Remote Control conecta o site claude.ai/code ou o app do Claude para iOS e Android a uma sessão do Claude Code que está rodando na sua máquina. No nosso caso, essa máquina é o VPS.
O ponto importante é que nada sai do servidor: o código roda lá, os arquivos ficam lá e as ferramentas configuradas continuam disponíveis. O celular funciona como uma janela para a sessão, e você pode alternar entre terminal, navegador e app sem perder o fio da conversa.
Se você ainda não montou o servidor, comece pelo nosso tutorial do Claude Code 24/7 em um VPS, que cobre a primeira metade do vídeo: plano, configuração, senha de root e o comando que mantém o agente ligado.
| Item | O que você precisa | Observação |
|---|---|---|
| Assinatura | Plano Pro, Max, Ultra, Team ou Enterprise do Claude | Chave de API não funciona com o Remote Control |
| Servidor | VPS com o Claude Code instalado | O processo precisa ficar rodando o tempo todo |
| Login | Conta claude.ai feita com /login no servidor | Tokens de longa duração não servem |
| Celular | App do Claude para iOS ou Android | Ou qualquer navegador em claude.ai/code |
| Team ou Enterprise | Remote Control ativado por um Owner | Fica nas configurações de admin do Claude Code |
Passo a passo: Claude Code pelo celular
Os passos abaixo partem de um VPS já com o Claude Code instalado e acessível pelo terminal, como no vídeo. Os comandos são os da documentação oficial do Remote Control.
Acesse o terminal do VPS. Se você fechar a aba, o processo morre, por isso o vídeo mostra (aos 7:03) um comando para manter o Claude Code ativo depois de fechar o terminal. Uma opção comum é o
tmux: rode tmux new -s claude e trabalhe dentro dele.Rode
claude e use /login para entrar pela conta claude.ai. Se a variável ANTHROPIC_API_KEY estiver definida no servidor, ela tem prioridade e o Remote Control recusa a conexão, então remova-a.Entre no diretório onde o agente vai trabalhar, por exemplo
cd ~/meu-site. O Remote Control usa a pasta em que foi iniciado.Rode
claude remote-control --name "VPS do site". Na primeira vez, o Claude Code explica o recurso e pergunta “Enable Remote Control? (y/n)”. Responda y. O processo fica aguardando conexões e mostra um endereço.Aperte a barra de espaço para exibir um QR code e escaneie com o celular. Outra opção: abra o app do Claude, toque em Code e escolha a sessão pelo nome. Sessões online aparecem com um ícone de computador e uma bolinha verde.
Escreva um pedido simples, como “crie uma página de contato no site”. No vídeo, a partir de 11:17, o autor faz exatamente isso: manda o pedido do celular e acompanha o agente montando um site sozinho.
Fechar o app não encerra a sessão no servidor. O Claude Code continua rodando no VPS, e você pode voltar depois pelo mesmo nome na lista de sessões.
/mobile dentro do Claude Code. Ele mostra um QR code que abre a loja de aplicativos certa para o seu aparelho, sem precisar procurar.
Três jeitos de ligar o Remote Control
A documentação oficial descreve três formas de iniciar o recurso, e vale escolher conforme o seu uso:
- Modo servidor (
claude remote-control): fica esperando conexões e pode atender várias sessões. É o mais indicado para um VPS sempre ligado. - Sessão interativa (
claude --remote-control "Nome"): abre o Claude Code normal no terminal e também libera o controle remoto. Bom quando você quer digitar no terminal e no celular. - Dentro de uma sessão aberta (
/remote-control): liga o recurso numa conversa que já está em andamento, sem recomeçar.
No modo servidor, o padrão é que todas as sessões dividam a mesma pasta. Se você pretende abrir duas tarefas ao mesmo tempo no mesmo projeto, use --spawn worktree para que cada sessão ganhe uma cópia isolada do repositório Git, evitando que uma sobrescreva o arquivo da outra.
O limite padrão é de 32 sessões simultâneas, ajustável com --capacity. Para um VPS pequeno, menos é melhor: cada sessão consome memória e processamento.
Segurança: o que fica exposto e o que não fica
Uma dúvida comum é se o recurso abre uma porta no servidor. Segundo a Anthropic, não: a sessão local faz apenas requisições HTTPS de saída e nunca abre portas de entrada. Todo o tráfego passa pela API da Anthropic com TLS, usando credenciais de curta duração.
Por outro lado, enquanto o Remote Control está conectado, o histórico da sessão (suas mensagens, as respostas e as ações das ferramentas) fica armazenado nos servidores da Anthropic, para manter os aparelhos sincronizados. A execução e os arquivos continuam no seu VPS.
Na prática, o risco maior está no próprio servidor. Mantenha o sistema atualizado: a falha crítica no kernel Linux divulgada nesta semana mostra por que um VPS esquecido vira alvo. E, se não quiser o recurso, a configuração disableRemoteControl desliga tudo.
Erros comuns e como resolver
| Mensagem | Causa provável | Como resolver |
|---|---|---|
| Remote Control requires a claude.ai subscription | Sem login claude.ai ou chave de API em uso | Rode claude auth login e remova ANTHROPIC_API_KEY |
| Requires a full-scope login token | Login feito com claude setup-token |
Faça login de novo com claude auth login |
| Remote Control disconnected | Processo parou ou a rede caiu | Confira se o Claude Code segue rodando no tmux |
| Only available via api.anthropic.com | ANTHROPIC_BASE_URL aponta para outro servidor |
Remova a variável para usar o recurso |
Também não funciona se você usa o Claude via Amazon Bedrock, Google Cloud ou Microsoft Foundry. Nesses casos, o caminho continua sendo o SSH tradicional, que também tem apps para celular.
Perguntas frequentes
Preciso deixar o computador ligado?
Não, se o Claude Code estiver num VPS. O Remote Control exige que a máquina onde ele roda fique ligada, e é justamente por isso que o servidor resolve: ele não desliga quando você fecha o notebook.
Funciona no plano gratuito do Claude?
Não. A documentação lista os planos Pro, Max, Ultra, Team e Enterprise. Contas que usam só chave de API também ficam de fora.
Posso mandar fotos e arquivos pelo celular?
Sim. Fotos anexadas no app são vistas diretamente pelo Claude, e outros arquivos são baixados para o servidor e passados ao agente como referência.
O agente faz tudo sem me perguntar?
Depende do modo de permissão. Você pode definir o modo inicial com --permission-mode. Para começar, prefira o modo que pede confirmação antes de editar arquivos.
Conclusão
Com um VPS, o tmux e o comando claude remote-control, o Claude Code vira um assistente que trabalha enquanto você está longe e responde a pedidos feitos pelo celular. São sete passos e nenhuma porta aberta no servidor.
Quer o próximo nível? Veja como publicar o site criado pelo Claude Code na Hostinger e coloque o resultado no ar.