Eine Website liefert einen 502-Fehler. Statt Logs in einen Chatbot zu kopieren, bitten Sie einen KI-Agenten auf dem Server, die relevanten Dateien zu untersuchen und das Problem zu erklären. Das ist ein praktischer Einsatzzweck für die Codex CLI auf einem Linux-VPS.
Dieser Ratgeber behandelt die Installation, die Anmeldung in einer SSH-Sitzung und eine erste Aufgabe mit eingeschränkten Berechtigungen. Anschließend erklären wir den echten Test hinter unserem Video: Codex hat bei einer absichtlich fehlerhaften Demo-Website eine Port-Abweichung erkannt.
Was wo läuft: Der Codex-Agent und seine Kommandozeilen-Tools laufen auf Ihrem VPS. Beim hier beschriebenen OpenAI-Setup läuft das KI-Modell in der Cloud von OpenAI. Sie benötigen Ihr eigenes berechtigtes ChatGPT-Konto oder separat abgerechneten OpenAI-API-Zugang. Ein SharpHeberg-VPS enthält diesen Zugang nicht.
Bevor Sie beginnen
- Ein Linux-VPS, auf den Sie per SSH zugreifen können, mit ausgehendem HTTPS-Zugang. Die folgenden Paketbefehle gelten für Debian und Ubuntu.
- Ein normaler Linux-Benutzer mit verfügbarem sudo zur Installation von Systempaketen. Führen Sie Codex als dieser Benutzer aus, nicht als Root.
- Ein OpenAI-Konto mit Codex-Zugang. Prüfen Sie die aktuelle Verfügbarkeit und die Limits Ihres Tarifs; die API-Abrechnung ist von einem ChatGPT-Abonnement getrennt.
- Ein Testprojekt oder eine Staging-Umgebung. Halten Sie Produktionszugangsdaten und nicht zugehörige Kundendateien außerhalb des Kontos und Arbeitsbereichs, auf die der Agent zugreifen kann.
Sie müssen für diesen Cloud-basierten Ablauf weder die Modellgewichte hosten noch eine GPU bereitstellen. Die Ressourcen, die Ihre Projekte, Build-Tools und Dienste verbrauchen, sind bei der Wahl eines VPS dennoch wichtig.
Umfang der Validierung: Unsere Diagnose-Demonstration lief auf einem Wegwerf-Debian-12-VPS mit Codex CLI 0.164.0. Dieses isolierte Experiment nutzte ein privilegiertes Diagnosekonto; das ist nicht die Kontoeinrichtung, die wir für die Produktion empfehlen. Außerdem haben wir den offiziellen Standalone-Installer in einem isolierten Linux-x86-64-Installationsverzeichnis geprüft und die CLI-Version sowie die Login-/Sandbox-Optionen verifiziert. Wir haben nicht jede Ubuntu-Version und jede VPS-Konfiguration getestet.
1. Mit Ihrem VPS verbinden
Verbinden Sie sich von Ihrem eigenen Computer aus mit Ihrem vorhandenen SSH-Konto ohne Root. Ersetzen Sie den Beispielbenutzer und die Adresse:
ssh youruser@YOUR_VPS_IP
Wenn Ihr Server nur ein Root-Konto hat, legen Sie zunächst anhand der Administrationsanleitung Ihres Betriebssystems ein separates Konto an und prüfen Sie es. Sie sollten einem KI-Agenten nicht nur für den Einstieg eine Root-Shell geben.
Installieren Sie unter Debian oder Ubuntu die in diesem Ratgeber verwendeten Download- und Projekt-Tools:
sudo apt update
sudo apt install ca-certificates curl git less
Diese Befehle installieren Systempakete; sie aktualisieren nicht den gesamten Server und ändern nicht Ihre Firewall.
2. Codex CLI installieren
OpenAI dokumentiert einen Standalone-Installer für macOS und Linux sowie Alternativen über npm und Homebrew. Beim Standalone-Weg müssen Sie nicht zuerst Node.js und npm installieren. Siehe die offizielle Installationsanleitung der Codex CLI.
Laden Sie den Installer in ein eigenes Verzeichnis herunter, damit Sie ihn vor der Ausführung prüfen können:
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
Drücken Sie q, um less zu verlassen. Führen Sie das Skript nach der Prüfung als normaler Benutzer aus:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
Der offizielle Installer verwendet standardmäßig ~/.local/bin und verwaltet sein Standalone-Paket in Ihrem Codex-Benutzerverzeichnis. Er kann die Startdatei Ihrer Shell aktualisieren. Öffnen Sie Ihr Terminal erneut, wenn Sie dazu aufgefordert werden; das obige export macht den Standard-Installationsort auch in der aktuellen Sitzung verfügbar.
Wenn die kurze Download-URL fehlschlägt: Der Quellcode des Installers ist auch im offiziellen OpenAI-Codex-Repository verfügbar. Laden Sie diesen Quellcode herunter, prüfen Sie ihn und führen Sie dann dieselben Installationsschritte aus:
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
Ersetzen Sie dies nicht durch ein Skript von einem unbekannten Mirror. Wenn der Download der Binärdatei selbst fehlschlägt, dokumentiert OpenAI CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false, um GitHub Releases auszuwählen:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Wenn Sie bereits eine unterstützte Node.js-/npm-Installation verwalten, ist die dokumentierte npm-Alternative npm install -g @openai/codex. Wählen Sie eine Installationsmethode, statt mehrere zu mischen und sich dann zu fragen, welches codex in Ihrem PATH liegt.
3. Von einem Headless-Server aus anmelden
Ihr VPS hat in der Regel keinen Desktop-Browser. OpenAI empfiehlt für diese Situation die Geräte-Code-Authentifizierung:
codex login --device-auth
Folgen Sie dem im Terminal angezeigten Link auf Ihrem eigenen Computer oder Smartphone, melden Sie sich an und geben Sie den Einmalcode ein. Möglicherweise müssen Sie zuerst die Geräte-Code-Anmeldung in Ihren ChatGPT-Sicherheitseinstellungen aktivieren oder von Ihrem Workspace-Administrator erlauben lassen. Geben Sie diesen Code niemals an andere weiter.
Prüfen Sie anschließend die Authentifizierungsmethode:
codex login status
Wenn die Geräte-Code-Anmeldung nicht verfügbar ist, dokumentiert OpenAI außerdem einen SSH-Tunnel für den normalen Browser-Login-Ablauf. Starten Sie diese Verbindung von Ihrem Computer aus:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
Führen Sie in dieser SSH-Sitzung codex login aus und öffnen Sie den Login-Link in Ihrem lokalen Browser. So wird der localhost-Callback weitergeleitet, ohne einen Authentifizierungsport öffentlich freizugeben. Lesen Sie die Headless-Login-Anleitung von OpenAI, wenn Ihre Umgebung eine andere Callback-Konfiguration nutzt.
Stattdessen einen API-Schlüssel verwenden
Wenn Sie nutzungsbasierten API-Zugang bevorzugen, hinterlegen Sie Ihren eigenen OpenAI-API-Schlüssel sicher als Umgebungsvariable und übergeben Sie ihn dann über die Standardeingabe:
printenv OPENAI_API_KEY | codex login --with-api-key
Fügen Sie keinen API-Schlüssel im Klartext in einen Befehl ein, der im Shell-Verlauf gespeichert wird. Die API-Nutzung wird über Ihr OpenAI-Platform-Konto abgerechnet und nicht von Ihrer VPS-Hosting-Rechnung abgezogen. Behandeln Sie die von Codex gespeicherten Zugangsdaten wie Passwörter und halten Sie sie aus Repositories, Screenshots und Support-Tickets heraus. Die offizielle Authentifizierungsanleitung erklärt beide Methoden.
4. Mit einer schreibgeschützten Aufgabe beginnen
Wechseln Sie in ein Testprojekt, dessen Dateien Sie verstehen. Wenn Sie keines haben, genügt ein leeres Verzeichnis, um die CLI zu öffnen und die Oberfläche zu erkunden:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
In einem echten Test-Repository ist dies ein nützlicher erster Prompt:
Erkläre, wie dieses Projekt startet. Lies die relevanten Konfigurations- und README-Dateien, ermittle den Einstiegspunkt und liste alles auf, was du nicht verifizieren kannst. Ändere keine Dateien und installiere keine Pakete.
read-only beschränkt vom Modell erzeugte Befehle über die konfigurierte Sandbox. Mit on-request kann das Modell um zusätzliche Freigabe bitten; das bedeutet nicht, dass jeder Befehl automatisch eine Bestätigung erfordert. Lesen Sie jede Anfrage auf erweiterte Rechte, bevor Sie entscheiden, ob Sie sie erlauben.
Ein Prompt mit „ändere nichts“ ist für sich genommen keine Sicherheitsgrenze. Verwenden Sie ein dediziertes Konto und eine Testumgebung, begrenzen Sie die zugänglichen Daten und prüfen Sie die Berechtigungen, die Ihre installierte Version anzeigt. Auch mit schreibgeschütztem Zugriff können lesbare Dateiinhalte dem Modelldienst offengelegt werden.
Prüfen Sie codex --help und die CLI-Befehlsreferenz, bevor Sie Flags aus einem älteren Tutorial übernehmen. Umgehen Sie die Sandbox oder die Freigaben nicht, um einen Installationsfehler zu beheben.
5. Von der Erklärung zu einer nützlichen Serveraufgabe
Ein sinnvoller nächster Schritt ist, Codex einen kleinen, klar umrissenen Diagnosebereich zu geben. Legen Sie in einem Testverzeichnis bereinigte Kopien der relevanten Logs und Konfigurationen an und fragen Sie dann:
Diese Demo-Website liefert HTTP 502. Untersuche nur die bereitgestellte nginx-Konfiguration, den Einstiegspunkt der Anwendung und das Fehlerprotokoll. Erkläre die Ursache und schlage die kleinstmögliche Korrektur vor. Bearbeite keine Dateien, installiere keine Pakete und starte keine Dienste neu.
Prüfen Sie die vorgeschlagene Änderung, bevor Sie sie selbst anwenden. Sichern Sie bei einem echten Dienst die Konfiguration, validieren Sie sie mit der eigenen Prüfung des Dienstes und bereiten Sie ein Rollback vor. Eine KI-Erklärung ist kein Beleg dafür, dass eine Änderung für die Produktion sicher ist.
Was in unserer Demonstration passiert ist
Wir haben auf einem Wegwerf-VPS absichtlich eine Demo-Website falsch konfiguriert. Nginx leitete Anfragen an Port 3000 weiter, während die Anwendung auf 3001 lauschte. Die Website lieferte HTTP 502.
Codex untersuchte die ausgewählte Konfiguration, die Anwendung und das Fehlerprotokoll im schreibgeschützten Modus. Es erkannte die Abweichung und schlug in etwa 22 Sekunden eine Korrektur in einer einzigen Zeile vor, ohne die bereitgestellten Dateien zu bearbeiten. Unser Produktions-Operator wendete diesen Vorschlag an, prüfte die nginx-Konfiguration, lud den Dienst neu und verifizierte eine HTTP-200-Antwort.
Das war ein kontrollierter Test mit einem bekannten, absichtlich herbeigeführten Fehler. Er ist kein Benchmark, keine Garantie für Reparaturzeiten und keine Demonstration einer unbeaufsichtigten Wiederherstellung in der Produktion.
Wenn etwas nicht funktioniert
codex: command not found: Öffnen Sie das Terminal erneut, prüfen Siecommand -v codexund vergewissern Sie sich, dass das Installationsverzeichnis in Ihrem PATH liegt.- Die Installer-URL oder der Download ist blockiert: Verwenden Sie den Quellcode aus dem offiziellen Repository und die oben dokumentierte Auswahl von GitHub Releases. Deaktivieren Sie nicht die TLS-Überprüfung.
- Beim Login kann kein Browser geöffnet werden: Verwenden Sie die Geräte-Code-Anmeldung oder den dokumentierten SSH-Tunnel. Veröffentlichen Sie keine localhost-Authentifizierungsports.
- Sie erreichen ein Nutzungslimit: Prüfen Sie das Konto und die Authentifizierungsmethode, die
codex login statusanzeigt. Die Installation der CLI oder der Kauf eines VPS hebt die Nutzungslimits von OpenAI nicht auf. - Sandbox- oder Hilfsprogramm-Fehler: Behalten Sie die vollständige offizielle Installation zusammen und prüfen Sie, ob Ihre Distribution die erforderlichen Isolationsmechanismen unterstützt. Ein Container oder ein eingeschränkter VPS kann zusätzliche Beschränkungen haben. Lösen Sie dies nicht, indem Sie Codex als Root ausführen oder seine Schutzmechanismen deaktivieren.
Sehen Sie sich die Demonstration an und probieren Sie es auf Ihrem eigenen VPS aus
Unser begleitendes Video folgt dem Diagnosebeispiel von der defekten Website bis zur verifizierten Antwort. Es zeigt, wobei Ihnen der installierte Agent bei der Untersuchung helfen kann; die Installationsbefehle stehen in diesem Ratgeber.
Kontrollierte Demonstration auf einem Wegwerf-Test-VPS: Codex schlägt die Korrektur vor; unser Operator wendet sie an und verifiziert sie. Demonstration auf YouTube ansehen.
Beginnen Sie mit einem Testprojekt, halten Sie die Berechtigungen des Agenten eng und verifizieren Sie jedes Ergebnis. Wenn Sie für diesen Arbeitsbereich einen Server benötigen, entdecken Sie die Linux-VPS-Tarife von SharpHeberg. Ihr OpenAI-Konto und dessen Nutzung bleiben vom Hosting-Dienst getrennt.