Claude Code op een VPS draaien

Claude Code op een server draaien in plaats van op je laptop levert je drie dingen op. Het werkt door als je laptop dicht is. Het overleeft een weggevallen verbinding. En het zet de agent op een machine die je kunt weggooien, niet op die met je SSH-sleutels en browserprofiel. Deze gids behandelt een opzet die op een verse Debian- of Ubuntu-machine ongeveer een kwartier kost. Dezelfde stappen werken met kleine aanpassingen op Alpine en Fedora.

Je hebt een Claude-abonnement nodig waarin Claude Code zit: Pro, Max, Team of Enterprise, of een Console-account. Het gratis claude.ai-abonnement bevat het niet. Log in met je abonnement, dan hoef je geen API-sleutel te beheren en wordt er geen gebruik bovenop gefactureerd.

1. Kies een machine

De systeemvereisten van Anthropic noemen 4 GB RAM of meer en een x64- of ARM64-processor. De ondersteunde Linux-systemen zijn Ubuntu 20.04+, Debian 10+ en Alpine 3.19+. In de praktijk bepaalt de toolchain van je project meer dan de CLI:

• 4 GB: het gedocumenteerde minimum, prima voor één sessie op een bescheiden project.
• 8 GB: als je iets substantieels bouwt (een bundler, een testsuite, een container of twee) of meerdere sessies tegelijk draait.
• 16 GB: als je meerdere agents parallel draait, of een database ernaast.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr en andere werken allemaal, en een oude machine onder je bureau ook. Kies een regio bij jou in de buurt als je er ooit in een terminal op typt. ARM-instanties zijn meestal het goedkoopst per gigabyte, en Claude Code draait er native op. Onze gids over de beste VPS voor coding agents vergelijkt providers en groottes.

2. Maak een gebruiker zonder root aan

Veel VPS-images loggen je in als root. Draai de agent niet als root. Dat maakt van elke fout een fout voor het hele systeem. Claude Code weigert bovendien als root in bypass-permissions-modus te starten, dus een gewone gebruiker heb je uiteindelijk toch nodig. Op Debian of Ubuntu:

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

Op Fedora heet de beheerdersgroep wheel in plaats van sudo. Op Alpine installeer je eerst sudo of doas. De laatste regel kopieert de sleutel waarmee je al bent ingelogd, zodat je als dev opnieuw kunt verbinden voordat je iets dichtzet. Test het vanuit een tweede terminal voordat je de eerste sluit. Jezelf buitensluiten van een verse VPS is een ontgroening die je kunt overslaan.

3. SSH-sleutels en hardening

Log je nog in met een wachtwoord, stap dan eerst over op een sleutel. Genereer er een op je computer met ssh-keygen -t ed25519 en kopieer hem daarna met ssh-copy-id dev@your-server. Zodra inloggen met de sleutel werkt, bewerk je /etc/ssh/sshd_config:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Herstart daarna SSH: sudo systemctl restart ssh op Debian en Ubuntu. Op Fedora heet de service sshd, dus daar voer je sudo systemctl restart sshd uit. Voor meer bescherming voeg je fail2ban toe en een firewall die alleen SSH toelaat. Hoeft de machine helemaal niet op het publieke internet, zet hem dan in een Tailscale-netwerk. Je telefoon sluit zich aan bij hetzelfde netwerk en bereikt hem direct.

Vanaf een telefoon: SSH-apps kunnen op het toestel een sleutel genereren en je de publieke helft tonen om in ~/.ssh/authorized_keys te plakken. Maude doet dit voor je: de knop “Stel inloggen met sleutel in” maakt een sleutel aan via de verbinding waarmee je al bent ingelogd. Hij installeert de publieke helft, test de nieuwe sleutel, en bewaart de privéhelft alleen in de sleutelhanger van de telefoon.

4. Installeer Claude Code

Anthropic raadt nu de native installer aan, die geen Node.js nodig heeft. Voer hem uit als je gewone gebruiker, niet met sudo:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Hij zet de launcher in ~/.local/bin/claude en werkt zichzelf op de achtergrond bij. claude doctor controleert de installatie en je instellingen zonder een sessie te starten. Enkele alternatieven, allemaal uit de installatiedocumentatie:

• Ondertekende repositories voor apt, dnf en apk als je liever de pakketbeheerder van het systeem de baas laat zijn. Die werken zichzelf niet bij; je upgradet samen met de rest van het systeem.
• npm werkt nog steeds (npm install -g @anthropic-ai/claude-code, Node.js 22 of nieuwer). Het installeert dezelfde native binary. Anthropic raadt sudo npm install -g af.
• Alpine heeft bash, curl, libgcc, libstdc++ en ripgrep nodig, plus USE_BUILTIN_RIPGREP=0 in je instellingen.

Zei een oudere gids dat je eerst Node moest installeren, dan kun je die stap nu overslaan.

5. Inloggen zonder browser

Voer claude (of claude auth login) uit en volg de aanwijzingen. Een VPS heeft geen browser, dus je opent de inlog-URL op een ander apparaat. Met c kopieert Claude Code hem voor je. Log daar in. Als de browser de lokale callback van Claude Code niet kan bereiken, wat via SSH normaal is, toont hij in plaats daarvan een code. Plak die bij de regel Paste code here if prompted en de login wordt op de server afgerond.

Het inloggegeven wordt opgeslagen in ~/.claude/.credentials.json met modus 0600. Behandel de machine daarnaar: iedereen met een shell als die gebruiker kan je Claude-abonnement gebruiken. Voor scripts en CI is er ook claude setup-token, dat een token van een jaar print dat je instelt als CLAUDE_CODE_OAUTH_TOKEN. Volgens de authenticatiedocumentatie kan dat token alleen modelverzoeken doen en geen Remote Control-sessies starten.

6. Houd het in leven

Alles wat je op de voorgrond van een SSH-sessie start, sterft met die verbinding. De gebruikelijke oplossing is tmux:

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Je kunt loskoppelen, je bereik verliezen, uren later opnieuw verbinden en weer koppelen, en de sessie is onaangeroerd. tmux overleeft echter geen herstart. Daarna pakt claude --continue het meest recente gesprek in die map op. Onze gids over Claude Code laten draaien nadat je je laptop dichtklapt behandelt de andere opties, waaronder systemd en sessiedaemons.

7. Zelfde machine, meer agents

Een server die Claude Code draait, kan de andere coding agents ernaast draaien. Elk installeert zich in je thuismap en houdt een eigen login, dus ze zitten elkaar niet in de weg. Laat RAM vrij voor elke agent die tegelijk draait.

Bronnen: Codex-authenticatie, OpenCode-documentatie, Grok Build-documentatie, installatie van Antigravity CLI, gecontroleerd in oktober 2026. Codex en Antigravity hebben hun eigen uitleg: Codex CLI op een VPS en Antigravity CLI op een server. Gemini CLI is geen optie meer voor persoonlijke Google-accounts, en Antigravity CLI is de opvolger van Google.

8. Bereik het vanaf je telefoon

Er zijn drie manieren, van het meeste handwerk tot het minste:

Een SSH-app en tmux. Termius, Blink of een andere client, gekoppeld aan je tmux-sessie. Het is gratis en volledig, en je bedient een terminal op volledig scherm met een schermtoetsenbord. Zo verhoudt dat zich.

Remote Control. Start claude remote-control binnen tmux en open de sessie vanuit de tab Code van de Claude-app. Het zit bij Pro, Max, Team en Enterprise. De documentatie van Anthropic raadt tmux of screen aan voor precies dit geval. Het werkt alleen voor Claude, en de toestemmingsverzoeken van de sessie komen op je telefoon binnen om te beantwoorden. De app kan de sessie niet naar Auto of Bypass permissions zetten.

Maude. Maude doet stap 4 en 6 voor je, en stap 5 verhuist naar je telefoon. Je voegt de server toe via het adres, door een ssh …-commando te plakken of door een QR-code te scannen van curl -fsSL https://maude.pilotdev.fr/setup | sh. Ben je als root ingelogd, dan maakt een knop de gebruiker zonder root uit stap 2 voor je aan. Maude zet dan via SSH zijn eigen daemon neer en installeert elke agent in een versie die wij hebben getest en gepind. Je logt in bij Claude, Codex of een van de andere vanaf de telefoon. Sessies blijven op de server draaien als de app gesloten is, en de server belt zelf uit naar de relay van Maude, dus het werkt achter NAT zonder open poort.

9. Beslis over toestemmingen

Nu de interessante vraag: hoeveel laat je hem zonder toezicht doen? Een server die je kunt herbouwen, is de juiste plek om toestemmingen te versoepelen, zolang je hem echt als wegwerpmachine hebt behandeld. De auto-modus van Claude Code, waarin een classifier veilige acties goedkeurt, dekt al veel van het gat. Volledige bypass heeft zijn eigen regels, waaronder de rootbeperking uit stap 2. Die hebben een eigen pagina: Claude Code veilig met volledige toestemmingen draaien.

Draai het vanaf je telefoon

Staat de server, dan legt Claude Code op je telefoon uit hoe Maude hem aanstuurt. Is Claude niet je enige agent, begin dan bij het overzicht van agents.

Veelgestelde vragen

Wat is er veranderd

• 1 oktober 2026 — Installatie omgezet naar de native installer van Anthropic (Node.js niet meer nodig); RAM-advies afgestemd op het gedocumenteerde minimum van 4 GB; headless inloggen met een geplakte code en setup-token toegevoegd; nieuwe sectie over Codex, OpenCode, Grok Build en Antigravity op dezelfde machine.
• 25 juli 2026 — Eerste publicatie.