Claude Code oder Codex auf einem VPS ausführen: Die umfassende Anleitung

Code-Agenten wie Claude Code von Anthropic und Codex CLI von OpenAI lesen ein Projekt ein, bearbeiten Dateien und führen Befehle über das Terminal aus. Die Installation auf einem VPS anstelle des eigenen Computers bietet drei Vorteile: Die Sitzung bleibt bestehen, wenn Sie Ihren Laptop schließen, der Agent arbeitet in einer von Ihren persönlichen Dateien isolierten Umgebung, und Sie können per SSH von jedem Gerät aus darauf zugreifen. Diese Anleitung beschreibt die Installation beider Tools auf einem Linux-VPS und richtet eine saubere und sichere Umgebung ein.

1. Warum ein VPS für einen Code-Agenten?

2. Den Server vorbereiten

Beginnen Sie mit einem Linux-VPS unter Ubuntu 24.04 und sorgen Sie zunächst für dessen Sicherheit: persönlicher Benutzer, SSH-Schlüssel, Firewall. Siehe Erste Schritte auf Ihrem VPS. Erstellen Sie anschließend einen dedizierten Benutzer für den Agenten ohne Root-Rechte:

adduser --disabled-password --gecos "" agent
apt update && apt install -y git tmux curl build-essential
su - agent

Die Arbeit mit einem Benutzer ohne Administratorrechte schränkt die Möglichkeiten des Mitarbeiters ein, Änderungen am System vorzunehmen, selbst wenn ein Befehl fehlschlägt.

3. Claude Code installieren

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

Beim ersten Start bietet Ihnen Claude Code an, sich mit Ihrem Claude-Konto oder einem Anthropic-API-Schlüssel anzumelden. Auf einem Server ohne Browser wird eine Adresse angezeigt, die Sie auf Ihrem Computer öffnen müssen, um die Anmeldung zu bestätigen. Wechseln Sie anschließend in den Ordner eines Projekts und starten Sie claude.

4. Codex CLI installieren

Codex CLI wird mit npm installiert, daher benötigen Sie Node.js. Installieren Sie zunächst die LTS-Version als Root und anschließend das Tool:

curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt install -y nodejs
npm install -g @openai/codex
su - agent
codex

Codex verbindet sich mit Ihrem ChatGPT-Konto oder einem OpenAI-API-Schlüssel. Beide Agenten können auf demselben Server betrieben werden.

5. Die Sitzung mit tmux offen halten

Ohne entsprechende Vorkehrungen wird der Prozess beendet, sobald die SSH-Verbindung unterbrochen wird. tmux hält die Sitzung auf dem Server aufrecht:

tmux new -s agent          # crée une session nommée « agent »
claude                     # ou codex, dans le dossier du projet
# Ctrl+B puis D pour se détacher : l'agent continue
tmux attach -t agent       # pour revenir plus tard, depuis n'importe quel appareil

Sie können innerhalb derselben Sitzung mehrere Fenster öffnen (Ctrl+B dann C): eine für den Mitarbeiter, eine zur Verfolgung der Tests oder Protokolle.

6. Sicherer Git-Zugriff

Der Mitarbeiter muss Code klonen und hochladen. Geben Sie ihm bitte nicht Ihren persönlichen SSH-Schlüssel:

• Ein Bereitstellungsschlüssel pro Repository : Erstellen Sie einen dedizierten Schlüssel auf dem Server (ssh-keygen -t ed25519 -f ~/.ssh/depot) und fügen Sie sie als Bereitstellungsschlüssel für das betreffende Repository hinzu.
• Oder ein Token mit begrenzter Reichweite : Ein Zugriffstoken, das auf ein Repository und die erforderlichen Berechtigungen beschränkt ist und ein Ablaufdatum aufweist.
• Ein Arbeitsbereich : Lassen Sie den Agenten an einem Zweig arbeiten und überprüfen Sie den Code noch einmal, bevor Sie ihn zusammenführen.

7. Zu beachtende Sicherheitsvorschriften

• Keine Produktionsgeheimnisse auf dem Agentenserver : Verwenden Sie Datenbanken und Testschlüssel.
• Lesen Sie die von ihm vorgeschlagenen Befehle noch einmal durch bevor Sie ihnen die Berechtigung erteilen – zumindest solange, bis Sie sich mit dem Tool vertraut gemacht haben. Beide Agenten fordern je nach gewähltem Modus eine Bestätigung an, bevor sie einen Befehl ausführen oder eine Datei ändern.
• API-Schlüssel in Umgebungsvariablen, mit eingeschränkten Leistungen und einer Ausgabenobergrenze beim Anbieter.
• Aktualisierungen : Starten Sie die Installation von Claude Code regelmäßig neu oder npm update -g @openai/codex, und aktualisieren Sie das System.
• Sicherungen : Falls der Mitarbeiter an Dateien arbeitet, die noch nicht hochgeladen wurden, sichern Sie diese bitte. Siehe Sicherungen mit Borg.

8. Welche Konfiguration sollten Sie wählen?

Nicht der Agent selbst beansprucht Ressourcen, sondern die von ihm ausgelösten Vorgänge: Installation von Abhängigkeiten, Kompilierung, Testsuiten, Container. Der NVMe-Speicher beschleunigt diese Vorgänge erheblich. Die Angebote finden Sie auf der Seite VPS-Agenten für KI, und die Produktbeschreibungen zu Claude Code und Codex CLI in unserem Marktplatz fassen die Installation zusammen.

9. Die Gesamtkosten

Es besteht aus zwei getrennten Teilen:

• Der Kellner : Der Preis für den VPS, der jeden Monat feststeht.
• Das Modell : Ihr Claude- oder ChatGPT-Abonnement bzw. die Nutzung Ihres API-Schlüssels, die je nach Nutzung von Anthropic oder OpenAI in Rechnung gestellt wird.

Legen Sie mithilfe eines API-Schlüssels in der Konsole des Anbieters ein monatliches Ausgabenlimit fest: Ein Agent, der über einen längeren Zeitraum an einem großen Projekt arbeitet, kann hohe Kosten verursachen.

10. Ein Beispiel für einen Arbeitstag

So sieht die konkrete Arbeitsweise mit einem Agenten auf einem Remote-Server aus:

1. Am Morgen, von Ihrem Computer aus: ssh agent@IP_DU_VPS, dann tmux attach -t agent. Sie können die Sitzung genau dort fortsetzen, wo Sie sie unterbrochen haben.
2. Sie beschreiben eine Aufgabe lautet: „Fügen Sie die Paginierung zur Befehls-API hinzu und erstellen Sie die entsprechenden Tests.“ Je konkreter die Vorgabe ist, desto zuverlässiger ist das Ergebnis.
3. Der Sachbearbeiter liest den Entwurf, schlägt einen Plan vor, ändert die Dateien und führt die Tests durch. Sie bestätigen die Befehle fortlaufend oder lassen ihn in einem eigenständigeren Modus auf einem eigenen Zweig arbeiten.
4. Sie lösen sich ab mit Ctrl+B dann D während eines langwierigen Vorgangs, beispielsweise einer Migration von Abhängigkeiten, und Sie kehren später zurück – sogar von Ihrem Smartphone aus über eine SSH-App.
5. Sie lesen den Abschnitt noch einmal durch mit git diff oder in der Benutzeroberfläche Ihrer Schmiede, und anschließend führen Sie die Verschmelzung durch.

Um den Vorgang zu beschleunigen, fügen Sie im Stammverzeichnis jedes Projekts eine Anweisungsdatei hinzu (zum Beispiel CLAUDE.md für Claude Code oder AGENTS.md (für Codex), in dem die Testbefehle, die Codekonventionen und die Bereiche beschrieben sind, an die sich der Mitarbeiter unter keinen Umständen heranwagen darf. Der Mitarbeiter liest dieses Dokument bei jeder Sitzung erneut durch.

11. Weiterführende Informationen: Autonome Agenten und Benachrichtigungen

Mit einem VPS können Sie außerdem Agenten ausführen, die ohne Ihr Zutun arbeiten, beispielsweise um Tickets zu sortieren, ein Repository zu überwachen oder jeden Morgen einen Bericht zu erstellen:

• Geplante Aufgaben : Ein von Cron gestartetes Skript, das den Agenten im nicht-interaktiven Modus für eine bestimmte Aufgabe aufruft und anschließend das Ergebnis speichert.
• Benachrichtigungen : Nach Abschluss einer Aufgabe wird über einen einfachen HTTP-Aufruf eine Nachricht an Telegram oder Discord gesendet. Siehe Telegram-Bot auf einem VPS.
• Automatisierungen : n8n kann den Agenten über ein Formular, eine E-Mail oder einen Webhook auslösen. Siehe n8n auf einem VPS.

Seien Sie in jedem Fall ebenso vorsichtig: eingeschränkte Zugriffsrechte, Testschlüssel, manuelle Überprüfung vor jeder Inbetriebnahme.

Häufig gestellte Fragen