> ## Documentation Index
> Fetch the complete documentation index at: https://docs.infercom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI Integrationsanleitung

> Konfigurieren Sie OpenAI Codex CLI mit Infercoms EU-souveräner Inferenz. Agentenbasierter Coding-Assistent mit Responses API Unterstützung und vollständiger DSGVO-Konformität.

[Codex CLI](https://github.com/openai/codex) 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.

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

## Voraussetzungen

* Node.js 18 oder höher
* npm oder yarn
* [Infercom API-Schlüssel](https://cloud.infercom.ai/apis)

## Installation

```bash theme={null}
npm install -g @openai/codex
```

Installation überprüfen:

```bash theme={null}
codex --version
```

<Warning>
  **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:

  ```bash theme={null}
  xattr -d com.apple.quarantine $(which codex)
  ```
</Warning>

## Konfiguration

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

### Schritt 1: Umgebungsvariable setzen

```bash theme={null}
export INFERCOM_API_KEY="ihr-infercom-api-schluessel"
```

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

### Schritt 2: Konfigurationsdatei erstellen

Erstellen Sie `~/.codex/config.toml`:

```toml theme={null}
# 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"
```

<Tip>
  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](https://github.com/openai/codex) für die Profil-Konfiguration.
</Tip>

### Schritt 3: Setup überprüfen

Starten Sie Codex in einem beliebigen Projektverzeichnis:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
codex exec "Füge Eingabevalidierung zu auth.py hinzu"
```

## Konfigurationsoptionen

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

```toml theme={null}
# 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:

```bash theme={null}
# 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](/de/agentic-coding/aider) - Alternatives Terminal-basiertes Tool
* [OpenCode](/de/agentic-coding/opencode) - Moderne TUI mit ähnlichen Features
* [Responses API](/de/features/responses-api) - API-Dokumentation für individuelle Integrationen