# Claude Code auf einem Remote-Server ausführen

URL: https://agentvera.dev/de/blog/claude-code-remote-server/ · Veröffentlicht: 2026-10-22

So führst du Claude Code auf einem Remote-Server oder VPS aus: SSH und tmux, Dev-Container, Cloud-VMs, Anmeldung ohne Browser, Sicherheit und AgentVera Runner.

**Kurz gesagt:**

- Claude Code auf einem Server auszuführen heißt: dort installieren, einmal anmelden und in einer Session starten, die Verbindungsabbrüche überlebt, meist tmux über SSH.
- Auf einer Maschine ohne Browser öffnest du den Login-Link auf deinem eigenen Computer oder setzt ein einjähriges Token aus claude setup-token als CLAUDE_CODE_OAUTH_TOKEN.
- AgentVera führt Agenten auf deinem Server über Runner (Pro und Team, nur ausgehende Verbindung) oder einen gespeicherten SSH-Server aus und kann lokale Agenten in Docker isolieren.

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:

```bash
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](/de/ "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](/de/runner/ "AgentVera 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:

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

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

3. 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](/de/features/ssh-and-sftp/ "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](/de/features/agents-in-docker/ "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](/de/blog/claude-code-mobile-app/ "Claude Code Mobile App") oder [Telegram](/de/blog/control-claude-code-from-telegram/ "Claude Code per Telegram steuern") |

## 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:

- [Git-Worktree für parallele Agenten](/de/blog/git-worktree-parallel-agents/ "Git-Worktree für parallele Agenten")
- [Einen Krypto-Trading-Bot mit KI bauen](/de/blog/build-crypto-trading-bot-with-ai/ "Einen Krypto-Trading-Bot mit KI bauen")
- [Mehrere Claude Code Agenten ausführen](/de/blog/run-multiple-claude-code-agents/ "Mehrere Claude Code Agenten ausführen")
- [Docker](/de/features/docker/ "Docker")
- [Was ist ein Coding-Agent?](/de/glossary/coding-agent/ "Coding-Agent")

Um AgentVera auszuprobieren, beginne auf der [Startseite](/de/ "AgentVera").

## Häufige Fragen

**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.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/