How to run Claude Code or Codex CLI on a VPSWie man Claude Code oder Codex CLI auf einem VPS betreibt

Why run a coding agent on a VPS?Warum einen Coding-Agenten auf einem VPS betreiben?

• Long tasks keep running after you close the SSH window.Lange Aufgaben laufen weiter, nachdem Sie das SSH-Fenster schließen.
• The agent only sees the repositories you clone onto the server, not your home directory, browser profile or password manager.Der Agent sieht nur die Repositories, die Sie auf den Server klonen, nicht Ihr Home-Verzeichnis, Browserprofil oder Ihren Passwortmanager.
• Builds and test runs use the server CPU and RAM instead of your laptop battery.Builds und Testläufe nutzen CPU und RAM des Servers statt Ihres Laptop-Akkus.

How much VPS do you need?Wie viel VPS brauchen Sie?

The agent itself is a light Node.js process; the model runs at the provider. What needs resources is your project: dependency installs, compilers, test suites and containers. Size the server for your build, not for the agent, and add swap on small plans.Der Agent selbst ist ein leichter Node.js-Prozess; das Modell läuft beim Anbieter. Ressourcen braucht Ihr Projekt: Abhängigkeitsinstallationen, Compiler, Testsuiten und Container. Dimensionieren Sie den Server für Ihren Build, nicht für den Agenten, und richten Sie auf kleinen Plänen Swap ein.

Step 1, Prepare the serverSchritt 1, Server vorbereiten

1. Connect through SSH with a key, create a non-root user and work as that user. Never run an agent as root.Verbinden Sie sich per SSH mit Schlüssel, legen Sie einen Benutzer ohne Root-Rechte an und arbeiten Sie als dieser Benutzer. Lassen Sie einen Agenten nie als root laufen.
2. Update the system withAktualisieren Sie das System mit sudo apt update && sudo apt upgrade.
3. InstallInstallieren Sie git, tmux and a current LTS release of Node.js. Check each tool's documentation for its minimum Node version.und eine aktuelle LTS-Version von Node.js. Prüfen Sie in der Dokumentation des jeweiligen Tools die Mindestversion von Node.

Step 2, Install the agentSchritt 2, Agenten installieren

• Claude Code: npm install -g @anthropic-ai/claude-code, then start it withdann starten Sie es mit claude inside your project folder.in Ihrem Projektordner.
• Codex CLI: npm install -g @openai/codex, then start it withdann starten Sie es mit codex inside your project folder.in Ihrem Projektordner.

Both tools can sign in with a paid subscription or use an API key. On a headless server the login flow prints a link you open on another device; follow the prompt in the terminal. If you use an API key, keep it in an environment file readable only by your user, never in the repository.Beide Tools können sich mit einem bezahlten Abo anmelden oder einen API-Schlüssel nutzen. Auf einem Server ohne Bildschirm zeigt der Login einen Link, den Sie auf einem anderen Gerät öffnen; folge der Anweisung im Terminal. Nutzen Sie einen API-Schlüssel, leg ihn in eine Umgebungsdatei, die nur Ihr Benutzer lesen kann, nie ins Repository.

Step 3, Keep sessions alive with tmuxSchritt 3, Sitzungen mit tmux am Leben halten

An interactive agent needs a terminal, so a systemd service is the wrong tool here. Start a named session withEin interaktiver Agent braucht ein Terminal, deshalb ist ein systemd-Dienst hier das falsche Werkzeug. Starten Sie eine benannte Sitzung mit tmux new -s agent, run the agent inside it, detach with, starten Sie den Agenten darin, trennen Sie sich mit Ctrl-b dand come back later with und komm später zurück mit tmux attach -t agent. A tmux session survives a dropped SSH connection but not a server reboot, so commit work often.. Eine tmux-Sitzung übersteht eine abgebrochene SSH-Verbindung, aber keinen Server-Neustart, also committe oft.

Step 4, Stay safeSchritt 4, Sicher bleiben

• Give the agent a deploy key or fine-grained token scoped to the repositories it works on, not your main account credentials.Geben Sie dem Agenten einen Deploy-Key oder ein fein eingeschränktes Token nur für die Repositories, an denen er arbeitet, nicht Ihre Haupt-Zugangsdaten.
• Keep the default permission prompts on until you trust the workflow, and review diffs before you push.Lassen Sie die Standard-Berechtigungsabfragen an, bis Sie dem Ablauf vertrauen, und prüfen Sie Diffs vor dem Push.
• Only allow SSH with keys and keep the system updated.Erlauben Sie SSH nur mit Schlüsseln und halten Sie das System aktuell.

Step 5, Know your plan limitsSchritt 5, Abo-Limits kennen

Subscription plans cap how much agent work you get per time window, and the providers change these limits often. Before you plan a long unattended session, check the current numbers in ourAbos begrenzen, wie viel Agentenarbeit Sie pro Zeitfenster bekommen, und die Anbieter ändern diese Limits oft. Bevor Sie eine lange unbeaufsichtigte Sitzung planen, prüfen Sie die aktuellen Werte in unserem AI Plan Limits TrackerKI-Abo-Limits-Tracker , which quotes the providers' own help pages and is re-checked every hour., der die Hilfeseiten der Anbieter wörtlich zitiert und stündlich neu geprüft wird.