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

# Codex config.toml: eigener Provider, Base URL und API Key

> Konfiguriere Codex config.toml für einen eigenen Provider: setze model_provider, Base URL, API-Key-env_key und wire_api responses und behebe 401-, 404- oder Modellfehler.

## Direkte Antwort

Um einen eigenen Provider in Codex CLI zu verwenden, bearbeite die `~/.codex/config.toml` auf Nutzerebene. Setze `model_provider = "custom"`, definiere `[model_providers.custom]`, verwende `https://www.bettertoken.ai/v1` als Base URL und setze `wire_api = "responses"`. Lies den BetterToken API Key über `env_key` und kopiere die Model ID vom **GPT-Provider**.

## Die richtige Konfigurationsdatei finden

| Umgebung      | Konfiguration auf Nutzerebene            |
| ------------- | ---------------------------------------- |
| macOS / Linux | `~/.codex/config.toml`                   |
| Windows       | `%USERPROFILE%\.codex\config.toml`       |
| Windows + WSL | `~/.codex/config.toml` innerhalb von WSL |

Klicke in der Codex-Erweiterung für VS Code auf das Zahnradsymbol und wähle **Codex Settings → Open config.toml**. Die CLI und IDE-Erweiterung teilen dieselben Konfigurationsebenen.

<Warning>
  Provider- und Authentifizierungseinstellungen gehören in die `~/.codex/config.toml` auf Nutzerebene. Projektdateien `.codex/config.toml` können Projektüberschreibungen enthalten, doch Codex ignoriert dort `model_provider` und `model_providers`. Lege Projektanweisungen in `AGENTS.md` ab.
</Warning>

## Minimale funktionsfähige Konfiguration

<Steps>
  <Step title="API-Key-Umgebungsvariable setzen">
    macOS, Linux oder WSL:

    ```bash theme={null}
    export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"
    ```

    Windows PowerShell:

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("MODEL_PROVIDER_API_KEY", "YOUR_API_KEY", "User")
    $env:MODEL_PROVIDER_API_KEY = "YOUR_API_KEY"
    ```

    Ersetze `YOUR_API_KEY` durch deinen BetterToken API Key. Speichere ihn für dauerhafte Nutzung in einer geschützten Betriebssystemumgebung, nicht im Projekt-Repository.
  </Step>

  <Step title="config.toml bearbeiten">
    ```toml theme={null}
    model_provider = "custom"
    model = "gpt-5.5"

    [model_providers.custom]
    name = "BetterToken"
    base_url = "https://www.bettertoken.ai/v1"
    env_key = "MODEL_PROVIDER_API_KEY"
    wire_api = "responses"
    requires_openai_auth = false
    ```

    `model` ist ein Beispiel. Kopiere eine aktuell verfügbare Model ID vom **GPT-Provider** in der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>.
  </Step>

  <Step title="Neu starten und testen">
    Beende Codex vollständig, öffne ein neues Terminal und führe Folgendes aus:

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

    Sende einen einfachen Prompt. Eine normale Antwort bestätigt, dass Provider, Authentifizierung und Model ID aktiv sind.
  </Step>
</Steps>

## Empfohlene vollständige Konfiguration

Verwende diese Version, wenn du ein Review-Modell und einen längeren Stream-Timeout benötigst:

```toml theme={null}
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false
```

Führe vorhandene Felder der obersten Ebene und Inhalte von `[model_providers.custom]` zusammen. Deklariere dieselbe TOML-Tabelle nicht zweimal.

## Wie die Felder zusammenwirken

| Feld                       | Zweck                                         | BetterToken-Wert                                      |
| -------------------------- | --------------------------------------------- | ----------------------------------------------------- |
| `model_provider`           | Wählt eine Provider-ID aus                    | `"custom"`                                            |
| `[model_providers.custom]` | Definiert diesen Provider                     | Muss zu `model_provider` passen                       |
| `base_url`                 | Modell-Request-Endpunkt                       | `https://www.bettertoken.ai/v1`                       |
| `env_key`                  | Benennt die Umgebungsvariable mit dem API Key | `MODEL_PROVIDER_API_KEY`                              |
| `wire_api`                 | Provider-Protokoll                            | `"responses"`                                         |
| `requires_openai_auth`     | Verwendet offizielle OpenAI-Authentifizierung | `false` für die normale Drittanbieter-API-Einrichtung |
| `model`                    | Standard-Model-ID                             | Eine aktuelle GPT-Provider-ID                         |

<Note>
  Um die offizielle Codex-App-Anmeldung, Plugins und Remote Control bei Nutzung einer Drittanbieter-API beizubehalten, verwende statt dieses normalen Authentifizierungsbeispiels die spezielle [Einrichtung für offizielle Anmeldung und einheitliche Sitzung](/de/faq/codex/official-login-third-party-api).
</Note>

## Häufige Fehler

| Symptom                            | Ursache                                                          | Lösung                                                                                          |
| ---------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Provider nicht gefunden            | `model_provider` stimmt nicht mit dem Tabellennamen überein      | Verwende an beiden Stellen `custom`                                                             |
| API Key beim Start fehlt           | Umgebungsvariable fehlt oder Terminal hat sie nicht neu geladen  | Setze `MODEL_PROVIDER_API_KEY` und öffne ein neues Terminal                                     |
| `401` oder `403`                   | Falscher Key oder gemischte Authentifizierungsmethoden           | Kopiere den Key erneut; halte den Namen von `env_key` gleich und `requires_openai_auth = false` |
| `404`                              | Der Base URL fehlt `/v1` oder nutzt das falsche Protokoll        | Verwende `https://www.bettertoken.ai/v1`                                                        |
| Modell nicht gefunden              | Model ID ist nicht verfügbar oder nicht im GPT-Provider          | Kopiere eine aktuelle ID aus der model plaza                                                    |
| Änderungen werden nicht übernommen | Falsche Konfigurationsebene, falscher Pfad oder WSL-Umgebung     | Bearbeite die Nutzerkonfiguration in der Umgebung, die Codex ausführt, und starte Codex neu     |
| TOML-Analysefehler                 | Doppelte Tabelle, Anführungszeichen- oder Verschachtelungsfehler | Entferne doppelte `[model_providers.custom]`-Tabellen und prüfe String-Anführungszeichen        |

## Verwandte Dokumentation

* [Vollständige Codex-Einrichtungsanleitung](/de/ai-tools/codex)
* [Eigene Base URL in der Codex-Erweiterung für VS Code konfigurieren](/de/ai-tools/codex-vscode)
* [model\_provider, base\_url und wire\_api erklärt](/de/faq/codex/model-provider-base-url-wire-api)
* [Codex CLI Sandbox- und Freigabemodus](/de/faq/codex/sandbox-approval)
* [Was ist AGENTS.md?](/de/faq/codex/agents-md)

## Referenzen

* [Grundlegende Codex-Konfiguration](https://developers.openai.com/codex/config-basic)
* [Codex-Konfigurationsreferenz](https://developers.openai.com/codex/config-reference)