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

# Codex mit CometAPI verwenden

> Verwenden Sie diese Anleitung, um Codex mit CometAPI zu konfigurieren, indem Sie die provider-Einstellungen in der benutzerspezifischen config.toml bearbeiten.

Verwenden Sie diese Anleitung, um [Codex](https://developers.openai.com/codex/quickstart) mit CometAPI als model provider auszuführen.

Offizielle Referenzen:

* [Codex quickstart](https://developers.openai.com/codex/quickstart)
* [Codex config basics](https://developers.openai.com/codex/config-basic)
* [Codex custom model providers](https://developers.openai.com/codex/config-advanced#custom-model-providers)
* [Codex Authentication](https://developers.openai.com/codex/auth)
* [Codex on Windows](https://developers.openai.com/codex/windows)

## Voraussetzungen

| Anforderung      | Details                                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
| OS               | macOS, Linux, natives PowerShell unter Windows oder Windows mit WSL                                                      |
| Git              | 2.23+ empfohlen                                                                                                          |
| Codex            | Installieren Sie die Codex-App oder Codex CLI aus dem [Codex quickstart](https://developers.openai.com/codex/quickstart) |
| CometAPI API key | Holen Sie sich einen im [CometAPI-Dashboard](https://www.cometapi.com/console/token)                                     |
| Model ID         | Verwenden Sie eine model ID von der [Models-Seite](/de/overview/models)                                                  |

## Wählen Sie einen Einrichtungsweg

Wir bieten zwei Optionen, damit Sie Codex schnell konfigurieren können.

<CardGroup cols={2}>
  <Card title="Option 1: Codex manuell konfigurieren (empfohlen)" icon="bolt" href="#configure-codex-manually">
    Bearbeiten Sie die benutzerspezifische Datei `~/.codex/config.toml` direkt. Dies ist der zuverlässigste Weg, insbesondere für Windows- und WSL-Benutzer.
  </Card>

  <Card title="Option 2: Über ein Skript konfigurieren" icon="puzzle-piece" href="#run-the-setup-script">
    Führen Sie das Einrichtungs-Skript als Abkürzung aus. Es schreibt dieselbe provider-Konfiguration und speichert den CometAPI API key für Codex.
  </Card>
</CardGroup>

## Codex manuell konfigurieren

Codex liest persönliche Provider-Standardeinstellungen aus der benutzerspezifischen Datei `~/.codex/config.toml`. Konfigurieren Sie den CometAPI-Provider dort, nicht in einer Projektdatei `.codex/config.toml`. Codex ignoriert `provider`- und `provider-auth`-Einstellungen in Projektkonfigurationsdateien.

Die empfohlene Einrichtung verwendet einen benannten `cometapi`-Provider und befehlsbasierte Authentifizierung. Dadurch bleibt CometAPI vom integrierten OpenAI-Provider getrennt, erfordert keine Vererbung von Shell-Umgebungsvariablen und ersetzt `~/.codex/auth.json` nicht.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    Speichern Sie Ihren CometAPI-API-Schlüssel in einer lokalen Schlüsseldatei:

    ```bash theme={null}
    mkdir -p "$HOME/.codex"
    printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
    chmod 600 "$HOME/.codex/cometapi_key"
    ```

    Fügen Sie diese Konfiguration zu `~/.codex/config.toml` hinzu:

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "sh"
    args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    Speichern Sie Ihren CometAPI-API-Schlüssel im Windows-Codex-Home-Verzeichnis:

    ```powershell theme={null}
    New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
    Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY
    ```

    Fügen Sie diese Konfiguration zu `$HOME\.codex\config.toml` hinzu:

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "powershell.exe"
    args = [
      "-NoProfile",
      "-Command",
      "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
    ]
    ```
  </Tab>
</Tabs>

<Note>
  Windows-natives Codex verwendet `$HOME\.codex`, normalerweise `C:\Users\<user>\.codex`. WSL verwendet das `~/.codex` der Linux-Distribution. Bearbeiten Sie das Verzeichnis, das der Umgebung entspricht, in der der Codex-Agent ausgeführt wird.
</Note>

## Authentifizierung mit Umgebungsvariablen verwenden

Wenn Sie den CometAPI-API-Schlüssel lieber in einer Umgebungsvariablen speichern möchten, verwenden Sie `env_key` anstelle des Blocks `[model_providers.cometapi.auth]`.

Verwenden Sie diese Provider-Konfiguration nur, wenn `COMETAPI_KEY` in der Umgebung verfügbar ist, die Codex startet:

```toml theme={null}
model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"
```

<Warning>
  Kombinieren Sie `env_key` nicht mit `[model_providers.cometapi.auth]`. Codex unterstützt pro benutzerdefiniertem Provider eine Authentifizierungsmethode.
</Warning>

## Das Setup-Skript ausführen

Das Setup-Skript ist optional. Es schreibt dieselbe `cometapi`-Provider-Konfiguration nach `~/.codex/config.toml`, speichert Ihren CometAPI-API-Schlüssel in `~/.codex/cometapi_key`, erstellt vor Dateiänderungen Sicherungskopien und überprüft die Konfiguration mit `codex exec`, wenn die Codex CLI verfügbar ist.

Führen Sie für macOS, Linux oder WSL das interaktive Installationsprogramm aus:

```bash theme={null}
sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"
```

Für ein nicht interaktives Setup übergeben Sie den API-Schlüssel explizit:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"
```

Führen Sie für natives Windows PowerShell das interaktive Installationsprogramm aus:

```powershell theme={null}
powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"
```

Für ein nicht interaktives Windows-Setup übergeben Sie den API-Schlüssel explizit:

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"
```

<Warning>
  Standardmäßig ersetzt das Skript `~/.codex/auth.json` nicht und entfernt kein ChatGPT-Login. Verwenden Sie `--force-auth-json` oder `-ForceAuthJson` nur, wenn das Skript die Codex-API-Key-Anmeldung über `auth.json` verwalten soll.
</Warning>

## Einen model ID auswählen oder ändern

Verwenden Sie einen model ID von der Seite [Models](/de/overview/models). Bei der manuellen Konfiguration ändern Sie den Wert von `model` in `~/.codex/config.toml`.

Übergeben Sie für macOS, Linux oder WSL `--model`, wenn Sie das Setup-Skript ausführen:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id
```

Übergeben Sie für natives Windows PowerShell `-Model`, wenn Sie das Setup-Skript ausführen:

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"
```

<Note>
  Das Skript verwendet `CODEX_HOME`, wenn es gesetzt ist. Andernfalls schreibt es in das `~/.codex` der aktuellen Umgebung.
</Note>

## Das Setup überprüfen

Um das Setup mit der Codex CLI zu überprüfen, führen Sie diesen schreibgeschützten Befehl aus einem beliebigen lokalen Projekt aus:

```bash theme={null}
codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"
```

Wenn die Codex CLI in `PATH` nicht verfügbar ist, öffnen Sie die Codex-App und senden Sie einen kurzen Prompt aus einem lokalen Projekt.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Codex verwendet weiterhin den standardmäßigen OpenAI-Provider">
    Bestätige, dass `model_provider = "cometapi"` in der benutzerspezifischen Datei `~/.codex/config.toml` steht.
  </Accordion>

  <Accordion title="Der API-Schlüssel wurde geändert">
    Aktualisiere `~/.codex/cometapi_key`, oder führe das Setup-Skript mit dem aktualisierten Wert `$COMETAPI_KEY` erneut aus.
  </Accordion>

  <Accordion title="Das PowerShell-Skript schlägt während der Vorabprüfungen fehl">
    Verwende die manuellen nativen PowerShell-Schritte für Windows und führe dann den Verifizierungsbefehl aus.
  </Accordion>

  <Accordion title="Das per Pipe übergebene Shell-Setup fragt nach keinem API-Schlüssel">
    Verwende `--key "$COMETAPI_KEY"`, setze `COMETAPI_KEY` oder führe den interaktiven Befehl `sh -c "$(curl ...)"` aus.
  </Accordion>

  <Accordion title="Die Verbindung läuft in ein Timeout oder verwendet die falsche base URL">
    Bestätige, dass `base_url` in `~/.codex/config.toml` auf `https://api.cometapi.com/v1` gesetzt ist.
  </Accordion>

  <Accordion title="Das Modell wurde nicht gefunden">
    Sieh auf der Seite [Models](/de/overview/models) nach den verfügbaren model IDs.
  </Accordion>

  <Accordion title="Das Windows-Setup wirkt sich auf die falsche Umgebung aus">
    Bearbeite `$HOME\.codex` für den nativen Windows-Modus oder `~/.codex` innerhalb von WSL für den WSL-Agent-Modus.
  </Accordion>

  <Accordion title="Der ChatGPT-Login wurde geändert">
    Verwende `--force-auth-json` oder `-ForceAuthJson` nicht, es sei denn, du möchtest den API-Schlüssel-Anmeldemodus verwenden.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/codex#howto",
        "name": "Codex mit CometAPI verwenden",
        "description": "Verwende diese Anleitung, um Codex mit CometAPI zu konfigurieren, indem du die Provider-Einstellungen in der benutzerspezifischen config.toml bearbeitest.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-1",
            "position": 1,
            "name": "Voraussetzungen prüfen",
            "text": "Schließe den Schritt „Voraussetzungen prüfen“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-2",
            "position": 2,
            "name": "Einen Setup-Pfad auswählen",
            "text": "Schließe den Schritt „Einen Setup-Pfad auswählen“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-3",
            "position": 3,
            "name": "Codex manuell konfigurieren",
            "text": "Schließe den Schritt „Codex manuell konfigurieren“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-4",
            "position": 4,
            "name": "Authentifizierung über Umgebungsvariablen verwenden",
            "text": "Schließe den Schritt „Authentifizierung über Umgebungsvariablen verwenden“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-5",
            "position": 5,
            "name": "Das Setup-Skript ausführen",
            "text": "Schließe den Schritt „Das Setup-Skript ausführen“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-6",
            "position": 6,
            "name": "Eine model ID auswählen oder ändern",
            "text": "Schließe den Schritt „Eine model ID auswählen oder ändern“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-7",
            "position": 7,
            "name": "Das Setup verifizieren",
            "text": "Schließe den Schritt „Das Setup verifizieren“ in der Anleitung „Codex mit CometAPI verwenden“ ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Codex mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/codex"
          }
        ]
      }
    ]
    }
    `}
</script>