Codex CLI installieren: Einrichtung, Anmeldung und die erste Aufgabe

Installieren Sie Codex CLI, überprüfen Sie die ausführbare Datei, melden Sie sich an und beginnen Sie mit einer kleinen Aufgabe in Ihrem Projektverzeichnis. Die offiziellen Installer unterstützen inzwischen macOS, Linux und Windows; npm und Homebrew bleiben Alternativen. Wählen Sie unten einen Weg. Eine funktionierende Installation ist der erste Schritt; Kontozugriff und API-Abrechnung sind separate Entscheidungen.

1. Wählen Sie eine Installationsmethode

Diese Befehle stammen aus dem offiziellen Installationsleitfaden für Codex CLI. Verwenden Sie den Installer für die Umgebung, in der Sie den Agenten ausführen werden. Die Installation einer Windows-Executable installiert keine separate Linux-Kopie innerhalb von WSL, und die Installation auf Ihrem Laptop installiert Codex nicht auf einem Remote-Server, mit dem Sie sich später verbinden.

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

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

Wenn Sie Entwicklungstools bereits mit einem Paketmanager verwalten, verwenden Sie dessen Alternative, statt beide Installer auszuführen:

Für den npm-Weg benötigen Sie eine funktionierende npm-Installation; prüfen Sie zuerst npm --version. Der eigenständige Weg ist nützlich, wenn Sie Node-Tools ansonsten nicht benötigen. Verwenden Sie auf einem verwalteten Gerät die von Ihrem Administrator unterstützte Installationsmethode, damit spätere Aktualisierungen vorhersehbar bleiben.

2. Überprüfen Sie, welche ausführbare Datei ausgeführt wird

Starten Sie nach der Installation ein neues Terminal, wenn der Befehl nicht gefunden wird. Unter macOS oder Linux zeigt command -v codex die von Ihrer Shell ausgewählte ausführbare Datei. Verwenden Sie in PowerShell Get-Command codex. Vergleichen Sie diesen Pfad mit der von Ihnen gewählten Installationsmethode, bevor Sie neu installieren. Zwei installierte Kopien können dazu führen, dass Sie eine aktualisieren, während weiterhin die andere gestartet wird.

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Ersetzen Sie den Beispiel-Projektpfad durch Ihren eigenen. Der letzte Befehl verwendet für eine erste Erklärung eine schreibgeschützte Sandbox. Dies ist eine nützliche erste Prüfung, weil Sie das richtige Repository und den Modellzugriff bestätigen können, bevor Sie den Agenten um eine Änderung bitten. Wenn Sie verfügbare Flags prüfen möchten, verwenden Sie die Hilfe der installierten CLI oder die Befehlsreferenz.

3. Wählen Sie den richtigen Kontoweg

codex login startet den Konto-Anmeldevorgang. Prüfen Sie vor dem Abschluss das Browserkonto und den Arbeitsbereich. Für die direkte Abrechnung über die OpenAI API akzeptiert die dokumentierte Alternative einen Platform-Schlüssel über die Standardeingabe:

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Dieser API-Befehl ist für einen OpenAI-Platform-Schlüssel vorgesehen. Er ist keine vollständige Einrichtung für ein Drittanbieter-Gateway. Ein benutzerdefinierter Anbieter benötigt eine eigene Konfiguration, einen eigenen Endpunkt, eine eigene Anmeldeinformationsquelle und ein unterstütztes Modell. Die Authentifizierungsdokumentation erläutert die Wege, während unser Leitfaden zu Codex-API-Schlüsseln die weiterführende Anbietereinrichtung behandelt.

4. Machen Sie aus der ersten Antwort eine nützliche erste Aufgabe

1. Fragen Sie, wo sich der relevante Quellcode und die Tests befinden, und prüfen Sie die Antwort anschließend am Repository.
2. Wählen Sie eine kleine Änderung und beschreiben Sie das erwartete Verhalten.
3. Verwenden Sie einen sauberen Branch oder einen Checkpoint und wählen Sie für diese Änderung geeignete Berechtigungen.
4. Lassen Sie Codex die relevanten Prüfungen ausführen und überprüfen Sie anschließend seinen Diff und seine Erklärung.

Beginnen Sie beispielsweise mit einem fehlgeschlagenen Test oder einer kleinen Dokumentationskorrektur. Machen Sie die erste Aufgabe nicht zu einer vollständigen Neuentwicklung einer Anwendung: Installation, Zugangsdaten, lokale Abhängigkeiten und Aufgabenqualität wären gleichzeitig schwieriger zu beurteilen. Sobald die kurze Schleife funktioniert, fügen Sie Ihre Projektanweisungen hinzu und erweitern Sie den Umfang.

Wenn die Einrichtung stoppt, beheben Sie die passende Ebene

„Befehl nicht gefunden“ weist auf ein Installations- oder PATH-Problem hin. Ein 401 weist auf Authentifizierung hin. Ein Modellfehler weist auf den ausgewählten Anbieter und das ausgewählte Modell hin. Eine Warnung zur Begrenzung weist auf Nutzung oder Abrechnung hin. Behalten Sie die funktionierenden Ebenen bei und befolgen Sie je nach Fall die 401-Checkliste oder den Leitfaden zu Nutzungslimits; eine Neuinstallation der ausführbaren Datei lädt ein Konto nicht wieder auf.

Um Kunavo für lokale Codex-Arbeit zu testen, erstellen Sie ein Konto und folgen Sie der Codex-Integration. Sie verwendet eine Responses-kompatible Anbieterkonfiguration. Überprüfen Sie eine kleine Aufgabe, bevor Sie sich bei einem größeren Projekt auf den neuen Abrechnungsweg verlassen.

Häufig gestellte Fragen

Offizielle Installationsdokumentation und lokale CLI-Hilfe, geprüft am 17. September 2026.