Codex CLI installieren und die erste Aufgabe ausführen

Codex CLI ist ein terminalbasierter Coding-Agent von OpenAI, der in Rust geschrieben ist. Er läuft lokal, arbeitet mit dem Code in Ihrem Repository und führt Aufgaben in einer isolierten Umgebung aus. Sie können ihn über den eigenständigen Installer, npm, ein Homebrew Cask oder eine Binärdatei aus GitHub Releases installieren.

Halten Sie nach der Installation die beiden Verbindungswege getrennt: die offizielle OpenAI-Anmeldung über ChatGPT oder einen OpenAI API Key einerseits und einen benutzerdefinierten Anbieter mit Ihrem eigenen API Key andererseits. Beide verwenden denselben Befehl codex; Sie müssen keinen separaten Client installieren.

Voraussetzungen für die Installation

Grundlegende Systemanforderungen aus der offiziellen Installationsanleitung:

• macOS: Version 12 (Monterey) oder neuer.
• Linux: Ubuntu 20.04+ / Debian 10+.
• Windows: Windows 11 über WSL2; für den nativen Betrieb unter Windows gibt es eine separate Dokumentation.

Node.js ist nur bei der Installation über npm erforderlich. Der eigenständige Installer, das Homebrew Cask und das Archiv aus GitHub Releases installieren eine direkt ausführbare Datei.

Für die offizielle Anmeldung über ChatGPT benötigen Sie ein ChatGPT-Konto, für den offiziellen API-Zugriff einen Schlüssel von platform.openai.com. Für einen benutzerdefinierten Anbieter benötigen Sie Ihr eigenes BetterToken-Konto, einen API Key und eine aktuelle Model ID. Node.js ist nur für die npm-Installation oder das automatische Skript zur Provider-Einrichtung erforderlich.

Codex CLI installieren

macOS und Linux — eigenständiger Installer

Die einfachste Methode; Node.js ist nicht erforderlich:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Prüfen Sie nach Abschluss der Installation den Befehl:

codex --version

Wenn eine Versionsnummer erscheint, ist der Befehl verfügbar.

Codex ist installiert? Verbinden Sie Ihren API Key mithilfe der aktuellen Anleitung. Prüfen Sie zuerst die aktuellen Docs und erstellen Sie anschließend ein BetterToken-Konto, falls Sie noch keinen eigenen Schlüssel besitzen.

macOS — Homebrew Cask

brew install --cask codex

npm — macOS, Linux und Windows

Sie benötigen Node.js mit einem funktionierenden npm. Die Mindestversion von Node.js finden Sie im Feld engines des Pakets auf npmjs.com/@openai/codex.

npm install -g @openai/codex

Wenn der Befehl codex nach der Installation nicht gefunden wird, liegt das globale npm-Verzeichnis nicht in Ihrem PATH. Ermitteln Sie den richtigen Pfad:

npm config get prefix

Vergleichen Sie dieses Verzeichnis mit dem PATH Ihrer Shell und starten Sie das Terminal neu. Hängen Sie nicht blind /bin an: Die Struktur für globale ausführbare Dateien hängt vom Betriebssystem und von der Installationsart von Node.js ab.

Linux — Binärdatei aus GitHub Releases

Auf github.com/openai/codex/releases stehen einsatzbereite Linux-Archive zur Verfügung:

• codex-x86_64-unknown-linux-musl.tar.gz — für x86_64
• codex-aarch64-unknown-linux-musl.tar.gz — für arm64

Entpacken Sie das Archiv, benennen Sie die ausführbare Datei in codex um und legen Sie sie in einem beschreibbaren Verzeichnis ab, das in Ihrem PATH enthalten ist.

Windows

Codex CLI kann nativ unter Windows oder innerhalb von WSL2 ausgeführt werden. Die aktuelle Windows-Dokumentation empfiehlt Windows 11 für die native Nutzung; eine vollständig aktualisierte Installation von Windows 10 wird nach dem Best-Effort-Prinzip unterstützt.

Natives Windows (PowerShell). Offizieller Installer:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Bei nativer Ausführung isoliert Codex die Aufgabenausführung über Windows Sandbox. Der Modus wird in ~/.codex/config.toml festgelegt:

[windows]
sandbox = "elevated"

• "elevated": empfohlen; verwendet einen eigenen Sandbox-Benutzer und Firewall-Regeln.
• "unelevated": wendet ACL-Beschränkungen auf den aktuellen Benutzer an, ohne einen eigenen Sandbox-Benutzer anzulegen.

WSL2. Installieren Sie die Linux-Version von Codex CLI innerhalb von WSL2 nach der Linux-Anleitung. Für Linux-Werkzeuge empfiehlt OpenAI, das Projekt im WSL-Dateisystem und nicht unter /mnt/ abzulegen.

Dieselbe Codex CLI mit der BetterToken API verbinden

BetterToken ersetzt Codex CLI nicht durch eine andere Anwendung. Die offizielle ausführbare Datei codex funktioniert weiterhin; in ~/.codex/config.toml wird lediglich ein benutzerdefinierter Anbieter ausgewählt. Codex-Anfragen verwenden OpenAI Responses über die Base URL `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk

Schritt 1 — eigenes Konto und eigenen Schlüssel erstellen

Erstellen Sie Ihr eigenes BetterToken-Konto und einen persönlichen API Key. Verwenden Sie keinen gemeinsam genutzten Schlüssel und kopieren Sie keinen Schlüssel in einen Artikel, Screenshot oder Befehl.

Schritt 2 — aktuelle Konfiguration übernehmen

Öffnen Sie die aktuelle BetterToken-Anleitung für Codex, wählen Sie die verwendete Oberfläche aus und kopieren Sie die dort angezeigte Model ID sowie die Provider-Felder. Beenden Sie Codex vollständig, bevor Sie die Konfiguration ändern. Model ID und Authentifizierungsfelder sind dynamisch; leiten Sie sie nicht aus einem alten Beispiel ab.

Schritt 3 — bereinigen, anwenden, neu starten und prüfen

Entfernen Sie zuerst alte OpenAI-Variablen, die config.toml überschreiben könnten.

macOS und Linux:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Windows PowerShell:

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")

Automatische Einrichtung des BetterToken-Providers

Das Skript konfiguriert nur den BetterToken-Provider; Codex CLI selbst wird dadurch nicht installiert. Es benötigt Node.js. Wenn Sie keinen API Key und kein Modell als Argument übergeben, fragt das Skript beides interaktiv im Terminal ab. Schreiben Sie das Geheimnis daher nicht in die Befehlszeile.

macOS und Linux:

curl -fsSL https://www.bettertoken.ai/install-codex-provider.sh?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk | bash

Windows PowerShell:

iwr https://www.bettertoken.ai/install-codex-provider.ps1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Authentifizierungsfelder und die Speicherung von Anmeldedaten unterscheiden sich je nach Codex-Oberfläche und Client-Version. Dieser Artikel schreibt deshalb keine konkreten Authentifizierungs-Boolean-Werte fest und führt die offizielle Anmeldung nicht mit einem benutzerdefinierten Anbieter in einem einzigen Konfigurationsbeispiel zusammen.

Wenden Sie nur die in den aktuellen Docs angegebenen Felder an, übergeben Sie das Geheimnis mit der dort beschriebenen Methode und starten Sie Codex vollständig neu. Führen Sie anschließend eine kleine schreibgeschützte Aufgabe aus und prüfen Sie im BetterToken Dashboard, ob die neue Anfrage, das Modell sowie die Nutzung von Input-, Output- und Cache-Token im Verlauf erscheinen.

Offizielle OpenAI-Authentifizierung

Die folgenden Befehle gelten für die offizielle OpenAI-Verbindung. Beim benutzerdefinierten BetterToken-Provider prüft codex login status nicht die BetterToken API; führen Sie stattdessen eine Testaufgabe aus und kontrollieren Sie die Antwort.

Über ChatGPT anmelden

Führen Sie folgenden Befehl aus:

codex login

Ein Browser wird geöffnet. Schließen Sie dort die Anmeldung mit Ihrem ChatGPT-Konto ab. Codex speichert die Sitzung lokal, sodass Sie sich bei späteren Starts nicht erneut anmelden müssen.

Wenn Sie codex vor der Authentifizierung ohne Argumente starten, fordert Sie die Oberfläche ebenfalls zur Anmeldung auf. Der primäre Weg zum Starten der Anmeldung ist codex login.

Mit einem API Key anmelden

Übergeben Sie den Schlüssel weder als Befehlsargument noch über echo — sonst landet sein Wert im Verlauf Ihrer Shell.

Setzen Sie OPENAI_API_KEY in der aktuellen Umgebung oder über einen Secret Manager. Schreiben Sie den Wert weder in den Artikel noch in einen Befehl oder eine Ausgabe. Sobald die Variable gesetzt ist, übergeben Sie sie über stdin:

printenv OPENAI_API_KEY | codex login --with-api-key

Der Schlüsselwert wird nicht auf dem Bildschirm angezeigt und gelangt nicht in den Befehlsverlauf.

Authentifizierung prüfen

Prüfen Sie nach der Anmeldung den Status:

codex login status

Der Befehl zeigt die aktuelle Authentifizierungsmethode an oder meldet, dass Sie nicht angemeldet sind.

Falls keine Authentifizierung angezeigt wird, wiederholen Sie die Anmeldung mit der passenden Methode.

So melden Sie sich ab und entfernen gespeicherte Anmeldedaten:

codex logout

Die Datei ~/.codex/auth.json enthält das Zugriffstoken — behandeln Sie sie wie ein Passwort. Löschen Sie sie nicht manuell; verwenden Sie zum Bereinigen immer codex logout.

Dokumentation zur Authentifizierung: developers.openai.com/codex/auth. Referenz für Login-Unterbefehle und Flags: developers.openai.com/codex/cli/reference.

Ihre erste Aufgabe in einem Test-Repository

Beginnen Sie in einem Test-Repository, damit Sie keinen produktiven Code verändern. Klonen Sie ein beliebiges öffentliches Repository, zum Beispiel Codex selbst:

git clone https://github.com/openai/codex codex-test
cd codex-test

Führen Sie eine schreibgeschützte Aufgabe aus:

codex --sandbox read-only "Explain the entry point of this project"

Das Flag --sandbox read-only beschränkt die vom Modell erzeugten Befehle auf Lesezugriffe. Wenn Codex eine sinnvolle Beschreibung der Struktur liefert, ohne Dateien zu verändern, ist der erste Durchlauf abgeschlossen.

Um in der TUI mit derselben Einschränkung weiterzuarbeiten, führen Sie Folgendes aus:

codex --sandbox read-only

Geben Sie in der Oberfläche ein: What files are in this project and what does each do?

Wenn Sie die offizielle OpenAI-Verbindung verwenden, prüfen Sie, ob die Authentifizierung weiterhin aktiv ist:

codex login status

Bei Verwendung des BetterToken-Providers bestätigt eine normale Antwort die Verbindung. Sie können außerdem das BetterToken Dashboard öffnen und prüfen, ob die Anfrage, das Modell sowie die Nutzung von Input-, Output- und Cache-Token im Nutzungsverlauf erscheinen.

Fehlerbehebung

codex: command not found nach der npm-Installation

Führen Sie npm config get prefix aus, vergleichen Sie das Ergebnis mit PATH und starten Sie das Terminal neu. Der genaue Pfad zur ausführbaren Datei hängt vom Betriebssystem und von der Installationsart von Node.js ab. Hängen Sie daher nicht blind /bin an.

Beim Anmelden über ChatGPT wurde kein Browser geöffnet

Versuchen Sie auf einem Remote-Server ohne grafische Oberfläche zunächst den offiziellen Device-Code-Ablauf (Beta):

codex login --device-auth

Sie müssen ihn zuerst in den ChatGPT-Sicherheitseinstellungen oder in den Workspace-Berechtigungen aktivieren. Falls er nicht verfügbar ist, verwenden Sie die Anmeldung mit API Key:

printenv OPENAI_API_KEY | codex login --with-api-key

Die offizielle Authentifizierungsanleitung erläutert Callback, Gerätecode und Ausweichmöglichkeiten.

Codex reagiert nach der Verbindung mit BetterToken nicht

Prüfen Sie fünf Punkte: base_url ist https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk wire_apibleibtresponses, Model ID, Provider-Felder und Authentifizierung entsprechen der aktuellen Anleitung für die gewählte Oberfläche, und alte Variablen OPENAI_API_KEYoderOPENAI_BASE_URLüberschreiben die Konfiguration nicht. Starten Sie Codex nach dem Bearbeiten vonconfig.toml` vollständig in einem neuen Terminal.

codex login status zeigt Not logged in

• ChatGPT-Anmeldung: Führen Sie codex login erneut aus und schließen Sie die Anmeldung im Browser ab.
• Anmeldung mit API Key: Stellen Sie sicher, dass OPENAI_API_KEY in Ihrer Arbeitsumgebung gesetzt ist, und wiederholen Sie anschließend printenv OPENAI_API_KEY | codex login --with-api-key.
• Löschen Sie ~/.codex/auth.json nicht manuell — verwenden Sie codex logout.

---

Dokumentation zu Codex CLI: developers.openai.com/codex/cli. Dieselbe Codex CLI mit der BetterToken API verbinden: docs.bettertoken.ai/en/ai-tools/codex.