Codex auf einem VPS: auf einem Linux-Server installieren und per SSH verbinden

Wie Codex auf einem VPS zusammenspielt

Beteiligt sind drei Maschinen, und jede hat eine Aufgabe:

• Der Linux-Server führt Codex aus. Chats in seinen Projekten führen dort Befehle aus, lesen Dateien und schreiben Änderungen, mit den Abhängigkeiten, Sicherheitsrichtlinien und der Rechenleistung des Servers. Die Desktop-App startet Codex darauf per SSH, in der Login-Shell des Remote-Nutzers.
• Ein Mac oder Windows-PC führt die ChatGPT-Desktop-App aus, die die SSH-Verbindung hält. Er ist der Host, mit dem dein Handy spricht, also muss auch er wach und online bleiben.
• Dein Handy führt die ChatGPT-App aus und steuert diesen Host per Remote Control. Es schickt Prompts und Freigaben und zeigt dir Diffs, Terminal-Ausgaben und Benachrichtigungen.
• OpenAI dokumentiert nur macOS und Windows als Remote-Control-Hosts, das direkte Koppeln eines Handys mit einem Linux-Server ist also nicht dokumentiert. Kopple dein Handy stattdessen mit dem Mac oder PC, am besten mit einem Mac mini, der immer läuft.

Was du brauchst

• Einen Linux-Server, den du per SSH erreichst. Die Installationsanleitung der Codex CLI auf GitHub nennt Ubuntu 20.04+ oder Debian 10+, mit 4 GB RAM als Minimum und 8 GB als Empfehlung; Release-Builds gibt es für x86_64 und ARM64.
• Einen Mac oder Windows-PC mit der ChatGPT-Desktop-App, um den Server als SSH-Host hinzuzufügen. Willst du den Server vom Handy aus erreichen, muss dieser Computer an bleiben.
• Ein ChatGPT-Konto für Codex. OpenAIs Abo-Tabelle führt SSH-Remote-Verbindungen bei Plus, Pro, Business und Enterprise sowie mit einem API-Key, und Remote Control vom Handy bei Plus, Pro, Business und Enterprise, aber nicht mit einem API-Key.
• Die ChatGPT-App auf deinem Handy, iOS oder Android.

So richtest du Codex auf einem Linux-VPS ein

1. Miete einen Server und prüf SSH

   Erstelle einen Linux-Server und stell sicher, dass du dich per SSH von dem Mac oder PC aus anmelden kannst, auf dem die Desktop-App laufen wird. Nutze eine Anmeldung per Schlüssel und ein Konto mit nur den Rechten, die Codex braucht, nicht root.

2. Installiere die Codex CLI auf dem Server

   Führ OpenAIs Installationsskript auf dem Server aus; derselbe Befehl aktualisiert Codex später, und npm funktioniert auch. Installiere bubblewrap für die Sandbox von Codex: Ohne bwrap im PATH greift Codex auf einen mitgelieferten Helfer zurück, der unprivilegierte User Namespaces braucht, und gibt beim Start eine Warnung aus. Unter Ubuntu 24.04 kann die Warnung bleiben, bis du das AppArmor-Profil bwrap-userns-restrict lädst.

   # On the server: install the Codex CLI (run it again to update)
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   # or: npm install -g @openai/codex
   
   # Codex's sandbox on Linux uses bubblewrap
   sudo apt install bubblewrap   # Fedora: sudo dnf install bubblewrap

3. Melde dich auf einem Headless-Server an

   Der Server hat keinen Browser, also nutz die Anmeldung per Device Code: Führ codex login --device-auth aus oder wähl Sign in with Device Code und folge der Anleitung. Die Funktion ist in der Beta, und die Anmeldung per Device Code muss zuerst in deinen ChatGPT-Sicherheitseinstellungen oder von deinem Workspace-Admin eingeschaltet werden. Kannst du sie nicht nutzen, leite den Login-Callback mit ssh -L 1455:localhost:1455 weiter und führ codex login auf dem Server aus, oder kopier ~/.codex/auth.json von einem Computer, auf dem du angemeldet bist, und behandle diese Datei wie ein Passwort.

   # Headless sign-in (beta; turn on device code login in ChatGPT first)
   codex login --device-auth
   
   # Or forward the browser callback from your computer, then run codex login
   ssh -L 1455:localhost:1455 you@devbox.example.com
   
   # Exits 0 once you're signed in
   codex login status

4. Füg den Server zu deiner SSH-Config hinzu

   Füg auf dem Mac oder PC einen Host-Eintrag in ~/.ssh/config hinzu und prüf, dass ssh devbox funktioniert. Codex liest konkrete Host-Aliasse aus dieser Datei und ignoriert Einträge, die nur aus Mustern bestehen. Die Desktop-App startet Codex in der Login-Shell des Remote-Nutzers, codex muss dort also im PATH liegen.

   # ~/.ssh/config on the Mac or PC running the ChatGPT desktop app
   Host devbox
     HostName devbox.example.com
     User you
     IdentityFile ~/.ssh/id_ed25519
   
   # Check it works before adding it in the app
   ssh devbox

5. Füg ihn in der Desktop-App als SSH-Host hinzu

   Öffne in der ChatGPT-Desktop-App Settings > Connections, füg den SSH-Host hinzu oder aktivier ihn und wähl dann einen Projektordner auf dem Server. Chats in diesem Projekt führen auf dem Server Befehle aus, lesen dort Dateien und schreiben Änderungen.

6. Steuere ihn vom Handy aus

   Öffne auf demselben Mac oder PC Settings > Connections > Control this Mac or PC, wähl Set up oder Add und scann den QR-Code mit der ChatGPT-App. Öffne Codex auf deinem Handy, wähl diesen Computer und das Projekt des Servers und starte einen Chat. Der Chat läuft über den Mac oder PC auf dem Server, halt diesen Computer also wach und online; ein Mac mini zu Hause kann diese Aufgabe übernehmen. Details zur Einrichtung und Lösungen findest du unter Codex Remote Control.

Quelle: OpenAIs Doku zu Remote Connections und SSH-Hosts

Nur Terminal: die Codex CLI per SSH in tmux

Brauchst du nur ein Terminal, kannst du die Desktop-App weglassen. Verbinde dich per SSH mit dem Server, führ die Codex CLI in tmux aus und trenn dich von der Sitzung: Codex läuft weiter, nachdem du die Verbindung beendet hast, und du kehrst von jedem Computer aus zurück, der den Server per SSH erreicht.

1. Starte Codex in tmux

   Installiere tmux aus den Paketen deiner Distribution, falls es fehlt, starte eine Sitzung und führ codex in deinem Projektordner aus.

   # On the server: run Codex inside tmux so it outlives your SSH connection
   tmux new -s codex
   cd ~/my-project
   codex
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t codex

2. Was dieses Setup nicht kann

   Dieses Setup ist nicht mit deinem Handy verbunden. Laut OpenAI beginnt die Einrichtung für das Handy in der Desktop-App und lässt sich nicht über die CLI erledigen. Die CLI hat einen experimentellen Befehl codex remote-control, den die Doku mit verwalteten Remote-Control-Clients und SSH-Workflows in Verbindung bringt, aber sie beschreibt nicht, wie man ein Handy mit einem Server koppelt, auf dem nur die CLI läuft.

Halt den Server sicher

• Behandle ihn wie jeden SSH-Server: vertrauenswürdige Schlüssel, ein Konto mit minimalen Rechten und keine Dienste ohne Authentifizierung, die im öffentlichen Internet lauschen.
• Mach den App-Server von Codex nicht öffentlich zugänglich. codex app-server --listen und codex --remote sind vor allem für Entwicklung und Debugging gedacht, und OpenAI warnt davor, App-Server-Transports in einem geteilten oder öffentlichen Netzwerk zu öffnen.
• Um den Server von außerhalb seines Netzwerks zu erreichen, nutz ein VPN oder ein Mesh-Netzwerk wie Tailscale, das nur deine eigenen Geräte über verschlüsselte WireGuard-Verbindungen miteinander verbindet.
• Halt ~/.codex/auth.json privat; laut OpenAI solltest du die Datei wie ein Passwort behandeln.
• Sandbox-Einstellungen, Sicherheitskontrollen und Freigaben gelten für Chats auf dem Server genauso wie lokal, und die Sandbox braucht unter Linux bubblewrap.

Einen Chat zwischen deinem Computer und dem Server verschieben

Die Desktop-App kann einen Chat samt Git-Stand zwischen deinem Computer und einem verbundenen SSH-Host übergeben. Beide brauchen ein gespeichertes Projekt für dasselbe Git-Repository. Wähl in der Fußzeile des Chats den Ort, an dem er gerade läuft, wähl den Ziel-Host (This computer holt ihn zurück), prüf alles und wähl Hand off. Codex legt dort einen Worktree an oder nutzt einen vorhandenen. Eine Antwort, die noch läuft, wird unterbrochen, und an Codex cloud lässt sich ein Chat nicht übergeben.

Ganz ohne Server: Codex cloud

• Codex cloud führt Coding-Aufgaben in OpenAIs Cloud aus. Jede Aufgabe bekommt ihren eigenen Workspace und arbeitet weiter, während dein Computer schläft.
• Starte im Web, in der Desktop-App (Work in > Cloud) oder in der ChatGPT-App auf deinem Handy (Codex öffnen, Cloud und eine Umgebung wählen). Mit der Standardumgebung kannst du starten, ohne ein Repository auszuwählen, und Codex kann Repositorys aus deinem verbundenen GitHub- oder GitLab-Konto auschecken.
• Ein Cloud-Task sieht nur seine Cloud-Umgebung: Deine lokalen Dateien, laufenden Prozesse, Browser-Anmeldungen und dein VPN-Zugang werden nicht übernommen. Wiederverwendbare Setups liegen unter Work in > Cloud > Select environment > Create environment.
• Es braucht eine Anmeldung mit ChatGPT, keinen API-Key. Im Terminal öffnet codex cloud eine Auswahl deiner Cloud-Chats, und codex cloud exec reicht eine Aufgabe ein.

Mac-mini-Host vs. Linux-SSH-Host vs. Codex cloud

Gib dem Server einen festen Job

Ein Server, der nie schläft, wartet trotzdem auf deinen nächsten Prompt. Crewmark macht aus einem Codex-Chat darauf einen KI-Mitarbeiter mit Rolle, einem Ziel in Zahlen, Arbeitszeiten und einem Heartbeat: Während der Arbeitszeit weckt die crewmark-CLI, die unter Linux genauso läuft wie unter macOS und Windows, den Mitarbeiter, damit er seine Issues auf einem gemeinsamen Board abarbeitet. Der Computer, auf dem er läuft, muss an bleiben, und ein VPS tut das.

1. Stell einen Mitarbeiter ein

   Wähle eine Rolle aus den Rollen für KI-Mitarbeiter, etwa Softwareentwickler oder SEO-Spezialist, und schreib seine Ziele und KPIs auf.

2. Verbinde Codex auf dem Server

   Füge den Setup-Link in einen Codex-Chat auf dem Server ein. Er installiert die crewmark-CLI und verknüpft diesen Chat mit dem Mitarbeiter. Claude Code funktioniert auch; siehe Claude Code auf einem VPS.

3. Leg Arbeitszeiten und einen Heartbeat fest

   Nur werktags oder jeden Tag, Zeiten, die über Mitternacht gehen können, und ein Weckruf alle 15, 30, 60, 120 oder 240 Minuten. Jeder Weckruf landet im selben Codex-Chat, sodass er dort weitermacht, wo er aufgehört hat. Die eigenen Zeitplanoptionen von Codex vergleicht proaktives Codex.

4. Weise Issues zu und sprich vom Handy aus mit ihm

   Öffne crewmark.ai im Browser deines Handys, um Issues anzulegen und zuzuweisen, oder schreib dem Mitarbeiter in seinem Arbeitsprotokoll (Work log); die Nachricht landet im Codex-Chat auf dem Server, und er antwortet dort. Eine Zuweisung weckt ihn sofort, und braucht er ein Review oder eine Entscheidung, setzt er das Issue auf Needs action und fragt dich dort. Jobs, die du ihm geben kannst, findest du unter Anwendungsfälle für Codex.

FAQ