Zum Hauptinhalt springen

​
Überblick

Codex CLI Interface Codex CLI ist das offizielle Kommandozeilen-Tool von OpenAI für codebezogene Aufgaben im Terminal. Im Vergleich zu allgemeinen Chat-Tools legt es den Schwerpunkt auf entwicklungsbereite Ausgaben mit klareren, umsetzbaren Codeänderungen. Durch die Integration von Codex CLI mit EvoLink API können Sie über eine einheitliche OpenAI-kompatible Schnittstelle mit einem Schlüssel und einer Base-URL auf die Modelle von EvoLink (wie die GPT-Serie) zugreifen.

​
Voraussetzungen

Stellen Sie vor der Konfiguration sicher, dass Sie Folgendes haben:

​
1. Node.js und npm installieren

Warum erforderlich? Node.js ist die Laufzeitumgebung für CLI-Tools (so wie Sie WeChat auf Ihrem Handy installieren müssen, um zu chatten, müssen Sie Node.js auf Ihrem Computer installieren, um CLI-Tools auszuführen). Falls bereits installiert: Führen Sie node -v und npm -v aus, um die Version zu prüfen. Bei v20+ können Sie diesen Schritt überspringen. Erstinstallation: 
node -v
npm -v
Node.js und npm Versionsüberprüfung
  • Melden Sie sich beim EvoLink Dashboard an
  • Finden Sie die API Keys im Dashboard, klicken Sie auf die Schaltfläche ‘Neuen Schlüssel erstellen’ und kopieren Sie den generierten Key
  • Der API Key beginnt normalerweise mit sk-

​
Schritt 1: Codex CLI installieren

Tipp: Falls Sie nicht wissen, wie Sie ein Kommandozeilen-Terminal öffnen, siehe FAQ - Wie öffne ich ein Kommandozeilen-Terminal

​
1. Globale Installation

npm install -g @openai/codex
Erwartetes Ergebnis: Download-Informationen scrollen durch, am Ende steht added XX packages (dauert 1-3 Minuten). Bei Fehlern: permission denied bedeutet, dass Windows eine PowerShell mit “Als Administrator ausführen” benötigt, bei macOS/Linux fügen Sie sudo vor dem Befehl hinzu.

​
2. Installation überprüfen

codex --version
Erfolgskriterium: Zeigt eine Versionsnummer an (z.B. 1.x.x). Codex CLI Version Codex CLI unterstützt einen benutzerdefinierten Provider über eine Konfigurationsdatei, keine Änderung des Quellcodes erforderlich.

​
1. Konfigurationsverzeichnis öffnen

Drücken Sie Win + R, fügen Sie Folgendes ein und drücken Sie Enter, um das Codex-Konfigurationsverzeichnis zu öffnen:
%userprofile%\.codex
Windows Win+R Terminal öffnen
Codex CLI Konfigurationsumgebung

​
2. config.toml bearbeiten

Finden Sie die Datei config.toml im Konfigurationsverzeichnis und bearbeiten Sie sie mit folgendem Inhalt:
model = "gpt-5.2"
model_reasoning_effort = "medium"
model_provider = "evolink"

[model_providers.evolink]
name = "EvoLink API"
base_url = "https://code.evolink.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
⚠️ Wichtig:
  • Vollständig kopieren, ohne Symbole auszulassen
  • Ersetzen Sie "your-evolink-api-key" durch den tatsächlichen API Key
  • Das TOML-Format ist empfindlich gegenüber Einrückungen und Symbolen
model = "gpt-5.2"
model_reasoning_effort = "medium"
model_provider = "evolink"

[model_providers.evolink]
name = "EvoLink API"
base_url = "https://code.evolink.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
Konfigurationsfelder:
  • model: Standard-Modellname
  • model_reasoning_effort: Reasoning-Tiefe (nach Bedarf anpassen)
  • model_provider: Provider-Name, der zum folgenden Abschnitt passt
  • base_url: EvoLink API-Endpunkt
  • env_key: Name der Umgebungsvariable für den API Key
  • wire_api: muss responses sein

​
2. API Key konfigurieren

Temporär (nur aktuelle Sitzung)
$env:OPENAI_API_KEY = "your-evolink-api-key"
Permanent
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your-evolink-api-key", "User")
Starten Sie das Terminal neu, damit die Änderungen wirksam werden.Konfiguration überprüfen
echo $env:OPENAI_API_KEY
Prüfen, ob die Umgebungsvariable erfolgreich hinzugefügt wurdeWenn Ihr API Key ausgegeben wird, war die Konfiguration erfolgreich.

​
Schritt 3: Codex CLI verwenden

​
1. Arbeitsverzeichnis aufrufen

cd your-working-directory
Hinweis: Ersetzen Sie your-working-directory durch den tatsächlichen Pfad

​
2. Interaktiver Modus

codex
Codex CLI Interface

​
3. Konfiguration überprüfen

codex "Who are you"
Erfolgskriterien:
  • AI-Antworttext wird angezeigt (mehrere Zeilen)
  • Keine Fehler wie 401, 403, API Key invalid
Bei Fehlermeldungen:
  • 401 Unauthorized: API Key nicht gesetzt oder ungültig → Umgebungsvariable prüfen
  • 403 Forbidden: Unzureichende API Key-Berechtigungen → API Key überprüfen
  • Network error: Netzwerkproblem → Verbindung prüfen

​
FAQ

​
1. Was ist Codex CLI und wofür wird es verwendet?

Codex CLI ist das offizielle Kommandozeilen-Tool von OpenAI, das sich auf codebezogene Aufgaben konzentriert. Es legt den Schwerpunkt auf entwicklungsbereite Ausgaben mit klareren, umsetzbaren Codeänderungen.

​
2. Wie überprüfe ich Installation und Konfiguration bei der ersten Verwendung?

Führen Sie diese Befehle nacheinander aus:
  • node -v und npm -v: Bestätigen, dass Node.js und npm installiert sind
  • codex --version: Bestätigen, dass Codex CLI installiert ist
  • codex "Who are you": Bestätigen, dass die API-Konfiguration korrekt ist

​
3. Was ist der Unterschied zwischen interaktivem Modus und Einzelbefehlsmodus?

  • Interaktiver Modus: Führen Sie codex aus, um eine fortlaufende Konversation für mehrstufige Interaktionen zu starten
  • Einzelbefehlsmodus: Führen Sie codex "Frage" aus, um eine einzelne Antwort zu erhalten und zu beenden

​
4. Liest oder lädt Codex CLI automatisch meine lokalen Dateien und meinen Code hoch?

Nein. Codex CLI liest Dateiinhalte nur, wenn Sie diese ausdrücklich referenzieren oder autorisieren. Es wird empfohlen, es in einem dedizierten Projektordner zu verwenden.

​
5. Wie verwende ich Codex CLI zur Analyse lokaler Dateiinhalte?

Im interaktiven Modus können Sie Dateien referenzieren, indem Sie:
  • Den Dateipfad eingeben, damit Codex ihn liest
  • Dateien in das Terminalfenster ziehen
  • Dateiinhalte kopieren und einfügen

​
6. Unterstützt Codex CLI chinesische Ein- und Ausgabe?

Ja, vollständig unterstützt.

​
7. Keine Ausgabe nach der Ausführung — was könnte die Ursache sein?

Häufige Ursachen sind:
  • Netzwerkverbindungsprobleme
  • Ungültiger API Key oder unzureichendes Guthaben
  • Falsche base_url-Konfiguration
  • Firewall oder Proxy blockiert Anfragen

​
8. Warum werden meine Konfigurationsänderungen nicht wirksam?

  • Starten Sie Ihr Terminal neu
  • Überprüfen Sie die config.toml-Syntax (TOML-Format)
  • Überprüfen Sie den Pfad der Konfigurationsdatei:
    • Windows: C:\Users\{username}\.codex\config.toml
    • macOS / Linux: ~/.codex/config.toml

​
9. Was verursacht 401/403-Fehler?

  • 401-Fehler: OPENAI_API_KEY nicht gesetzt oder ungültig
  • 403-Fehler: Unzureichende Berechtigungen oder abgelaufener Schlüssel
  • Überprüfen Sie, ob env_key mit dem Namen Ihrer Umgebungsvariable übereinstimmt

​
10. Für welche Szenarien ist Codex CLI geeignet?

Geeignet für:
  • Code schreiben, debuggen und refaktorisieren
  • Schnelle Fragen und Antworten in Kommandozeilenumgebungen
  • Analyse von Dateiinhalten
Nicht geeignet für:
  • Komplexe GUI-Interaktionen
  • Echtzeit-kollaboratives Bearbeiten

​
11. Wie wechsle ich das Modell?

Öffnen Sie die Konfigurationsdatei config.toml (unter ~/.codex/config.toml oder C:\Users\{username}\.codex\config.toml) und ändern Sie das Feld model: 
model = "gpt-5.2"  # Ändern Sie den gewünschten Modellnamen
Speichern Sie die Datei und starten Sie Codex CLI neu, damit die Änderungen wirksam werden.

​
12. Wie lade ich Bilder hoch?

  • Option 1: Den Bildpfad referenzieren
  • Option 2: Ein Bild per Drag & Drop in das Terminal ziehen
  • Option 3: Ein Bild direkt einfügen
Alle Methoden erfordern eine Benutzeraktion — Codex CLI liest oder lädt lokale Bilder nicht automatisch hoch.

​
13. Wie öffne ich ein Kommandozeilen-Terminal?

  • Methode 1: Drücken Sie Win + R, geben Sie cmd oder powershell ein und drücken Sie Enter
  • Methode 2: Suchen Sie im Startmenü nach “Eingabeaufforderung” oder “PowerShell”
  • Methode 3: Halten Sie Shift gedrückt und klicken Sie mit der rechten Maustaste in einen Ordner, wählen Sie “PowerShell-Fenster hier öffnen”

​
Hinweise

Führen Sie Codex CLI in einem dedizierten Projektordner aus. Vermeiden Sie die Ausführung in sensiblen Verzeichnissen (wie Systemordnern oder Verzeichnissen mit Anmeldedaten). Codex CLI arbeitet ausgehend vom aktuellen Arbeitsverzeichnis.
Der Wert wire_api in der Konfiguration muss auf "responses" gesetzt sein. "chat" ist veraltet.