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

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.

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.

Braucht der Benutzer sudo-Rechte

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.

Schritt 2. Claude Code installieren

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

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

Prüfen Sie die Installation:

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.

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

TIP

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.

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:

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

WARNING

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.

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

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

WARNING

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:

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:

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.

Wie das funktioniert und was Sie wissen sollten

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

INFO

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