Kann ich Claude Code auf einem Remote-Server ausführen?

Ja. Installiere es per npm auf dem Server, melde dich einmal an und starte es per SSH in tmux. Die Session läuft nach dem Trennen weiter, und du verbindest dich später von jedem Computer aus wieder.

Wie melde ich mich bei Claude Code auf einem Server ohne Browser an?

Führe claude auf dem Server aus und öffne den Login-Link auf deinem eigenen Computer. Erreicht der Browser den Server nicht, füge den angezeigten Code ins Terminal ein. Für unbeaufsichtigte Maschinen erzeugt claude setup-token ein langlebiges Token, das du als CLAUDE_CODE_OAUTH_TOKEN setzt.

Ist es sicher, einen Coding-Agenten auf einem VPS auszuführen?

Das kann es sein, wenn auf dem Server nur liegt, was der Agent braucht. Nutze einen separaten Benutzer, halte Produktions-Secrets fern, schließe nicht benötigte eingehende Ports und behandle Credential-Dateien wie ~/.claude/.credentials.json und ~/.codex/auth.json wie Passwörter.

Was ist AgentVera Runner?

Runner ist ein kleiner Dienst, den du auf deinem eigenen Linux- oder macOS-Server installierst. Er führt Claude Code, Codex, Gemini CLI, opencode und einfache Terminals in echten Terminals aus, die nach dem Trennen weiterlaufen. Er verbindet sich nur ausgehend, es wird also kein Port geöffnet. Er gehört zu den Plänen Pro und Team.

Kann AgentVera einen Agenten auf meinem Server ohne Runner ausführen?

Ja. Setze im Agent-Dialog „Runs on“ auf einen gespeicherten SSH-Server und wähle einen Ordner auf dem Server. Der Agent nutzt die eigene CLI-Anmeldung des Servers. Ist dort tmux installiert, überlebt die Session eine abgebrochene Verbindung.

Claude Code auf einem Remote-Server ausführen

Um Claude Code auf einem Remote-Server auszuführen, installierst du es auf dem Server, meldest dich einmal an und startest es in einer Terminal-Session, die das Trennen überlebt, meist tmux über SSH. Das ist die ganze Idee. Der Rest ist die Wahl, wo der Server steht, wie sich der Agent ohne Browser anmeldet und wie viel von deiner Welt der Agent von dort erreicht.

Dieser Beitrag erklärt, warum Leute Agenten auf einen VPS verlagern, vergleicht die gängigen Setups, behandelt die Anmeldung auf einer Maschine ohne Browser und die grundlegende Sicherheit und zeigt dann, wie AgentVera Remote-Agenten mit Runner, SSH-Agenten und Docker handhabt.

Warum einen Coding-Agenten auf einem Remote-Server ausführen

Ein Laptop ist ein schlechtes Zuhause für lange Agent-Läufe. Er geht in den Ruhezustand, verliert das WLAN, und du klappst ihn zu, um nach Hause zu gehen. Ein Server nicht.

Häufige Gründe, Agenten von deinem Rechner wegzuverlagern:

Lange Aufgaben. Eine Migration, ein großes Refactoring oder eine Testsuite, die eine Stunde dauert, sollte nicht stoppen, weil dein Laptop eingeschlafen ist.
Der Code liegt schon dort. Manche Projekte bauen nur unter Linux, brauchen eine GPU oder eine Datenbank, die nur in diesem Netzwerk existiert.
Isolation. Ein Agent auf einer Wegwerf-VM kommt nicht an deine privaten Dateien, SSH-Schlüssel oder Browser-Sessions.
Zugriff von überall. Du startest eine Aufgabe am Schreibtisch und schaust von einem anderen Computer oder deinem Handy nach.
Mehrere Agenten gleichzeitig. Ein Server mit mehr Kernen und Speicher führt mehr Agenten parallel aus als ein Laptop.

Der Preis ist Einrichtung und Verantwortung. Einen Server, den du kontrollierst, musst du auch absichern.

Die Optionen im Überblick

Setup	Überlebt Trennen	Isolation	Aufwand	Gut für
SSH + tmux auf einem VPS	Ja	Separate Maschine	Gering	Die meisten, ein oder zwei Projekte
Dev-Container (lokal oder remote)	Solange der Container läuft	Container	Mittel	Reproduzierbare Umgebungen, Teams
Cloud-VM pro Aufgabe	Ja	Komplette VM	Mittel bis hoch	Wegwerf-Umgebungen, riskante Arbeit
Agent in einem Container auf deinem Rechner	Nein, stoppt mit dem Agenten	Container	Gering	Isolation ohne Server

SSH und tmux

Das ist das einfachste Setup, und es funktioniert mit jedem CLI-Agenten. Auf dem Server:

npm install -g @anthropic-ai/claude-code
tmux new -s agent
cd ~/projects/my-app
claude

Trenne mit Ctrl-b d und schließe SSH. Der Agent arbeitet weiter. Später verbindest du dich per ssh wieder und führst tmux attach -t agent aus. Bevorzugst du screen oder zellij, ist die Idee dieselbe: Die Session gehört dem Server, nicht deiner SSH-Verbindung.

Worauf du verzichtest: kein Dateibaum, keine Diff-Ansicht, und der Wechsel zwischen mehreren Agenten heißt, tmux-Fenster zu jonglieren.

Dev-Container

Ein Dev-Container beschreibt die Umgebung in einer Datei (devcontainer.json plus ein Dockerfile), sodass jede Maschine dieselben Tools bekommt. Du kannst ihn lokal oder auf einem Remote-Docker-Host ausführen. Der Agent läuft im Container und sieht nur, was du hineinmountest.

Der Haken: Die Anmeldung des Agenten muss auch im Container existieren, und ein neu gebauter Container verliert alles, was du nicht persistiert hast.

Cloud-VMs

Eine frische VM pro Aufgabe bietet die sauberste Isolation: Macht der Agent etwas kaputt, löschst du die Maschine. Es kostet mehr Einrichtung, und du brauchst einen Weg, den Code hinein und das Ergebnis heraus zu bekommen, meist ein Git-Branch, den der Agent pusht.

Anmeldung auf einer Maschine ohne Browser

Coding-Agenten melden sich normalerweise über einen Browser an. Ein Server hat keinen, du brauchst also einen dieser Wege.

Claude Code

Browser auf deinem Computer. Führe claude auf dem Server aus. Es zeigt einen Login-Link; öffne ihn auf deinem eigenen Rechner. Erreicht der Browser den lokalen Callback des Servers nicht, zeigt Claude Code einen Code, den du an der Eingabeaufforderung „Paste code here if prompted“ im Terminal einfügst.
Langlebiges Token. claude setup-token erzeugt ein einjähriges OAuth-Token für ein Pro-, Max-, Team- oder Enterprise-Abo. Es wird nirgends für dich gespeichert: Setze es auf dem Server als CLAUDE_CODE_OAUTH_TOKEN. Dieses Token deckt nur Modellanfragen ab.
API-Key. Setze ANTHROPIC_API_KEY, wenn du pro Nutzung über die API zahlst.

Unter Linux speichert Claude Code seine Credentials in ~/.claude/.credentials.json mit dem Dateimodus 0600. Unter macOS landen sie im Schlüsselbund, und über SSH weicht es auf diese Datei aus, wenn der Schlüsselbund gesperrt ist.

Codex

Device-Code. codex login --device-auth gibt dir einen Code, den du anderswo in einem Browser eingibst. Es ist in der Beta und muss in deinen ChatGPT-Sicherheitseinstellungen (oder durch deinen Workspace-Admin) aktiviert werden.
API-Key. printenv OPENAI_API_KEY | codex login --with-api-key.
Ausweichwege. Kopiere ~/.codex/auth.json von einer Maschine, auf der du angemeldet bist, oder leite den Login-Port mit ssh -L 1455:localhost:1455 weiter und melde dich normal an.

Welchen Weg du auch nimmst: Eine Credential-Datei auf einem Server ist so sensibel wie ein Passwort. Wer sie lesen kann, kann dein Abo nutzen.

Sicherheit auf dem Server

Ein Agent auf einem Server führt Befehle mit den Rechten des Benutzers aus, unter dem er läuft. Plane das ein.

Nutze einen separaten Benutzer. Führe Agenten nicht als root aus. Ein dedizierter Benutzer mit eigenem Home-Ordner begrenzt, was ein schlechter Befehl erreicht.
Halte Produktions-Secrets fern. Braucht der Agent das Passwort der Produktionsdatenbank nicht, gehört es nicht in eine .env-Datei auf diesem Server.
Schließe eingehende Ports. SSH nur mit Schlüsseln, kein Passwort-Login und keine offenen Dev-Server, die du vergessen hast.
Arbeite auf Branches. Lass den Agenten auf einen Branch pushen, nicht auf main. Mit Git-Worktrees arbeiten mehrere Agenten am selben Repo, ohne sich in die Quere zu kommen.
Achte auf langlebige Tokens. Ein einjähriges Token auf einem geteilten Server ist ein einjähriges Risiko. Rotiere es, wenn die Maschine geteilt oder ausgemustert wird.
Rechne mit ablaufenden Anmeldungen. Prüfe bei unbeaufsichtigten Läufen, dass die Session noch angemeldet ist, bevor du sie über Nacht allein lässt.

So führt AgentVera Agenten auf einem Server aus

AgentVera ist eine Desktop-App, die Coding-Agent-CLIs nebeneinander in echten Terminals mit deinen eigenen Anmeldungen ausführt. Sie bietet dir drei Wege, Agenten von deinem Rechner wegzubringen.

Runner: dein eigener Server, von überall geöffnet

Runner ist ein kleiner Dienst, den du auf deinem eigenen Linux- oder macOS-Server oder einem Mac installierst. Er führt Claude Code, Codex, Gemini CLI, opencode und einfache Terminal-Sessions in echten Terminals aus. Sessions laufen beim Trennen weiter, und du verbindest dich wieder über den Browser oder die Desktop-App.

Die Einrichtung in Kürze:

Öffne app.agentvera.dev/runners und füge einen Runner hinzu. Du bekommst einen 8-stelligen Kopplungscode, der 10 Minuten gültig ist.
Führe auf dem Server den Installationsbefehl mit diesem Code aus:

curl -fsSL https://app.agentvera.dev/runner/install.sh | sh -s -- --pair KOD

Installiere die CLI auf dem Server und melde dich an, zum Beispiel npm install -g @anthropic-ai/claude-code und danach claude login.

Runner braucht Node.js 20 oder neuer und curl oder wget. Unter Linux installiert er einen systemd-User-Dienst; führe einmal sudo loginctl enable-linger $USER aus, damit er beim Abmelden weiterläuft. Um Agenten in bestimmten Ordnern zu halten, führe agentvera-runner roots ~/projects aus. Ohne Roots arbeiten Agenten in deinem Home-Ordner.

Zur Sicherheit: Runner baut nur eine ausgehende Verbindung zu app.agentvera.dev auf Port 443 auf, du öffnest also keinen Port auf dem Server. Der Verkehr wird über TLS weitergeleitet, und der AgentVera-Server interpretiert, protokolliert oder speichert ihn nicht. Dein Code bleibt auf deinem Server, und nur aktive Mitglieder deiner Organisation können sich verbinden. Die Runner-Seite zeigt außerdem CPU, Speicher und Festplatte des Servers.

Runner gehört zu den Plänen Pro und Team.

Agenten über SSH: kein zusätzlicher Dienst

Hast du schon einen Server in der SSH-Liste von AgentVera, brauchst du Runner nicht. Setze im Dialog für neue Agenten Runs on auf diesen gespeicherten Server statt auf This computer und wähle den Folder on the server. Der Agent läuft dann auf dem Server mit der eigenen CLI-Anmeldung des Servers. Wie der Dialog sagt, muss die CLI auf dem Server installiert und angemeldet sein, oder du meldest dich beim ersten Start im Terminal des Agenten an. Deine lokalen Konten, MCP- und Browser-Einstellungen werden auf dem Server nicht genutzt.

Ist tmux auf dem Server installiert, startet AgentVera den Agenten in einer tmux-Session. Diese Session überlebt die SSH-Verbindung, und die nächste Verbindung, von jedem Computer aus, hängt sich wieder an sie an. Das Beenden der App stoppt sie nicht; das Stoppen oder Schließen des Agenten schon.

Die SSH-Funktion selbst ist kostenlos: gespeicherte Server, ein verschlüsselter Tresor für Credentials, SFTP und ProxyJump. Details stehen auf der Seite SSH und SFTP.

Agenten in einem Docker-Container: Isolation ohne Server

Manchmal brauchst du keinen Server, sondern eine Wand. Schalte für einen lokalen Claude Code oder Codex Agenten im Agent-Dialog Run in a Docker container ein. Der Agent sieht nur den Projektordner; andere Dateien, Programme und SSH-Schlüssel auf deinem Computer bleiben ihm verschlossen. Du kannst CPU- und Speicherlimits setzen.

AgentVera baut beim ersten Mal ein eigenes Image (Node 22, git, ripgrep, Claude Code und Codex), oder du nutzt dein eigenes Image, solange es den Befehl claude oder codex hat. Der Container wird entfernt, wenn der Agent stoppt. Er braucht Docker Desktop, Colima oder OrbStack. Das ist kostenlos; siehe Agenten in Docker.

Welchen wählen

Du willst	Nutze
Agenten, die stundenlang auf deinem Server laufen, aus dem Browser geöffnet	Runner (Pro und Team)
Einen Agenten auf einem Server, den du schon per SSH erreichst	Runs on → gespeicherter SSH-Server
Isolation auf deinem eigenen Rechner	Run in a Docker container
Einen schnellen Blick auf einen laufenden Agenten vom Handy	Die Mobile App oder Telegram

Häufige Fehler

Den Agenten direkt in der SSH-Session starten und ihn verlieren, wenn die Verbindung abbricht.
Den Agenten „nur kurz“ als root ausführen.
Eine ganze .env mit Produktionsschlüsseln auf den Server kopieren.
Ein langlebiges Token auf einer geteilten Maschine lassen und vergessen.
Mehrere Agenten im selben Ordner arbeiten lassen statt auf getrennten Branches oder Worktrees.

Checkliste

Die CLI ist auf dem Server installiert und angemeldet.
Der Agent läuft in tmux, Runner oder einer anderen Session, die ein Trennen überlebt.
Er läuft als Nicht-root-Benutzer, begrenzt auf die Projektordner.
Auf dem Server liegen keine Produktions-Secrets, außer die Aufgabe braucht sie.
Eingehende Ports sind geschlossen, außer SSH mit Schlüsseln.
Jeder Agent arbeitet auf einem eigenen Branch oder Worktree.

Fazit

Claude Code auf einem Remote-Server auszuführen läuft auf drei Dinge hinaus: eine Session, die deine Verbindung überlebt, eine Anmeldung, die ohne Browser funktioniert, und ein Server, auf dem nur liegt, was der Agent braucht. SSH und tmux bringen dich in fünf Minuten dorthin. Willst du Agenten von überall starten, ihre Dateien und Diffs sehen und mehrere gleichzeitig laufen lassen, erledigen Runner und SSH-Agenten von AgentVera dieselbe Aufgabe mit weniger Jonglieren.

Mehr dazu:

Um AgentVera auszuprobieren, beginne auf der Startseite.