Como rodar Aider ou Goose em um VPS

Por que rodar um agente de codificação em um VPS

Um agente de codificação é uma ferramenta que lê seu codebase, escreve alterações e executa comandos para testá-las, tudo via terminal. Rodar um em um VPS tem três vantagens sobre seu laptop: ele continua trabalhando após você desconectar, ele fica junto ao seu código e suas ferramentas de build, e pode se comunicar com um modelo hospedado por você mesmo. Inicie-o dentro de uma sessão tmux para poder fechar seu laptop e retomar o trabalho depois, seguindo o mesmo padrão de rodar Claude Code em um VPS com tmux.

Existem dois agentes baseados em terminal que você deve conhecer. O Aider é a opção nativa de terminal e focada em git: ele faz o auto-commit de cada alteração com uma mensagem adequada, mantendo seu histórico limpo e cada edição reversível. É um dos agentes de codificação via terminal mais antigos, embora seu ritmo de lançamento tenha diminuído. O Goose, da Block, é mais amplo: um agente Apache-2.0 com um grande ecossistema de extensões e suporte para muitos provedores, incluindo modelos locais via Ollama, agora desenvolvido sob a Agentic AI Foundation (AAIF) da Linux Foundation. O Aider é ideal para um fluxo de trabalho disciplinado e centrado em git; o Goose é ideal para um assistente mais geral com um conjunto amplo de plugins.

O que você precisa

Você precisa de um VPS com git, tmux e um Python recente para o Aider, ou o instalador do Goose para o Goose. Você também precisa de um modelo: uma chave de API hospedada de um provedor como Anthropic ou OpenAI, ou um modelo local servido pelo Ollama no mesmo VPS. A rota self-hosted mantém seu código no seu próprio servidor e não tem custo por token, ao custo de precisar de memória suficiente para um modelo capaz.

Instalar e rodar o Aider

Instale o Aider em um ambiente isolado com pipx, que vem do apt, pois o Ubuntu 24.04 bloqueia pip install puro fora de um ambiente virtual (PEP 668). Em seguida, execute o Aider dentro do seu projeto, em uma sessão tmux para que ele sobreviva a uma desconexão:

sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aider

Uma nota de versão: esta instalação funciona conforme mostrado no Ubuntu 24.04. No Ubuntu 26.04, ela falha atualmente porque as dependências fixas do Aider incluem um numpy antigo que não compila com o Python 3.14 do 26.04. A solução é fornecer ao Aider seu próprio Python 3.12:

pipx install --python 3.12 --fetch-missing-python aider-chat

O pipx baixa um interpretador standalone apenas para o Aider e a instalação é concluída. Este é um sintoma do ritmo de lançamento lento do Aider; se isso for um problema, o Goose é a opção com manutenção mais ativa.

Assim que estiver rodando, desconecte da sessão com Ctrl-b e depois d e o agente continuará trabalhando com seu laptop fechado; reconecte mais tarde com tmux attach -t aider para ler o que ele alterou. O Aider lê seu repositório, propõe edições, as aplica e faz o commit de cada uma; ele pode puxar arquivos extras para contexto quando uma alteração abrange vários arquivos. Como cada alteração é um commit, desfazer as ações do agente é um simples git revert, que é a rede de segurança que torna o uso confortável. O Goose é instalado com seu script de uma linha documentado e roda de forma semelhante pelo terminal, executando tarefas através de suas extensões:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Modelo hospedado ou modelo self-hosted

Um modelo hospedado oferece a melhor qualidade e não exige hardware local, mas custa dinheiro por token e seu código é enviado ao provedor. Custos por token acumulam mais rápido do que a maioria das pessoas espera, porque o agente reenvia toda a conversa em cada turno. O detalhamento do Claude Code sobre quanto uma sessão longa de agente realmente gasta em tokens também se aplica aqui, já que o Aider e o Goose cobram da mesma forma. Um modelo self-hosted via Ollama mantém tudo no seu servidor e é gratuito para rodar após o hardware estar pago, mas um modelo de codificação bom o suficiente para ser útil exige memória real. Esse é o equilíbrio a ser avaliado: qualidade e conveniência contra privacidade e custo.

Se você optar pelo self-hosted, a questão prática é qual modelo cabe no seu servidor. Verifique o tamanho antes de baixar um modelo de oito gigabytes em uma máquina que não consegue contê-lo:

Segurança: ele edita arquivos e executa comandos

Um agente de codificação não é passivo. Ele reescreve arquivos e pode executar comandos de build e teste, portanto, dê a ele o mesmo cuidado que você daria a qualquer processo que possa alterar seu sistema. Três hábitos cobrem a maior parte do risco. Trabalhe dentro de um repositório git, para que cada alteração seja rastreada e reversível, o que o Aider faz automaticamente para você. Execute o agente como seu usuário comum sem privilégios, nunca como root, seguindo o princípio de least-privilege users, para que um comando mal executado não afete o sistema inteiro. E mantenha o servidor endurecido (hardened), pois um VPS de codificação ainda é um servidor público: SSH apenas por chave, firewall com política de default-deny e o restante. O OpenClaw hardening guide adota a mesma postura para um agente mais autônomo, e os princípios se aplicam.

Para integrar um agente de codificação ao seu próprio fluxo de trabalho, building an AI agent with Claude mostra como um modelo comanda suas ferramentas; running Google's Gemini CLI on a VPS é outra opção de terminal, e self-hosting OpenHands é a rota autônoma mais pesada. O projeto open source mais estrelado neste espaço agora tem seu próprio guia: running OpenCode on a VPS configura o ambiente com o mesmo padrão de tmux e usuário sem privilégios.

FAQ

Posso rodar um agente de codificação com um modelo local em vez de uma API paga?

Sim. Tanto o Aider quanto o Goose funcionam com modelos locais servidos pelo Ollama, então você pode rodar um agente de codificação totalmente self-hosted, sem custo por token e sem que o código saia do seu servidor. O problema é a memória: um modelo capaz o suficiente para escrever código útil precisa de uma boa quantidade de RAM ou VRAM, então dimensione a máquina para o modelo antes de se comprometer.

Aider ou Goose, qual devo usar?

Escolha o Aider se seu fluxo de trabalho for centrado em terminal e git e você quiser a opção mais madura e com menor overhead; ele faz o auto-commit de cada alteração para que seu histórico permaneça reversível. Escolha o Goose se você quiser um assistente mais amplo com um grande ecossistema de extensões e suporte para muitos provedores. Ambos rodam pelo terminal e ambos funcionam com Ollama, então qualquer um serve para um VPS.

Quanta memória eu preciso para um modelo de codificação self-hosted?

Depende do tamanho do modelo e de quanto ele foi quantizado. Um modelo pequeno quantizado pode rodar com alguns gigabytes, enquanto um modelo mais forte exige muito mais, e janelas de contexto longas aumentam esse requisito. Use a ferramenta de dimensionamento acima para estimar a memória que um determinado modelo e comprimento de contexto precisam antes de baixá-lo.

É seguro deixar um agente de IA editar meu código e executar comandos?

É gerenciável com os hábitos corretos. Mantenha seu trabalho em um repositório git para que cada edição seja um commit reversível, execute o agente como um usuário sem privilégios em vez de root, e endureça o VPS como você faria com qualquer servidor público. Revise as alterações que ele commita em vez de confiar cegamente, especialmente qualquer comando que ele queira executar em seu sistema.