Antenna
PT
Baixar

Atualizado em

Rode o Claude Code numa VPS o tempo todo e fale com ele pelo notebook

Instale o Claude Code e o nó do Antenna na sua VPS Linux, pareie o servidor com o seu notebook uma vez e inicie o Claude Code pelo Antenna na pasta do projeto. A partir daí, ele roda na sua própria sessão tmux depois que você sai, acorda quando chega uma mensagem para ele e responde num chat no seu notebook. Nenhuma porta de entrada para abrir, nenhuma sessão SSH para manter viva, e o Codex funciona do mesmo jeito.

O que você precisa

1. Instale o nó do Antenna no servidor

curl -fsSL https://antenna.contact/install.sh | sh
    sudo loginctl enable-linger $USER

O instalador lê a versão mais recente no manifesto assinado, confere o arquivo, instala o antennad e o antenna em ~/.local/bin como um serviço de usuário do systemd (sem precisar de root) e cria o seu nó com uma senha. A segunda linha mantém o serviço rodando depois que você sai. No Ubuntu ou no Fedora, você pode instalar o pacote .deb ou .rpm no lugar.

2. Pareie com o seu notebook

No notebook: Novo contato → Convidar, dê um nome, marque Este é o meu próprio computador (∞), clique em Criar link e copie. No servidor:

antenna join '<link>' --trust 5 --label mac

Mantenha as aspas simples: o link contém um #. Digite no terminal do servidor o código que o notebook mostra e depois clique em O contato confirmou — os códigos conferem no notebook. O nível 5 é ∞ nos dois lados, então o servidor conta como um computador seu.

3. Inicie o Claude Code pelo Antenna

cd ~/projects/api
    antenna connect claude-code --agent api-dev --links mac --hello mac
    antenna session start api-dev --dir ~/projects/api
    antenna session attach api-dev

A linha do connect dá à sessão um agente e um token próprios e manda um oi, para que um chat chamado api-dev apareça no seu notebook. A linha do start inicia o Claude Code no servidor tmux do próprio Antenna (o seu tmux não é tocado). Conecte-se uma vez para responder às primeiras perguntas do Claude Code, por exemplo se ele confia na pasta, e depois saia com Ctrl-b d: ele continua rodando. Para o Codex, use antenna connect codex e --cli codex.

4. Fale com ele

Escreva no chat api-dev do seu notebook: “Rode os testes da migration e corrija o que falhar.” Quando o Claude Code está parado no prompt, o Antenna digita uma linha curta para que ele leia a sua mensagem; ele nunca digita o texto de um contato e nunca responde a uma pergunta no lugar dele. O cartão do servidor em Meus dispositivos mostra o estado e os agentes dele, e você pode aprovar os pedidos dele pelo notebook.

Depois de um reinício

As chaves do nó ficam bloqueadas depois que o servidor reinicia: o serviço roda, mas as conexões ficam em silêncio até você fazer login e rodar antenna unlock. Assim, uma cópia do disco do servidor não entrega as suas chaves a ninguém. antenna status diz se ele está bloqueado.

Perguntas

Por que não só SSH e tmux?

Isso funciona enquanto você está no terminal. O Antenna acrescenta um chat para o qual você pode escrever do notebook a qualquer hora, acorda a sessão quando você escreve e deixa outros agentes passarem trabalho para ela, com permissões que ele mesmo confere.

O servidor precisa de IP público ou de portas abertas?

Não. Os dois lados se conectam para fora, diretamente quando a rede permite e por um relay quando não. O relay só repassa tráfego criptografado.

Posso rodar várias sessões num servidor?

Sim: um agente por pasta de projeto, cada um com nome próprio e chat próprio no seu notebook.

Existe build para ARM?

Ainda não. O nó de servidor é compilado para Linux x86_64.

Guias relacionados