eu sou o Dudu, fundador da DobraLabs (um laboratório de design, tecnologia e IA) e apresentador do Ratos de IA, o canal no youtube onde a gente mostra IA na prática, e o time inteiro aqui trabalha com o claude code, o agente de IA da Anthropic que lê arquivo, roda comando e executa tarefa no terminal. e o claude code para no instante em que tu fecha a tampa do notebook. ele roda na tua máquina, então máquina dormindo é agente dormindo. pra ter o claude code numa vps 24h, tu instala ele num servidor linux que fica ligado o tempo todo e acessa de qualquer lugar: pelo remote control, no app do Claude, ou por uma interface no navegador, que é como o time da DobraLabs trabalha desde setembro.
eu fiz os dois caminhos. primeiro o na mão, que virou um vídeo e um passo a passo que a galera pediu muito. depois, quando o time inteiro precisou trabalhar junto, a gente montou a Ratoeira. vou mostrar os dois, com as armadilhas que a gente pisou.
por que rodar o claude code numa vps
rodar o claude code numa VPS resolve três coisas: tarefa longa que não pode morrer no meio, tarefa agendada que tem que rodar de madrugada e acesso pelo celular sem depender do notebook aberto.
VPS, pra quem não sabe, é um computador alugado num datacenter, com linux, que tu acessa pela internet. como o claude code é um programa de terminal, ele roda em qualquer linux do mesmo jeito que roda no teu Mac. a diferença é que o servidor não dorme, não perde wi-fi e não fecha a tampa.
se o teu objetivo é só mandar uma tarefa de código do celular, vale saber que o claude code na web roda na nuvem da Anthropic, sem servidor nenhum. a VPS compensa quando tu quer os teus arquivos, as tuas chaves e os teus programas num lugar sempre ligado que é teu. se tu ainda não instalou o claude code nem no computador, começa pelo guia claude code: o que é, quanto custa e como começar.
os dois jeitos de ter o claude code 24h
| na mão (remote control + systemd) | no navegador (Ratoeira) | |
|---|---|---|
| onde tu conversa | app do Claude e claude.ai/code | navegador e celular, como app |
| arquivos | só pelo terminal ou pelo VS Code remoto | árvore com HTML, PDF e planilha abertos do lado do chat |
| time | cada um com a sua sessão | conversa compartilhada, cada um com a sua conta |
| agentes | claude code | claude code, Codex, Grok e OpenCode |
| tarefa agendada | tu monta o cron (o agendador de tarefas do linux) | rotinas com aviso no celular |
| esforço | uma tarde de terminal, com o agente te ajudando | o agente do teu computador instala contigo |
o jeito na mão: claude code com remote control e systemd
o jeito na mão é instalar o claude code num usuário comum da VPS e deixar o claude remote-control rodando como serviço do sistema. o remote control liga o claude.ai/code e o app do Claude a uma sessão que roda na tua máquina, e a documentação oficial diz que ele funciona nos planos Pro, Max, Ultra, Team e Enterprise. chave de API não serve.
o passo a passo que a gente usa, resumido:
- VPS com Ubuntu 24.04 limpa e acesso de root por chave SSH (o jeito seguro de entrar no servidor pelo terminal). pro tamanho, tem o post qual vps escolher pra rodar agentes de ia.
- um usuário comum, nunca root. a extensão do VS Code nem funciona conectada como root.
- instalar o claude code nesse usuário com o comando oficial (
curl -fsSL https://claude.ai/install.sh | bash) e logar uma vez na tua assinatura. - criar a pasta de trabalho e aceitar o trust dela (a pergunta de se tu confia no que tem na pasta).
- ligar o remote control como serviço do systemd (o gerenciador de serviços do linux), que sobe no boot e volta sozinho se cair.
o passo 5 é onde todo mundo trava. o serviço do systemd não tem teclado, e o claude code faz duas perguntas na primeira vez: se tu confia na pasta e se tu quer ligar o remote control. se as duas respostas não estiverem gravadas antes, o serviço fica em loop esperando um “y” que nunca vem. a gente grava as duas no ~/.claude.json do usuário (hasTrustDialogAccepted no projeto e remoteDialogSeen) e só depois sobe o serviço:
[Unit]
Description=Claude Code Remote Control
After=network-online.target
Wants=network-online.target
[Service]
User=teu-usuario
WorkingDirectory=/home/teu-usuario/trabalho
ExecStart=/home/teu-usuario/.local/bin/claude remote-control --name minha-vps --spawn=same-dir
Restart=always
RestartSec=10
StandardOutput=null
[Install]
WantedBy=multi-user.target
esse arquivo vai em /etc/systemd/system/claude-rc.service, e aí é sudo systemctl enable --now claude-rc. confere com systemctl is-active claude-rc e procura a sessão minha-vps no app do Claude.
duas linhas desse arquivo vieram de perrengue:
StandardOutput=null: a tela do remote control redesenha a cada segundo. sem essa linha, cada redesenho vira uma linha no log do sistema, e o log cresce sem parar.Restart=always: se a VPS fica sem rede por uns minutos, o remote control cai. com o restart, o systemd sobe de novo sozinho.
nada de tmux pra isso. tmux morre no reboot e tu reconecta na mão. o teste final que eu peço pra todo mundo fazer: desliga o computador e manda uma tarefa pelo celular. se ele respondeu, tá pronto.
o passo a passo completo, escrito pra tu colar no teu agente e ele fazer contigo, está no playbook público. o vídeo é o claude code na VPS.
onde o jeito na mão aperta
o jeito na mão funciona bem pra uma pessoa. com o time, ele aperta em quatro lugares, e foram exatamente as dores que fizeram a gente montar a Ratoeira:
- cada um no seu canto. cada pessoa tinha a sua sessão, e passar trabalho pro colega era copiar e colar conversa.
- arquivo invisível. o agente gerava um relatório em HTML e eu precisava baixar pra ver.
- celular na gambiarra. remote control, terminal no celular, bot no Telegram. funcionava, mas cada coisa num lugar.
- agendamento na unha. tarefa de madrugada era cron escrito à mão, sem aviso quando dava errado.
o jeito no navegador: a ratoeira
a Ratoeira é um portal que roda na tua VPS e abre no navegador. dentro dela, o claude code, o Codex, o Grok e o OpenCode trabalham na mesma pasta, e cada conversa escolhe o agente e a conta. a DobraLabs inteira trabalha nela desde setembro, e ela vem com a Comunidade Ratos, o grupo pago de quem estuda IA aplicada com a gente, em beta.
o que muda no dia a dia, tirado do manual dela:
- a conversa segue com o navegador fechado. tu pede, fecha a aba e volta depois. se o servidor reinicia no meio de um trabalho longo, o agente retoma sozinho.
- a Mesa. a pasta aberta do lado do chat, com HTML, markdown, PDF e planilha renderizados. cada arquivo tem um histórico com quem mudou, quando e o que mudou, e o que o agente faz vira versão no teu nome.
- o terminal continua vivo. abre um terminal na pasta, fecha o navegador, e ele segue lá quando tu volta.
- celular como app. no iPhone, Compartilhar e Adicionar à Tela de Início; no Android, Instalar app. com o aviso ligado, o sino chega no celular quando o agente termina ou precisa de ti.
- rotinas. pedido pro agente num horário, que te chama quando precisa. tem um post só sobre isso: rotinas: o agente trabalhando sozinho.
- contas. cada pessoa liga as contas de IA dela, e bateu o limite numa, a conversa troca pra outra com o mesmo histórico. detalhe em várias contas de claude, codex e grok.
a instalação também é com agente. tu manda pro claude code do teu computador o link da receita que a Comunidade recebe, e ele faz contigo: entra na VPS por SSH, roda o instalador, que para e mostra um código pra ligar a Ratoeira à tua conta na plataforma, e no fim te deixa no primeiro acesso. o instalador confere a máquina antes de mexer em qualquer coisa: Ubuntu 24.04, pelo menos 4 GB de memória (recomenda 8 GB pra time) e 15 GB livres no disco.
cuidados de segurança com o agente numa vps
um agente numa VPS tem acesso à máquina inteira, então a segurança vale mais do que no teu notebook. o mínimo que a gente faz em toda VPS:
- firewall com só três portas abertas: SSH, 80 e 443. o instalador da Ratoeira liga assim e libera a porta de SSH de verdade, que nem sempre é a 22, pra ninguém se trancar do lado de fora.
- SSH só com chave, e só depois de conferir que a chave entra. se der errado, o painel do provedor tem um console web que é a porta dos fundos.
- nada escutando em
0.0.0.0. o que roda na VPS escuta em127.0.0.1, e só sai pra internet pelo proxy da frente, com login. - backup fora da VPS. se a máquina se perder, a cópia no mesmo disco vai junto. a Ratoeira manda uma cópia criptografada toda madrugada pra um armazenamento teu, como Cloudflare R2 ou Backblaze B2.
- chave fora do chat. chave de API não se cola na conversa. tem um post sobre isso: chaves e senhas com agente de ia.
pra fechar
pra deixar o claude code numa vps 24h, tu escolhe entre o jeito na mão, com remote control e systemd, e uma interface que já resolve time, arquivos, celular e agendamento. pra uma pessoa só, o na mão dá conta e ensina muito sobre servidor. quando entra mais gente, ou quando tu quer agendar trabalho e ser chamado no celular, o navegador poupa o perrengue que a gente passou.