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

# Codex

> Richten Sie Codex auf FlexInference mit einem Schlüssel aus, der die Deadline enthält.

[Codex](https://developers.openai.com/codex/cli) erstellt seinen eigenen Anfragetext, sodass Sie `start_within` nirgendwo platzieren können. Die Deadline wird stattdessen auf dem Schlüssel hinterlegt. Erstellen Sie zuerst einen (siehe [Agent-Schlüssel](/de/agent-keys)).

## Einrichtung mit einem Agenten

Öffnen Sie den folgenden Block und kopieren Sie ihn in einen beliebigen Coding-Agenten. Die Aufforderung fragt niemals nach Ihrem API-Schlüssel: Der Agent konfiguriert alles andere und druckt dann die eine Exportzeile aus, die Sie selbst ausführen können.

<Accordion title="Agent-Setup-Prompt kopieren">
  ```text theme={null}
  Configure the Codex CLI to send its requests to FlexInference. Do not change my existing Codex setup: create a separate profile I opt into per run.

  You will never see or handle my API key. The profile stores only the NAME of an environment variable, and I export the value myself. Do not ask me for the key, and do not read it from my environment.

  1. Create `~/.codex/flexinference.config.toml` with exactly this content:

  model = "gpt-5.6-sol"
  model_provider = "flexinference"

  [model_providers.flexinference]
  name = "FlexInference"
  base_url = "https://api.flexinference.com/v1"
  wire_api = "responses"
  env_key = "FLEX_API_KEY"

  2. Tell me to export the key myself, in the shell I will run Codex from:

     export FLEX_API_KEY=<paste your key here>

     Print that line for me to run. Do not run it, do not ask for the value, and do not add it to my shell profile.

  3. Tell me to start Codex with `codex --profile flexinference`.

  Rules that matter, do not deviate:
  - Keep the `model` line. Codex defaults to a slug ending in `-codex`, which FlexInference recognizes but holds no price for and never races. Use the full `gpt-5.6-sol`; the bare `gpt-5.6` alias makes Codex print a metadata warning.
  - Keep `wire_api = "responses"`. FlexInference serves that surface at `/v1/responses`.
  - Never add `service_tier`. FlexInference derives the tier from the key's deadline and returns `400 service_tier_not_allowed` if the request carries its own.
  - `env_key` and `auth` are mutually exclusive. Use `env_key` unless I ask for a keychain helper.
  - Do not set `request_max_retries`. My key may carry its own retry policy and the two stack.

  Verify by checking the file parses under `codex --profile flexinference --strict-config`, then report what you changed.
  ```
</Accordion>

## Codex konfigurieren

Codex speichert jedes Profil in einer eigenen Datei. Dieses Profil lässt Ihre übliche Codex-Einrichtung unberührt, und Sie können es pro Ausführung mit `--profile` aktivieren.

1. Erstellen Sie die Profildatei. Fügen Sie dies einmal ein:

```bash theme={null}
mkdir -p ~/.codex && cat > ~/.codex/flexinference.config.toml <<'EOF'
model = "gpt-5.6-sol"
model_provider = "flexinference"

[model_providers.flexinference]
name = "FlexInference"
base_url = "https://api.flexinference.com/v1"
wire_api = "responses"
env_key = "FLEX_API_KEY"
EOF
```

2. Exportieren Sie den Schlüssel, den Codex liest. Die Profildatei enthält ihn niemals.

```bash theme={null}
export FLEX_API_KEY=flex_live_...
```

3. Starten Sie Codex mit dem Profil.

```bash theme={null}
codex --profile flexinference
```

Das ist die gesamte Integration. Codex ruft `/v1/responses` auf, sendet den Schlüssel als Bearer-Token, und der Schlüssel liefert die Deadline. Der Session-Header benennt den verwendeten Provider, sodass Sie sehen können, dass das Profil übernommen wurde.

Um uns stattdessen bei jeder Codex-Ausführung zu erreichen, fügen Sie dieselben Zeilen in `~/.codex/config.toml` ein. Die dortigen Top-Level-Felder `model` und `model_provider` legen Ihre Standardeinstellungen fest.

`env_key` und `auth` schließen sich gegenseitig aus. `env_key` liest den Schlüssel aus Ihrer Umgebung, was der kurze Weg ist. Bewahren Sie Geheimnisse stattdessen in einem Keychain auf, dann lassen Sie `env_key` weg und benennen einen Helper-Befehl in `auth`.

Behalten Sie die `model`-Zeile bei. Andernfalls verwendet Codex standardmäßig einen Slug, der auf `-codex` endet, für den wir keinen Preis haben und niemals racen. Verwenden Sie den vollständigen `gpt-5.6-sol`, da der bloße Alias `gpt-5.6` dazu führt, dass Codex eine Metadatenwarnung ausgibt.

## Bestätigen, dass der Schlüssel angewendet wurde

Jede Antwort enthält `x-flexinference-defaults-applied`. Codex zeigt keine Antwort-Header an, daher lesen Sie die Anfrage stattdessen im Dashboard unter **Logs**.

## Fehlerbehebung

**Nichts erreicht uns überhaupt.** Sie haben ein einfaches `codex` ausgeführt, das Ihren üblichen Provider und Ihr Konto verwendet. Starten Sie es mit `--profile flexinference`. Alle Fehler, die Sie gesehen haben, sind deren Fehler, einschließlich Nutzungslimits, und der Session-Header benennt den verwendeten Provider.

**[`400 model_not_priced_for_managed`](/de/errors#model_not_priced_for_managed).** `model` ist nicht gesetzt, daher kam die Anfrage mit einem `-codex`-Slug an, für den wir keinen Preis haben. Setzen Sie `model = "gpt-5.6-sol"` im Profil. Mit Ihrem eigenen Provider-Schlüssel führen wir stattdessen diesen Slug aus, ohne eigene Kostenangabe.

**[`400 service_tier_not_allowed`](/de/errors#service_tier_not_allowed).** Das Profil setzt `service_tier`, und wir lesen den Tier stattdessen aus der Deadline. Entfernen Sie die Zeile.

**[`400 key_default_not_applicable`](/de/errors#key_default_not_applicable) benennt eine gepinnte Route.** Die Anfrage pinnt eine Cloud-Route wie `foundry`, die keinen günstigen Tier zum Racen hat. Entfernen Sie die gepinnte Route oder bearbeiten Sie den Schlüssel zu einem Tier.

**Jede Anfrage verbraucht ein volles Retry-Budget.** Codex hat seine eigenen `request_max_retries`, und eine Schlüssel-`retry`-Richtlinie stapelt sich damit. Setzen Sie entweder das eine oder das andere, nicht beides.

**Der Cursor wartet.** **Flex race** kostet weniger und startet später, was Sie in einer interaktiven Schleife spüren. Bearbeiten Sie die Deadline des Schlüssels auf **Priority** oder **Standard**. Die nächste Anfrage übernimmt dies ohne Neustart.

Siehe [Fehler](/de/errors) für jede Ablehnung, die wir zurückgeben, und [Agent-Schlüssel](/de/agent-keys) für diejenigen, die nicht spezifisch für Codex sind.