Coding agent draaien op een VPS: handleiding

Waarom een coding agent op een VPS draaien

Een coding agent is een tool die uw codebase leest, wijzigingen doorvoert en commando's uitvoert om deze te testen, alles vanuit de terminal. Het draaien hiervan op een VPS biedt drie voordelen ten opzichte van uw laptop: het blijft werken nadat u de verbinding verbreekt, het bevindt zich direct naast uw code en build-tools, en het kan communiceren met een model dat u zelf host. Start de agent binnen een tmux-sessie en u kunt uw laptop afsluiten en het werk later hervatten, volgens hetzelfde patroon als het draaien van Claude Code op een VPS met tmux.

Twee terminal-gebaseerde agents zijn het vermelden waard. Aider is de terminal-native, git-first optie: het voert automatisch een commit uit voor elke wijziging met een begrijpelijk bericht, zodat uw geschiedenis overzichtelijk blijft en elke bewerking terugdraaibaar is. Het is een van de meest gevestigde terminal coding agents, hoewel het tempo van de releases is vertraagd. Goose, van Block, is breder: een Apache-2.0 agent met een groot ecosysteem aan extensies en ondersteuning voor vele providers, inclusief lokale Ollama-modellen, die nu wordt ontwikkeld onder de Agentic AI Foundation (AAIF) van de Linux Foundation. Aider is geschikt voor een gedisciplineerde, git-centrische workflow; Goose is geschikt als een algemenere assistent met een uitgebreide set plugins.

Wat u nodig heeft

U heeft een VPS nodig met git, tmux en een recente versie van Python voor Aider, of het Goose-installatieprogramma voor Goose. Daarnaast heeft u een model nodig: ofwel een gehoste API-sleutel van een aanbieder zoals Anthropic of OpenAI, of een lokaal model dat wordt aangeboden via Ollama op dezelfde VPS. De zelfgehoste route houdt uw code op uw eigen server en kost niets per token, met als voorwaarde dat u over voldoende geheugen beschikt voor een capabel model.

Aider installeren en uitvoeren

Installeer Aider in een geïsoleerde omgeving met pipx, dat via apt wordt geïnstalleerd omdat Ubuntu 24.04 standaard pip install buiten een virtuele omgeving blokkeert (PEP 668). Voer Aider vervolgens uit binnen uw project, in een tmux-sessie zodat het proces blijft draaien na een verbinding met de server:

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

Een opmerking over de versie: deze installatie werkt zoals getoond op Ubuntu 24.04. Op Ubuntu 26.04 mislukt dit momenteel, omdat de vastgezette dependencies van Aider een oudere versie van numpy bevatten die niet bouwt tegen de Python 3.14 van 26.04. De oplossing is om Aider een eigen Python 3.12 te geven:

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

pipx downloadt een zelfstandige interpreter specifiek voor Aider, waarna de installatie wordt voltooid. Dit is een symptoom van het vertraagde release-tempo van Aider; als dit voor u een probleem vormt, is Goose het actiever onderhouden alternatief.

Zodra het programma draait, koppelt u de sessie los met Ctrl-b gevolgd door d; de agent blijft doorwerken terwijl uw laptop is gesloten. Koppel later opnieuw met tmux attach -t aider om te zien welke wijzigingen zijn doorgevoerd. Niets belet u om een tweede tmux-venster open te houden voor een andere agent, en als beide Claude Code zijn, kunnen de twee sessies werk onderling uitwisselen in plaats van dat u dit handmatig moet doorgeven. Aider leest uw repository, stelt wijzigingen voor, past deze toe en voert voor elke wijziging een commit uit. Het kan extra bestanden inlezen voor context wanneer een wijziging meerdere bestanden beslaat. Omdat elke wijziging een commit is, is het ongedaan maken van een actie van de agent een eenvoudige git revert; dit is het vangnet dat het gebruik comfortabel maakt. Goose installeert met het gedocumenteerde script van één regel en draait op vergelijkbare wijze vanuit de terminal, waarbij taken worden aangestuurd via extensies:

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

Hosted model of self-hosted model

Een hosted model biedt de hoogste kwaliteit en vereist geen lokale hardware, maar brengt kosten per token met zich mee en uw code wordt naar de aanbieder verzonden. De kosten per token lopen sneller op dan de meeste mensen verwachten, omdat de agent bij elke stap het volledige gesprek opnieuw verstuurt. De analyse van Claude Code over wat een lange agentsessie werkelijk aan tokens verbruikt is hier ook van toepassing, aangezien Aider en Goose op dezelfde manier factureren. Een self-hosted model via Ollama houdt alles op uw eigen server en is gratis in gebruik zodra de hardware is aangeschaft, maar een programmeermodel dat krachtig genoeg is om nuttig te zijn, vereist aanzienlijk geheugen. Dat is de afweging die u moet maken: kwaliteit en gemak versus privacy en kosten.

Als u kiest voor self-hosted, is de praktische vraag welk model geschikt is voor uw server. Let hierbij op het contextvenster, aangezien Ollama standaard een kleine waarde gebruikt en alles wat langer is stilzwijgend afkapt. Voor een programmeer-agent betekent dit dat de bestanden die zojuist zijn gelezen uit de prompt verdwijnen: het verhogen van num_ctx lost dit op, en de grotere KV-cache die hiervoor nodig is, maakt deel uit van het geheugen dat u moet inplannen. Bepaal de grootte voordat u een model van acht gigabyte downloadt naar een systeem dat dit niet kan verwerken:

Veiligheid: het bewerken van bestanden en uitvoeren van commando's

Een coding agent is niet passief. Deze herschrijft bestanden en kan build- en testcommando's uitvoeren. Behandel de agent daarom met dezelfde zorg als elk ander proces dat uw systeem kan wijzigen. Drie gewoontes dekken het grootste deel van het risico af. Werk binnen een git-repository, zodat elke wijziging wordt bijgehouden en teruggedraaid kan worden; Aider doet dit automatisch voor u. Voer de agent uit als uw gewone gebruiker zonder privileges, nooit als root, conform gebruikers met minimale rechten, zodat een foutief commando niet het hele systeem kan aantasten. Zorg er daarnaast voor dat de machine zelf beveiligd is, aangezien een coding VPS nog steeds een publieke server is: gebruik alleen SSH-keys, een default-deny firewall, enzovoort. De OpenClaw hardening-handleiding hanteert hetzelfde standpunt voor een meer autonome agent, en de principes zijn universeel toepasbaar.

Om een coding agent te integreren in uw eigen workflow, laat een AI-agent bouwen met Claude zien hoe één model uw tools aanstuurt; Google's Gemini CLI draaien op een VPS is een andere optie voor de terminal, en OpenHands zelf hosten is de zwaardere, autonome route. Het meest populaire open-sourceproject in dit domein heeft inmiddels een eigen handleiding: OpenCode draaien op een VPS zet dit op volgens hetzelfde patroon met tmux en een gebruiker zonder privileges.

FAQ

Kan ik een coding agent draaien met een lokaal model in plaats van een betaalde API?

Ja. Zowel Aider als Goose werken met lokale modellen die via Ollama worden aangeboden. U kunt een coding agent dus volledig zelf hosten zonder kosten per token en zonder dat er code uw server verlaat. Het addertje onder het gras is het geheugen: een model dat krachtig genoeg is om bruikbare code te schrijven, vereist een aanzienlijke hoeveelheid RAM of VRAM. Stem de machine daarom af op het model voordat u begint.

Aider of Goose, welke moet ik gebruiken?

Kies Aider als uw workflow gericht is op de terminal en git, en u de meest volwassen optie met de minste overhead wilt; het voert automatisch een commit uit voor elke wijziging, zodat uw geschiedenis omkeerbaar blijft. Kies Goose als u een bredere assistent wilt met een groot ecosysteem aan extensies en ondersteuning voor veel providers. Beide draaien vanuit de terminal en beide werken met Ollama, dus beide zijn geschikt voor een VPS.

Hoeveel geheugen heb ik nodig voor een zelf-gehost coding model?

Dit hangt af van de grootte van het model en de mate van kwantisatie. Een klein gekwantiseerd model kan draaien op enkele gigabytes, terwijl een sterker model veel meer vereist, en lange contextvensters verhogen het verbruik verder. Gebruik de bovenstaande dimensioneringstool om het benodigde geheugen voor een specifiek model en een specifieke contextlengte in te schatten voordat u het downloadt.

Is het veilig om een AI-agent mijn code te laten bewerken en commando's te laten uitvoeren?

Dit is beheersbaar met de juiste gewoonten. Houd uw werk in een git-repository zodat elke bewerking een omkeerbare commit is, voer de agent uit als een gebruiker zonder bevoorrechte rechten in plaats van als root, en beveilig de VPS zoals u dat bij elke publieke server zou doen. Controleer de wijzigingen die de agent doorvoert in plaats van deze blindelings te vertrouwen, zeker bij commando's die de agent op uw systeem wil uitvoeren.