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

# APIMart in Codex CLI verwenden

> Ausführliche Anleitung zur Konfiguration und Nutzung der APIMart-API-Dienste in Codex CLI, mit der Sie mehrere KI-Modelle für unterstütztes Programmieren mit einfacher Konfiguration verwenden können.

## Einführung

Codex CLI ist der quelloffene Terminal-Coding-Agent von OpenAI, der Dateien lesen und schreiben, Befehle ausführen, Bugs beheben und vollständige Programmieraufgaben direkt in der Kommandozeile erledigen kann.
Durch die Anbindung über APIMart können Sie in Codex CLI frei mehrere Modelle verwenden – darunter GPT und Claude – mit flexiblerer und wettbewerbsfähigerer Preisgestaltung.

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

1. **Node.js installiert haben**
   Laden Sie es von der [Node.js-Website](https://nodejs.org/) (empfohlen: neueste LTS, v20 oder neuer) herunter, um Codex CLI über npm zu installieren

2. **Einen APIMart-API-Schlüssel erhalten haben**
   Melden Sie sich in der [APIMart-Konsole](https://apimart.ai/keys) an, um Ihren API-Schlüssel zu erhalten (beginnt mit `sk-`)

<Note>**Tipp:** Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei [APIMart](https://apimart.ai) und holen Sie sich Ihren API-Schlüssel.</Note>

## Schritt 1: Codex CLI installieren

Wählen Sie eine der folgenden Methoden zur Installation:

<Tabs>
  <Tab title="npm (empfohlen)">
    Global mit npm installieren – funktioniert auf allen Betriebssystemen:

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

    <Note>Bei Berechtigungsproblemen `sudo` voranstellen (macOS / Linux).</Note>
  </Tab>

  <Tab title="Homebrew (macOS)">
    macOS-Nutzer können auch mit Homebrew installieren:

    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

### Installation überprüfen

Führen Sie nach der Installation den folgenden Befehl zur Bestätigung aus:

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

Wird eine Versionsnummer ausgegeben, war die Installation erfolgreich.

## Schritt 2: APIMart-API konfigurieren

Codex CLI verwaltet Modellanbieter über Konfigurationsdateien im Verzeichnis `~/.codex/`. Alles, was wir tun müssen, ist einen benutzerdefinierten Anbieter hinzuzufügen, der auf APIMart verweist.

### 2.1 Konfigurationsverzeichnis finden

* **macOS / Linux:** `~/.codex/`
* **Windows:** `C:\Users\<username>\.codex\`

<Note>Existiert das Verzeichnis nicht, führen Sie einmal `codex` im Terminal aus und drücken Sie `Ctrl + C` zum Beenden – es wird automatisch erstellt.</Note>

### 2.2 API-Schlüssel konfigurieren

Erstellen oder bearbeiten Sie im Konfigurationsverzeichnis die Datei `auth.json` und geben Sie Ihren APIMart-Schlüssel ein:

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

| Feld             | Beschreibung                                  |
| ---------------- | --------------------------------------------- |
| `OPENAI_API_KEY` | Ihr APIMart-API-Schlüssel (beginnt mit `sk-`) |

### 2.3 Modellanbieter konfigurieren

Erstellen oder bearbeiten Sie im Konfigurationsverzeichnis die Datei `config.toml` und fügen Sie den APIMart-Anbieter hinzu:

```toml theme={null}
# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

| Feld                   | Beschreibung                                                                        |
| ---------------------- | ----------------------------------------------------------------------------------- |
| `model`                | Standard-Modell-ID – wählen Sie eine aus der Modellliste unten                      |
| `model_provider`       | Standardanbieter – muss mit der ID innerhalb `[model_providers.xxx]` übereinstimmen |
| `name`                 | Anzeigename des Anbieters – kann angepasst werden                                   |
| `base_url`             | APIMart-OpenAI-kompatibler URL – fest auf `https://api.apimart.ai/v1`               |
| `wire_api`             | Wire-Protokoll – aktuelle Codex-Versionen erfordern `responses` (Responses API)     |
| `requires_openai_auth` | Auf `true` setzen, um sich mit dem Schlüssel aus `auth.json` zu authentifizieren    |

Nach dem Speichern beider Dateien starten Sie Codex CLI neu, damit die Änderungen wirksam werden.

<Warning>Stellen Sie sicher, dass `auth.json` gültiges JSON und `config.toml` gültiges TOML ist. Verwenden Sie keine Vollbreite- / Smart-Quotes, sonst wird die Konfiguration nicht angewendet.</Warning>

## Schritt 3: Loslegen

### Konfiguration überprüfen

Führen Sie in einem beliebigen Projektverzeichnis den folgenden Befehl aus, um zu bestätigen, dass alles eingerichtet ist:

```bash theme={null}
codex "Introduce yourself in one sentence"
```

Erhalten Sie eine KI-Antwort, funktioniert die Konfiguration. Bei einem Sign-in-Bildschirm oder `401`/`403`-Fehlern siehe FAQ-Abschnitt unten.

### Interaktiver Modus

Führen Sie `codex` direkt aus, um die interaktive Benutzeroberfläche zu betreten – ideal für vollständige Programmieraufgaben:

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

Beschreiben Sie darin, was Sie benötigen, in natürlicher Sprache, z. B.:

```
Create an Express.js server with a JSON-returning health check endpoint
```

Codex analysiert Ihr Projekt, generiert Code, führt Befehle aus und fragt vor sensiblen Operationen nach Bestätigung.

### Genehmigungsmodi

Beim ersten Start fragt Codex Sie nach einem Genehmigungslevel:

| Modus           | Beschreibung                                                                           |
| --------------- | -------------------------------------------------------------------------------------- |
| **Read Only**   | Nur Dateilesungen sind erlaubt – jede Änderung oder jeder Befehl erfordert Bestätigung |
| **Auto**        | Kann Dateien lesen/schreiben und Befehle im Arbeitsverzeichnis ausführen (empfohlen)   |
| **Full Access** | Führt jede Operation ohne Bestätigung aus – mit Vorsicht zu verwenden                  |

Wir empfehlen, mit **Auto**-Modus zu starten. Tippen Sie `/approvals` in der interaktiven UI, um ihn jederzeit zu ändern.

### Modelle wechseln

Tippen Sie in der interaktiven UI `/model`, um schnell zu wechseln, oder ändern Sie das `model`-Feld in `config.toml` und starten Sie neu.

## Unterstützte Modelle

Für Codex CLI werden die folgenden Modelle der GPT-5-Serie empfohlen:

| Modell-ID       | Stärken                                     | Empfohlene Anwendungsfälle                          |
| --------------- | ------------------------------------------- | --------------------------------------------------- |
| `gpt-5.5`       | Neuestes Flaggschiff, top Coding-Fähigkeit  | Erste Wahl für Codex, komplexe Engineering-Aufgaben |
| `gpt-5.4`       | Vorgängergeneration-Flaggschiff, sehr fähig | Komplexes Coding, Architekturdesign                 |
| `gpt-5.4-mini`  | Leichtgewichtig, schnell, kosteneffizient   | Tägliches Coding, schnelle Iteration                |
| `gpt-5.3-codex` | Coding-Modell für Codex optimiert           | Agentische Coding-Aufgaben                          |
| `gpt-5.2`       | Stabil und ausgewogen                       | Routine-Coding-Aufgaben                             |

<Tip>
  **Tipps zur Modellauswahl:** Die obige GPT-5-Serie passt am besten zu Codex CLI. Für das beste Erlebnis bevorzugen Sie `gpt-5.5`; `gpt-5.3-codex` ist speziell für die agentischen Coding-Szenarien von Codex optimiert.
</Tip>

## Häufige Befehle

Häufig verwendete Befehle und Tastenkürzel in Codex CLI:

| Befehl                  | Beschreibung                                     |
| ----------------------- | ------------------------------------------------ |
| `codex`                 | Interaktive UI betreten                          |
| `codex "task"`          | Mit Anfangsanweisung starten                     |
| `codex exec "task"`     | Nicht-interaktiver Modus – ausführen und beenden |
| `codex --model gpt-5.4` | Mit angegebenem Modell starten                   |
| `codex --version`       | Versionsnummer anzeigen                          |
| `/model`                | Modell innerhalb der interaktiven UI wechseln    |
| `/approvals`            | Genehmigungsmodus in der UI anpassen             |
| `Ctrl + C`              | Interaktive UI verlassen                         |

## FAQ

### Q1: Nach dem Start erscheint ein ChatGPT-Anmeldebildschirm?

Wenn nach dem Start „Sign in with ChatGPT" oder Ähnliches erscheint, ist die Konfiguration nicht wirksam geworden.

**Fehlerbehebung:**

1. Stellen Sie sicher, dass sowohl `config.toml` als auch `auth.json` in `~/.codex/` liegen
2. Prüfen Sie, dass `model_provider` in `config.toml` auf `apimart` gesetzt ist
3. Prüfen Sie, dass `auth.json` gültiges JSON ist und der Schlüssel vollständig eingegeben wurde

### Q2: 401 / 403 Fehler?

| Statuscode         | Bedeutung                                              | Lösung                                                                           |
| ------------------ | ------------------------------------------------------ | -------------------------------------------------------------------------------- |
| `401 Unauthorized` | Fehlender oder ungültiger API-Schlüssel                | Prüfen Sie den Schlüssel in `auth.json` – sollte mit `sk-` beginnen              |
| `403 Forbidden`    | Unzureichende Berechtigung oder abgelaufener Schlüssel | Gehen Sie zur [Konsole](https://apimart.ai/keys), um den Schlüssel zu überprüfen |

Stellen Sie außerdem sicher, dass `base_url` auf `https://api.apimart.ai/v1` gesetzt ist, nicht auf die offizielle OpenAI-URL.

### Q3: Verbindung fehlgeschlagen?

1. Prüfen Sie Ihre Netzwerkverbindung
2. Stellen Sie sicher, dass `base_url` in `config.toml` korrekt ist
3. Wenn Sie hinter einem Proxy sind, stellen Sie sicher, dass er den Zugriff auf `api.apimart.ai` erlaubt

### Q4: `wire_api = "chat"` wird nicht mehr unterstützt?

Aktuelle Codex-CLI-Versionen (0.84.0 und neuer) haben das `chat`-Protokoll entfernt. Aktualisieren Sie `wire_api` in `config.toml` auf `responses`:

```toml theme={null}
wire_api = "responses"
```

APIMart unterstützt die Responses API – starten Sie Codex nach der Änderung einfach neu.

### Q5: Tool-Aufrufe oder Ausführungen schlagen fehl?

Stellen Sie sicher, dass `wire_api` in `config.toml` auf `responses` gesetzt ist. Wenn Sie weiterhin auf Kompatibilitätsprobleme stoßen, wechseln Sie zu einem empfohlenen Modell der GPT-5-Serie (z. B. `gpt-5.5`, `gpt-5.3-codex`) – sie passen zuverlässiger zu Codex CLI.

### Q6: Umgebungsvariablen statt auth.json verwenden?

Sie können den Schlüssel auch über eine Umgebungsvariable konfigurieren. Ändern Sie den Anbieter-Block in `config.toml` zu:

```toml theme={null}
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
```

Setzen Sie dann die Umgebungsvariable `APIMART_API_KEY` auf Ihren APIMart-Schlüssel. `auth.json` wird in diesem Setup nicht mehr benötigt.

### Q7: Wie wechsle ich Modelle?

Zwei Wege:

1. **In der interaktiven UI**: Tippen Sie `/model`, um zu wechseln
2. **Konfiguration bearbeiten**: Ändern Sie das `model`-Feld in `config.toml` und starten Sie Codex CLI neu

### Q8: Wie prüfe ich Nutzung und Abrechnung?

Melden Sie sich in der [APIMart-Konsole](https://apimart.ai/overview) an, um API-Aufruf-Statistiken, Token-Verbrauchsdetails und Kostentrends zu sehen.

## Support und Hilfe

Wenn Sie bei der Verwendung von Codex CLI auf Probleme stoßen:

* 📚 [APIMart-Dokumentationszentrum](https://docs.apimart.ai)
* 💬 [Discord-Community](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Technischer Support: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mit APIMart loslegen" icon="rocket" href="https://apimart.ai">
  Registrieren Sie sich jetzt bei APIMart, holen Sie sich Ihren API-Schlüssel und erleben Sie einen Multi-Modell-Programmier-Assistenten in Codex CLI!
</Card>