Codex CLI Integrationsanleitung

Codex CLI ist OpenAIs Open-Source agentenbasierter Coding-Assistent, der in Ihrem Terminal läuft. Er kann Dateien lesen, Code schreiben, Befehle ausführen und seine Arbeit über die Responses API iterativ verbessern.

Hinweis

Erfordert Responses API - Codex CLI verwendet den /v1/responses-Endpunkt, den Infercom mit MiniMax-M2.7 unterstützt.

Achtung

Bekannte Einschränkung: Tool-nutzende (agentische) Sitzungen über die Responses API sind derzeit von einem serverseitigen Streaming-Problem betroffen und können leere Antworten für Tool-Calls zurückgeben. Für zuverlässiges agentisches Coding verwenden Sie heute OpenCode, Cline oder Aider, die über die Chat Completions API laufen. Diese Seite wird aktualisiert sobald das Problem behoben ist.

Voraussetzungen

• Node.js 18 oder höher
• npm oder yarn
• Infercom API-Schlüssel

Installation

npm install -g @openai/codex

Installation überprüfen:

codex --version

Achtung

macOS-Benutzer: Wenn macOS die Binärdatei als “Malware” blockiert, gehen Sie zu Systemeinstellungen > Sicherheit und klicken Sie auf “Trotzdem erlauben”, oder führen Sie aus:

xattr -d com.apple.quarantine $(which codex)

Konfiguration

Codex CLI unterstützt benutzerdefinierte Anbieter über eine TOML-Konfigurationsdatei.

Schritt 1: Umgebungsvariable setzen

export INFERCOM_API_KEY="ihr-infercom-api-schluessel"

Tipp

Fügen Sie dies zu Ihrem Shell-Profil (~/.bashrc, ~/.zshrc) für Persistenz hinzu.

Schritt 2: Konfigurationsdatei erstellen

Erstellen Sie ~/.codex/config.toml:

# Infercom als Provider definieren
[model_providers.infercom]
name = "Infercom (EU Sovereign)"
base_url = "https://api.infercom.ai/v1"
env_key = "INFERCOM_API_KEY"
wire_api = "responses"

# Standard-Profil mit MiniMax-M2.7
model_provider = "infercom"
model = "MiniMax-M2.7"

Tipp

Für komplexe Aufgaben, die tieferes Reasoning erfordern, unterstützt Codex CLI Profile mit verschiedenen Modellen. Sie können ein Frontier-Modell (Claude, GPT, Gemini) für die Planung und MiniMax-M2.7 für die Ausführung verwenden. Siehe Codex Dokumentation für die Profil-Konfiguration.

Schritt 3: Setup überprüfen

Starten Sie Codex in einem beliebigen Projektverzeichnis:

codex

Sie sollten sehen, dass Codex startet mit:

model: MiniMax-M2.7
provider: infercom

Modell

Verwenden Sie MiniMax-M2.7 - optimiert für Agentic Coding mit 192K Kontext und eingebautem Reasoning.

Verwendung

Interaktiver Modus

Starten Sie Codex in Ihrem Projektverzeichnis:

cd ihr-projekt
codex

Geben Sie Ihre Anfrage ein und Codex wird:

• Relevante Dateien lesen
• Code schreiben oder bearbeiten
• Terminal-Befehle ausführen
• Iterieren bis die Aufgabe abgeschlossen ist

Beispielaufgaben

• “Füge Fehlerbehandlung zur Login-Funktion hinzu”
• “Schreibe Unit-Tests für die User-Klasse”
• “Refaktoriere diese Datei zur Verwendung von async/await”
• “Finde und behebe den Bug, der den Test fehlschlagen lässt”

Nicht-interaktiver Modus

Für geskriptete oder einmalige Verwendung nutzen Sie das exec-Unterkommando:

codex exec "Füge Eingabevalidierung zu auth.py hinzu"

Konfigurationsoptionen

Vollständige ~/.codex/config.toml Referenz:

# Standardmodell
model = "MiniMax-M2.7"

# Zu verwendender Anbieter
model_provider = "infercom"

# Genehmigungsmodus: "suggest" (Standard), "auto-edit" oder "full-auto"
approval_mode = "suggest"

# Sandbox-Modus für Befehlsausführung
sandbox = "docker"  # oder "none" zum Deaktivieren

[model_providers.infercom]
name = "Infercom (EU Sovereign)"
base_url = "https://api.infercom.ai/v1"
env_key = "INFERCOM_API_KEY"
wire_api = "responses"

Genehmigungsmodi

Modus	Verhalten
suggest	Zeigt Diffs und fragt vor dem Anwenden (Standard)
auto-edit	Wendet Dateiänderungen automatisch an, fragt bei Befehlen
full-auto	Wendet alle Änderungen automatisch an

Fehlerbehebung

Verbindungsfehler

Überprüfen Sie Ihre Konfiguration:

# Prüfen ob API-Schlüssel gesetzt ist
echo $INFERCOM_API_KEY

# API direkt testen
curl -s https://api.infercom.ai/v1/responses \
  -H "Authorization: Bearer $INFERCOM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.7","input":"Hallo"}' | jq .status

Erwartete Ausgabe: "completed"

Modell nicht gefunden

Stellen Sie sicher, dass der Modellname exakt ist (Groß-/Kleinschreibung beachten): MiniMax-M2.7

Langsame Antworten

MiniMax-M2.7 läuft mit 400+ Tokens/Sekunde. Wenn Antworten langsam erscheinen:

1. Überprüfen Sie Ihre Netzwerkverbindung
2. Großer Kontext (viele Dateien) erhöht die Verarbeitungszeit
3. Die erste Anfrage kann langsamer sein aufgrund des Modell-Ladens

Warum Codex CLI mit Infercom?

Feature	Vorteil
EU-souverän	Daten werden in Deutschland verarbeitet, DSGVO-konform
Responses API	Native Unterstützung für Codex’ agentenbasierte Architektur
Schnelle Inferenz	400+ Tokens/Sekunde mit MiniMax-M2.7
Kein Vendor Lock-in	Open-Source-Tool, Standard-API

Nächste Schritte

• Aider - Alternatives Terminal-basiertes Tool
• OpenCode - Moderne TUI mit ähnlichen Features
• Responses API - API-Dokumentation für individuelle Integrationen