> Die vollständige Liste der Artikel steht in [llms.txt](https://docs.f3cloud.com/llms.txt). Jede Seite gibt es auch als Markdown, dazu einfach .md an die Adresse anhängen. Diese Seite als Markdown: [https://docs.f3cloud.com/de/software-setup/claude-code-on-vps.md](https://docs.f3cloud.com/de/software-setup/claude-code-on-vps.md).

# Claude Code auf dem VPS – Installation, Anmeldung und Arbeit über die App

So installieren Sie Claude Code auf einem VPS, melden sich ohne Browser auf dem Server bei Ihrem Konto an und steuern die Sitzung mit Remote Control über die Claude-App am Computer oder Smartphone.

**Claude Code** ist der KI-Assistent für Entwicklung von Anthropic, der im Terminal läuft. Auf dem Server schreibt und bearbeitet er Code, führt Befehle aus und hilft beim Einrichten von Programmen. Mit der Funktion **Remote Control** steuern Sie die Sitzung auf dem Server aus der Claude-App am Computer oder Smartphone.

### Was Sie brauchen

| Was          | Anforderungen                                                                    |
| ------------ | -------------------------------------------------------------------------------- |
| Server       | Ubuntu 22.04, 24.04 oder Debian 12, ab 4 GB RAM – der Tarif **DE-RZ9-2** passt  |
| Konto        | Claude Pro, Max, Team oder Enterprise. Der kostenlose Plan enthält Claude Code nicht |
| Computer     | Ein Browser für die Anmeldung und die Claude-App auf PC oder Smartphone für Remote Control |
| Zugang       | SSH zum Server – wie Sie sich verbinden, steht im [Artikel über Termius](https://docs.f3cloud.com/de/vps/termius-connection.md) |

### Schritt 1. Server vorbereiten

Verbinden Sie sich als root mit dem Server, installieren Sie git und tmux und legen Sie einen eigenen Benutzer an. Claude Code als root auszuführen ist unnötig und unsicher.

```bash
apt update && apt install -y git tmux
adduser dev
```

Arbeiten Sie ab jetzt unter diesem Benutzer – wechseln Sie mit `su - dev` oder verbinden Sie sich gleich als `ssh dev@IP-Adresse`.

<details>

<summary>Braucht der Benutzer sudo-Rechte</summary>

Wenn Claude Code Pakete installieren oder Systemeinstellungen ändern soll, fügen Sie den Benutzer mit `usermod -aG sudo dev` zur Gruppe sudo hinzu. Jeder solche Aufruf verlangt trotzdem Ihre Bestätigung und Ihr Passwort. Wenn Claude nur mit Code im Home-Verzeichnis arbeiten soll, vergeben Sie besser keine sudo-Rechte.

</details>

### Schritt 2. Claude Code installieren

Führen Sie als Benutzer `dev` das offizielle Installationsprogramm aus:

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

Prüfen Sie die Installation:

```bash
claude --version
claude doctor
```

Meldet das System `claude: command not found`, melden Sie sich erneut am Server an oder führen Sie `source ~/.profile` aus. Node.js müssen Sie nicht installieren, und Updates spielt Claude Code selbst im Hintergrund ein.

### Schritt 3. Beim Konto anmelden

Auf dem Server gibt es keinen Browser, deshalb läuft die Anmeldung über Ihren Computer. Wählen Sie die passende Methode.

#### Über den Browser am PC

Wir empfehlen diese Methode, weil nur mit ihr die Steuerung aus der App (Remote Control) funktioniert. Sie brauchen einen Computer mit Browser und eine offene SSH-Verbindung zum Server.

1. **Starten Sie Claude Code**, indem Sie sich als Benutzer `dev` mit dem Server verbinden, `claude` eingeben und Enter drücken.
2. Beim ersten Start **stellt Claude Code einige Fragen** und bietet zuerst an, ein Design zu wählen. Wählen Sie mit den Pfeiltasten ein beliebiges aus und drücken Sie Enter. Erscheinen Bildschirme mit Erklärungen, drücken Sie einfach Enter.
3. **Wählen Sie die Anmeldeart**, und zwar den ersten Punkt in der Liste – die Anmeldung über ein Claude-Konto mit Abo (Claude account with subscription) – und drücken Sie Enter.
4. **Kopieren Sie den Link**, den Claude Code anzeigt. Der Server kann keinen Browser öffnen, deshalb erscheint ein langer Link. Drücken Sie die Taste `c`, dann wird er kopiert. Klappt das nicht, markieren Sie den ganzen Link mit der Maus (er kann mehrere Zeilen lang sein) und kopieren Sie ihn.
5. **Öffnen Sie den Link auf Ihrem Computer**, indem Sie ihn in die Adresszeile des Browsers einfügen. Melden Sie sich bei Ihrem Claude-Konto an und bestätigen Sie den Zugriff mit der Schaltfläche Authorize.
6. **Kopieren Sie den Code**, den der Browser nach der Bestätigung anzeigt. Nutzen Sie dafür die Schaltfläche neben dem Code.
7. Kehren Sie zum Fenster mit dem Server zurück, dort steht die Zeile „Paste code here if prompted“. **Fügen Sie den Code ein** (in Termius mit der rechten Maustaste, in anderen Programmen mit `Ctrl+Shift+V` oder `Cmd+V`) und drücken Sie Enter.
8. Es erscheint die Meldung `Login successful`, **damit ist die Anmeldung geschafft**. Drücken Sie Enter, und Claude Code öffnet sich. Fragt es, ob Sie den Dateien in diesem Ordner vertrauen, wählen Sie „Yes, proceed“.

> **Tipp.**
>
> Der Code gilt nur einmal. Wenn ein Fehler auftritt oder seit der Anmeldung viel Zeit vergangen ist, geben Sie in Claude Code den Befehl `/login` ein und gehen Sie die Schritte 3–8 noch einmal durch.

#### Token aus Claude Code am PC

Wenn Claude Code bereits auf Ihrem Computer installiert ist, können Sie ein langlebiges Token erzeugen (es gilt etwa ein Jahr).

1. Führen Sie auf dem **Computer** `claude setup-token` aus, bestätigen Sie den Zugriff im Browser und kopieren Sie das Token.
2. Speichern Sie das Token auf dem **Server** in den Einstellungen der Shell:

```bash
echo 'export CLAUDE_CODE_OAUTH_TOKEN=ihr-token' >> ~/.bashrc && source ~/.bashrc
```

> **Achtung.**
>
> Mit einem solchen Token beantwortet Claude Code Anfragen, **kann aber Remote Control nicht starten**. Wenn Sie über die App arbeiten möchten, melden Sie sich über den Browser an.

#### API-Schlüssel

Für die Abrechnung nach den Tarifen der Anthropic Console erstellen Sie einen Schlüssel auf [platform.claude.com](https://platform.claude.com) und speichern ihn auf dem Server:

```bash
echo 'export ANTHROPIC_API_KEY=ihr-api-key' >> ~/.bashrc && source ~/.bashrc
```

> **Achtung.**
>
> Mit einem API-Schlüssel steht Remote Control nicht zur Verfügung – die Funktion arbeitet nur mit einem Claude-Abo.

### Schritt 4. Im Terminal arbeiten

Wechseln Sie in das Projektverzeichnis und starten Sie Claude Code:

```bash
mkdir -p ~/project && cd ~/project
claude
```

Beschreiben Sie die Aufgabe in ganz normalen Worten, zum Beispiel „Erstelle eine einfache Website mit Flask und starte sie auf Port 5000“. Bevor Claude Code Dateien ändert oder Befehle ausführt, fragt es um Erlaubnis.

| Befehl                  | Was er macht                                        |
| ----------------------- | --------------------------------------------------- |
| `claude`                | Neue Sitzung im aktuellen Verzeichnis               |
| `claude --continue`     | Letzte Sitzung fortsetzen                           |
| `claude --resume`       | Sitzung aus einer Liste wählen                      |
| `/remote-control`       | Aktuelle Sitzung für die Steuerung aus der App öffnen |
| `Shift+Tab`             | Berechtigungsmodus umschalten                       |
| `/exit`                 | Sitzung verlassen                                   |

### Schritt 5. Über die App arbeiten (Remote Control)

Remote Control hält die Sitzung auf dem Server, und Sie schreiben ihr aus der Claude-App am Computer oder Smartphone. Damit die Sitzung nicht endet, wenn die SSH-Verbindung abbricht, starten Sie sie in tmux.

**1.** Legen Sie ein tmux-Fenster an und starten Sie Remote Control im Projektverzeichnis:

```bash
tmux new -s claude
cd ~/project && claude remote-control --name "Mein Server"
```

Beim ersten Start bestätigen Sie das Einschalten der Funktion mit `y`.

**2.** Trennen Sie sich mit `Ctrl+B` und danach `D` vom tmux-Fenster. Die Sitzung läuft weiter, auch wenn Sie SSH schließen.

**3.** Verbinden Sie sich auf eine dieser Arten mit der Sitzung:

* öffnen Sie in der **Claude-App** am Computer oder Smartphone den Bereich Code und wählen Sie die Sitzung „Mein Server“ – bei einer laufenden Sitzung leuchtet eine grüne Anzeige;
* scannen Sie den **QR-Code** mit dem Smartphone – um ihn anzuzeigen, kehren Sie zu tmux zurück und drücken Sie die Leertaste;
* öffnen Sie im Browser den Link der Form `https://claude.ai/code/...`, den Claude Code im Terminal ausgibt.

Zum tmux-Fenster kehren Sie mit dem Befehl `tmux attach -t claude` zurück.

<details>

<summary>Wie das funktioniert und was Sie wissen sollten</summary>

* **Ports müssen nicht geöffnet werden**, denn der Server verbindet sich selbst per HTTPS mit Anthropic, eingehende Verbindungen gibt es nicht.
* **Ein Abo ist nötig**, Remote Control funktioniert bei der Anmeldung mit einem Konto Claude Pro, Max, Team oder Enterprise. Bei Team und Enterprise muss der Inhaber der Organisation die Funktion zuerst einschalten.
* **Eine Sitzung lässt sich fortsetzen**, nach dem Stoppen nehmen Sie sie mit `claude remote-control --continue` wieder auf.
* **Eine bereits offene Sitzung** schalten Sie mit dem Befehl `/remote-control` direkt in Claude Code auf Remote Control um.

</details>

> **Hinweis.**
>
> **Eine SSH-Verbindung zum Server direkt aus der Claude-App am PC ist noch nicht möglich**, denn solche Verbindungen befinden sich derzeit in der Beta und stehen nur Unternehmenskunden zur Verfügung, die über die Cloud-Plattformen von Amazon, Google und Microsoft arbeiten. Mit einem normalen Abo nutzen Sie Remote Control aus diesem Schritt.

### Sicherheit

* **Eigener Benutzer** – starten Sie Claude Code nicht als root.
* **Kein Flag `--dangerously-skip-permissions`** auf einem produktiven Server – damit kann Claude Code ohne Rückfrage beliebige Dateien des Benutzers ändern oder löschen. Dieser Modus eignet sich nur für Wegwerf-Container.
* **Planungsmodus** – wenn Sie zuerst den Plan sehen möchten, schalten Sie mit `Shift+Tab` in diesen Modus.
* **Anmeldedaten** liegen in der Datei `~/.claude/.credentials.json`. Geben Sie Fremden keinen Zugang zu dem Benutzer, unter dem Claude Code läuft.
* **SSH mit Schlüsseln** – richten Sie die Anmeldung per Schlüssel ein und schalten Sie die Anmeldung per Passwort ab, wie in unserer [Anleitung zum Schutz des Servers](https://docs.f3cloud.com/de/client-area/protect-vps-from-unauthorised-access.md) beschrieben.

### Wenn etwas nicht funktioniert

| Symptom                                  | Was zu tun ist                                                                     |
| ---------------------------------------- | ---------------------------------------------------------------------------------- |
| `claude: command not found`              | Erneut am Server anmelden oder `source ~/.profile` ausführen                        |
| Der Browser öffnet sich auf dem Server nicht | Das ist normal – kopieren Sie den Link mit der Taste `c` und öffnen Sie ihn am Computer |
| Remote Control startet nicht             | Mit `/login` über den Browser anmelden – mit Token oder API-Schlüssel funktioniert die Funktion nicht |
| Sitzung nach Trennung der SSH-Verbindung verschwunden | Claude Code in tmux starten, wie in Schritt 5                          |
| Langsame Arbeit oder zu wenig Speicher   | Claude Code braucht ab 4 GB RAM – wählen Sie den Tarif DE-RZ9-2 oder höher          |