Zum Hauptinhalt springen

​
Übersicht

OpenAI Codex ist ein Open-Source-Kommandozeilen-Tool (CLI), das als leichtgewichtiger Coding-Agent fungiert und in der Lage ist, Code im Terminal zu lesen, zu ändern und auszuführen. Es basiert auf GPT-Modellen und ist für die Codegenerierung optimiert.

​
Systemanforderungen

  • Betriebssystem: macOS, Linux (offizieller Support), Windows über WSL
  • Node.js: Version 18+
  • npm: Version 10.x.x oder höher

​
Installation

sudo npm install -g @openai/codex@latest
Installation überprüfen: 
codex --version

​
Konfiguration

​
Schritt 1: API-Key festlegen

Temporär (aktuelle Sitzung): 
export OPENAI_API_KEY="sk-your-lemondata-key"
Permanente Konfiguration: Hinzufügen zu ~/.bashrc, ~/.zshrc oder ~/.bash_profile: 
export OPENAI_API_KEY="sk-your-lemondata-key"
Anschließend neu laden: 
source ~/.zshrc  # oder source ~/.bashrc

​
Schritt 2: config.toml konfigurieren

Bearbeiten Sie ~/.codex/config.toml: 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
Falls die Konfigurationsdatei nicht existiert, führen Sie codex einmal aus, um sie zu generieren, und bearbeiten Sie die Datei anschließend.

​
Grundlegende Nutzung

Interaktiven Modus starten: 
codex
Direkter Befehl: 
codex "Fix the bug in main.py line 42"
Modell angeben: 
codex -m gpt-4o "Build a REST API server"

​
Verfügbare Modelle

ModellBestens geeignet für
gpt-4oKomplexe Coding-Aufgaben, Architektur
gpt-4o-miniSchnelle Fehlerbehebungen, einfache Aufgaben
claude-sonnet-4-5Code-Review, Dokumentation
deepseek-r1Algorithmus-Design, Reasoning

​
Interaktive Befehle

BefehlBeschreibung
/helpHilfe anzeigen
/exit oder Ctrl+CBeenden
/clearKonversation löschen
/configKonfiguration anzeigen
/model <name>Modell wechseln
/tokensToken-Verbrauch anzeigen

​
Konfiguration überprüfen

# Umgebungsvariable prüfen
echo $OPENAI_API_KEY

# API-Verbindung testen
codex "Hello, Codex!"

# Konfiguration anzeigen
cat ~/.codex/config.toml

​
Häufige Anwendungsfälle

Code-Review: 
git diff | codex "Review these code changes"
Commit-Nachrichten generieren: 
git diff --staged | codex "Generate a commit message for these changes"
Fehler beheben: 
codex "Fix the TypeScript errors in src/components/"
Code erklären: 
cat main.py | codex "Explain what this code does"

​
Fehlerbehebung

  • Überprüfen Sie, ob base_url in der config.toml exakt https://api.lemondata.cc/v1 entspricht
  • Prüfen Sie die Netzwerkverbindung
  • Stellen Sie sicher, dass keine Proxy-Interferenzen vorliegen
  • Überprüfen Sie, ob die Umgebungsvariable OPENAI_API_KEY gesetzt ist
  • Stellen Sie sicher, dass der Key mit sk- beginnt
  • Stellen Sie sicher, dass der Key im LemonData-Dashboard aktiv ist
  • Überprüfen Sie, ob der Modellname exakt übereinstimmt
  • Überprüfen Sie die Modellverfügbarkeit unter lemondata.cc/en/models