Come eseguire un agente di coding su un VPS

Perché eseguire un agente di coding su un VPS

Un agente di coding è uno strumento che legge la codebase, applica modifiche ed esegue comandi per testarle, tutto dal terminale. Eseguirlo su un VPS offre tre vantaggi rispetto al laptop: continua a lavorare dopo la disconnessione, si trova accanto al codice e agli strumenti di build e può comunicare con un modello ospitato autonomamente. Avvialo all'interno di una sessione tmux: puoi chiudere il laptop e riprendere il lavoro in seguito, seguendo lo stesso approccio descritto in eseguire Claude Code su un VPS con tmux.

Vale la pena conoscere due agenti basati sul terminale. Aider è l'opzione nativa per il terminale e orientata a git: esegue automaticamente il commit di ogni modifica con un messaggio appropriato, mantenendo pulita la cronologia e rendendo reversibile ogni modifica. È uno degli agenti di coding per terminale più affermati, anche se il ritmo delle release è rallentato. Goose, sviluppato da Block, è più generale: è un agente con licenza Apache-2.0, dotato di un ampio ecosistema di estensioni e compatibile con molti provider, inclusi i modelli locali di Ollama; ora è sviluppato nell'ambito della Agentic AI Foundation (AAIF) della Linux Foundation. Aider è adatto a un flusso di lavoro disciplinato e incentrato su git; Goose è più indicato come assistente generale con un'ampia raccolta di plugin.

Cosa serve

Ti serve un VPS con git, tmux e una versione recente di Python per Aider, oppure l'installer di Goose per Goose. Ti serve anche un modello: una chiave API per un servizio hosted di provider come Anthropic o OpenAI, oppure un modello locale fornito da Ollama sullo stesso VPS. La soluzione self-hosted mantiene il codice sul tuo server e non comporta costi per token, ma richiede memoria sufficiente per eseguire un modello adeguato.

Installare ed eseguire Aider

Installare Aider in un ambiente isolato con pipx, disponibile tramite apt, perché Ubuntu 24.04 blocca l’uso diretto di pip install al di fuori di un ambiente virtuale (PEP 668). Eseguire quindi Aider all’interno del progetto, in una sessione tmux che resta attiva anche dopo una disconnessione:

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

Una nota sulla versione: questa procedura funziona come mostrato su Ubuntu 24.04. Su Ubuntu 26.04 attualmente non funziona, perché le dipendenze bloccate di Aider includono una versione precedente di numpy che non viene compilata con Python 3.14 di Ubuntu 26.04. La soluzione consiste nell’assegnare ad Aider il proprio Python 3.12:

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

pipx scarica un interprete autonomo dedicato ad Aider e l’installazione viene completata. Questo è un effetto del ritmo di rilascio più lento di Aider; se il problema è rilevante, Goose è la scelta con manutenzione più attiva.

Dopo l’avvio, scollegarsi dalla sessione con Ctrl-b e poi d: l’agente continua a lavorare anche con il laptop chiuso. In seguito, ricollegarsi con tmux attach -t aider per leggere le modifiche applicate. È possibile mantenere aperta una seconda finestra tmux per un altro agente. Se entrambi sono Claude Code, le due sessioni possono passarsi il lavoro senza che sia necessario inoltrarlo manualmente. Aider legge il repository, propone e applica le modifiche ed esegue un commit per ciascuna di esse. Può inoltre includere file aggiuntivi come contesto quando una modifica interessa più file. Poiché ogni modifica corrisponde a un commit, annullare il lavoro dell’agente richiede semplicemente git revert. Questo meccanismo offre una rete di sicurezza che rende l’uso dello strumento più agevole. Goose si installa con lo script a riga singola documentato ed esegue attività in modo analogo dal terminale, utilizzando le proprie estensioni:

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

Modello in hosting o modello self-hosted

Un modello in hosting offre la qualità migliore e non richiede hardware locale, ma ha un costo per token e il codice viene inviato al provider. I costi per token aumentano più rapidamente di quanto ci si aspetti, perché l’agent invia nuovamente l’intera conversazione a ogni turno. L’analisi di Claude Code su quanto consuma davvero in token una sessione lunga dell’agent si applica anche in questo caso, perché Aider e Goose usano lo stesso modello di fatturazione. Un modello self-hosted tramite Ollama mantiene tutti i dati sul server ed è gratuito da eseguire dopo aver acquistato l’hardware, ma un modello per il coding abbastanza valido da essere utile richiede una quantità significativa di memoria. Questo è il compromesso da valutare: qualità e praticità da una parte, privacy e costi dall’altra.

Se scegli il self-hosting, la domanda pratica è quale modello sia adatto al tuo server. Controlla anche la context window, perché Ollama ne usa una ridotta per impostazione predefinita e tronca senza avviso tutto ciò che la supera. Per un coding agent, questo significa che i file appena letti scompaiono dal prompt: aumentare num_ctx risolve il problema, ma la cache KV più grande necessaria al modello deve essere inclusa nella memoria da allocare. Verifica le dimensioni prima di scaricare un modello da otto gigabyte su un sistema che non è in grado di contenerlo:

Sicurezza: modifica file ed esegue comandi

Un agente di coding non è passivo. Riscrive file e può eseguire comandi di compilazione e test, quindi va gestito con la stessa attenzione riservata a qualsiasi processo in grado di modificare il sistema. Tre abitudini coprono la maggior parte dei rischi. Lavora all'interno di un repository git, in modo che ogni modifica venga tracciata e possa essere annullata; Aider lo fa automaticamente. Esegui l'agente come normale utente senza privilegi, mai come root, seguendo il principio del minimo privilegio, così un comando errato non può modificare l'intero sistema. Mantieni inoltre il server adeguatamente protetto, perché un VPS usato per il coding è comunque un server pubblico: SSH con autenticazione esclusivamente tramite chiavi, firewall con criterio predefinito deny e le altre misure necessarie. La guida all'hardening di OpenClaw adotta lo stesso approccio per un agente più autonomo, e questi principi sono applicabili anche ad altri strumenti.

Per integrare un agente di coding nel tuo workflow, creare un agente AI con Claude mostra come un modello possa controllare i tuoi strumenti; eseguire la CLI Gemini di Google su un VPS offre un'altra opzione da terminale, mentre self-hosting di OpenHands è la soluzione autonoma più completa. Il progetto open più apprezzato in questo ambito ha ora una guida dedicata: eseguire OpenCode su un VPS lo configura usando lo stesso approccio basato su tmux e su un utente senza privilegi.

FAQ

Posso usare un agente di coding con un modello locale invece di un'API a pagamento?

Sì. Sia Aider sia Goose funzionano con modelli locali forniti da Ollama, quindi puoi eseguire un agente di coding completamente self-hosted, senza costi per token e senza che il codice lasci il server. Il limite principale è la memoria: un modello abbastanza capace da scrivere codice utile richiede una quantità significativa di RAM o VRAM. Prima di procedere, dimensiona la macchina in base al modello.

Devo usare Aider o Goose?

Scegli Aider se il tuo flusso di lavoro è incentrato sul terminale e su git e vuoi l'opzione più matura e con il minore overhead; esegue automaticamente il commit di ogni modifica, così la cronologia resta reversibile. Scegli Goose se vuoi un assistente più completo, con un ampio ecosistema di estensioni e il supporto per molti provider. Entrambi funzionano dal terminale e con Ollama, quindi sono adatti a un VPS.

Quanta memoria serve per un modello di coding self-hosted?

Dipende dalle dimensioni del modello e dal livello di quantizzazione. Un modello quantizzato di piccole dimensioni può funzionare con pochi gigabyte, mentre un modello più potente richiede molta più memoria. Anche finestre di contesto lunghe aumentano il fabbisogno. Usa lo strumento di dimensionamento precedente per stimare la memoria necessaria per un determinato modello e una determinata lunghezza del contesto prima di scaricarlo.

È sicuro consentire a un agente di IA di modificare il codice ed eseguire comandi?

È una pratica gestibile se adotti le procedure corrette. Conserva il lavoro in un repository git, così ogni modifica viene registrata in un commit reversibile; esegui l'agente con un utente non privilegiato anziché con root e metti in sicurezza il VPS come faresti con qualsiasi server pubblico. Esamina le modifiche registrate nei commit invece di accettarle senza verifica, soprattutto i comandi che l'agente vuole eseguire sul sistema.