Claude Code auf einem VPS betreiben

Claude Code auf einem Server statt auf deinem Laptop zu betreiben, bringt dir drei Dinge. Es arbeitet weiter, wenn dein Laptop zu ist. Es übersteht eine abgebrochene Verbindung. Und es setzt den Agenten auf einen Rechner, den du wegwerfen kannst, nicht auf den mit deinen SSH-Schlüsseln und deinem Browser-Profil. Diese Anleitung beschreibt ein Setup, das auf einem frischen Debian- oder Ubuntu-Rechner etwa fünfzehn Minuten dauert. Dieselben Schritte funktionieren mit kleinen Änderungen auch unter Alpine und Fedora.

Du brauchst ein Claude-Abo, das Claude Code enthält: Pro, Max, Team oder Enterprise, oder ein Console-Konto. Der kostenlose claude.ai-Plan enthält es nicht. Meldest du dich mit deinem Abo an, musst du keinen API-Schlüssel verwalten, und es wird keine Nutzung zusätzlich berechnet.

1. Einen Rechner wählen

Anthropics Systemanforderungen nennen 4 GB RAM oder mehr und einen x64- oder ARM64-Prozessor. Unterstützte Linux-Systeme sind Ubuntu 20.04+, Debian 10+ und Alpine 3.19+. In der Praxis entscheidet die Toolchain deines Projekts mehr als die CLI:

• 4 GB: das dokumentierte Minimum, gut für eine Session an einem überschaubaren Projekt.
• 8 GB: wenn du etwas Nennenswertes baust (einen Bundler, eine Testsuite, einen oder zwei Container) oder mehrere Sessions gleichzeitig betreibst.
• 16 GB: wenn du mehrere Agenten parallel betreibst oder eine Datenbank daneben.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr und andere funktionieren alle, genauso wie ein alter Rechner unter deinem Schreibtisch. Wähle eine Region in deiner Nähe, falls du je in ein Terminal darauf tippst. ARM-Instanzen sind pro Gigabyte meist am günstigsten, und Claude Code läuft darauf nativ. Unser Guide zum besten VPS für Coding-Agenten vergleicht Anbieter und Größen.

2. Einen Nicht-root-Benutzer anlegen

Viele VPS-Images melden dich als root an. Lass den Agenten nicht als root laufen. Das macht aus jedem Fehler einen systemweiten. Claude Code weigert sich außerdem, als root im bypass-permissions-Modus zu starten, einen normalen Benutzer brauchst du also früher oder später sowieso. Unter Debian oder Ubuntu:

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

Unter Fedora heißt die Admin-Gruppe wheel statt sudo. Unter Alpine installierst du zuerst sudo oder doas. Die letzte Zeile kopiert den Schlüssel, mit dem du gerade angemeldet bist, damit du dich als dev neu verbinden kannst, bevor du irgendetwas abriegelst. Teste es aus einem zweiten Terminal, bevor du das erste schließt. Sich aus einem frischen VPS auszusperren ist ein Initiationsritus, den du dir sparen kannst.

3. SSH-Schlüssel und Härtung

Meldest du dich noch per Passwort an, stell zuerst auf einen Schlüssel um. Erzeuge einen auf deinem Computer mit ssh-keygen -t ed25519 und kopier ihn dann mit ssh-copy-id dev@your-server hoch. Sobald der Schlüssel-Login funktioniert, bearbeite /etc/ssh/sshd_config:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Starte dann SSH neu: sudo systemctl restart ssh unter Debian und Ubuntu. Unter Fedora heißt der Dienst sshd, dort also sudo systemctl restart sshd. Für mehr Schutz nimm fail2ban und eine Firewall dazu, die nur SSH erlaubt. Muss der Rechner gar nicht im öffentlichen Internet stehen, setz ihn in ein Tailscale-Netz. Dein Handy tritt demselben Netz bei und erreicht ihn direkt.

Vom Handy aus: SSH-Apps können auf dem Gerät einen Schlüssel erzeugen und dir die öffentliche Hälfte zum Einfügen in ~/.ssh/authorized_keys zeigen. Maude erledigt das für dich: Die Schaltfläche „Schlüssel-Anmeldung einrichten“ erzeugt einen Schlüssel über die Verbindung, mit der du schon angemeldet bist. Sie installiert die öffentliche Hälfte, testet den neuen Schlüssel und bewahrt die private Hälfte nur im Schlüsselbund des Handys auf.

4. Claude Code installieren

Anthropic empfiehlt inzwischen den nativen Installer, der kein Node.js braucht. Führ ihn als dein normaler Benutzer aus, nicht mit sudo:

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

Er legt den Starter nach ~/.local/bin/claude und aktualisiert sich im Hintergrund selbst. claude doctor prüft die Installation und deine Einstellungen, ohne eine Session zu starten. Ein paar Alternativen, alle aus der Setup-Doku:

• Signierte Repositories für apt, dnf und apk, wenn lieber der Paketmanager des Systems zuständig sein soll. Diese aktualisieren sich nicht selbst; du aktualisierst mit dem Rest des Systems.
• npm funktioniert weiterhin (npm install -g @anthropic-ai/claude-code, Node.js 22 oder neuer). Es installiert dasselbe native Binary. Anthropic rät von sudo npm install -g ab.
• Alpine braucht bash, curl, libgcc, libstdc++ und ripgrep, dazu USE_BUILTIN_RIPGREP=0 in deinen Einstellungen.

Hat dir eine ältere Anleitung gesagt, zuerst Node zu installieren, kannst du diesen Schritt jetzt überspringen.

5. Ohne Browser anmelden

Führ claude (oder claude auth login) aus und folge den Anweisungen. Ein VPS hat keinen Browser, du öffnest die Login-URL also auf einem anderen Gerät. Mit c kopiert Claude Code sie dir. Melde dich dort an. Kann der Browser den lokalen Callback von Claude Code nicht erreichen, was per SSH normal ist, zeigt er stattdessen einen Code. Füg ihn bei der Zeile Paste code here if prompted ein, und die Anmeldung wird auf dem Server abgeschlossen.

Die Zugangsdaten werden in ~/.claude/.credentials.json mit den Rechten 0600 gespeichert. Behandle den Rechner entsprechend: Jeder mit einer Shell als dieser Benutzer kann dein Claude-Abo nutzen. Für Skripte und CI gibt es außerdem claude setup-token, das ein ein Jahr gültiges Token ausgibt, das du als CLAUDE_CODE_OAUTH_TOKEN setzt. Laut Authentifizierungs-Doku kann dieses Token nur Modellanfragen stellen und keine Remote-Control-Sessions starten.

6. Am Leben halten

Alles, was du im Vordergrund einer SSH-Session startest, stirbt mit dieser Verbindung. Die übliche Lösung ist tmux:

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

Du kannst dich trennen, das Netz verlieren, Stunden später neu verbinden und wieder anhängen, und die Session ist unberührt. Einen Neustart übersteht tmux allerdings nicht. Danach holt claude --continue die jüngste Unterhaltung in diesem Verzeichnis zurück. Unsere Anleitung Claude Code weiterlaufen lassen, wenn der Laptop zu ist behandelt die anderen Optionen, einschließlich systemd und Session-Daemons.

7. Derselbe Rechner, mehr Agenten

Ein Server, der Claude Code betreibt, kann die anderen Coding-Agenten daneben betreiben. Jeder installiert sich in dein Home-Verzeichnis und behält seinen eigenen Login, sie kommen sich also nicht in die Quere. Lass im RAM Platz für jeden, der gleichzeitig läuft.

Quellen: Codex-Authentifizierung, OpenCode-Doku, Grok-Build-Doku, Installation von Antigravity CLI, geprüft im Oktober 2026. Für Codex und Antigravity gibt es eigene Anleitungen: Codex CLI auf einem VPS und Antigravity CLI auf einem Server. Gemini CLI ist für private Google-Konten keine Option mehr, und Antigravity CLI ist Googles Nachfolger.

8. Vom Handy aus erreichen

Es gibt drei Wege, vom aufwendigsten bis zum bequemsten:

Eine SSH-App und tmux. Termius, Blink oder ein anderer Client, verbunden mit deiner tmux-Session. Kostenlos und vollständig, und du bedienst ein Vollbild-Terminal mit einer Bildschirmtastatur. So schneidet das im Vergleich ab.

Remote Control. Starte claude remote-control in tmux und öffne die Session im Tab Code der Claude-App. Es ist in Pro, Max, Team und Enterprise enthalten. Anthropics Doku empfiehlt tmux oder screen für genau diesen Fall. Es funktioniert nur für Claude, und die Berechtigungsanfragen der Session kommen aufs Handy, wo du sie beantwortest. Auf Auto oder Bypass permissions kann die App die Session nicht umstellen.

Maude. Maude erledigt die Schritte 4 und 6 für dich, und Schritt 5 wandert aufs Handy. Du fügst den Server per Adresse hinzu, indem du einen ssh …-Befehl einfügst oder einen QR-Code aus curl -fsSL https://maude.pilotdev.fr/setup | sh scannst. Bist du als root angemeldet, legt eine Schaltfläche den Nicht-root-Benutzer aus Schritt 2 für dich an. Maude richtet dann per SSH seinen eigenen Daemon ein und installiert jeden Agenten in einer von uns getesteten und gepinnten Version. Du meldest dich vom Handy aus bei Claude, Codex oder einem der anderen an. Sessions laufen auf dem Server weiter, wenn die App geschlossen ist, und der Server baut selbst die Verbindung zu Maudes Relay auf, funktioniert also hinter NAT ohne offenen Port.

9. Über Berechtigungen entscheiden

Jetzt die spannende Frage: Wie viel lässt du ihn unbeaufsichtigt tun? Ein Server, den du neu aufsetzen kannst, ist der richtige Ort, um Berechtigungen zu lockern – sofern du ihn wirklich als Wegwerf-Rechner behandelt hast. Der Auto-Modus von Claude Code, in dem ein Klassifikator sichere Aktionen freigibt, schließt einen großen Teil der Lücke. Voller bypass hat eigene Regeln, einschließlich der root-Einschränkung aus Schritt 2. Dafür gibt es eine eigene Seite: Claude Code sicher mit vollen Berechtigungen betreiben.

Vom Handy aus betreiben

Steht der Server, erklärt Claude Code auf dem Handy, wie Maude es steuert. Ist Claude nicht dein einziger Agent, fang bei der Übersicht der Agenten an.

Häufige Fragen

Was sich geändert hat

• 1. Oktober 2026 — Installation auf Anthropics nativen Installer umgestellt (Node.js nicht mehr nötig); RAM-Empfehlung an das dokumentierte Minimum von 4 GB angepasst; Login ohne Browser mit eingefügtem Code und setup-token ergänzt; neuer Abschnitt dazu, Codex, OpenCode, Grok Build und Antigravity auf demselben Rechner zu betreiben.
• 25. Juli 2026 — Erstveröffentlichung.