> ## 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.

# Gebruik Codex met CometAPI

> Gebruik deze gids om Codex met CometAPI te configureren door de providerinstellingen in het gebruikersniveaubestand config.toml te bewerken.

Gebruik deze gids om [Codex](https://developers.openai.com/codex/quickstart) met CometAPI als modelprovider uit te voeren.

Officiële referenties:

* [Codex quickstart](https://developers.openai.com/codex/quickstart)
* [Basisprincipes van Codex-configuratie](https://developers.openai.com/codex/config-basic)
* [Aangepaste modelproviders voor Codex](https://developers.openai.com/codex/config-advanced#custom-model-providers)
* [Codex-authenticatie](https://developers.openai.com/codex/auth)
* [Codex op Windows](https://developers.openai.com/codex/windows)

## Vereisten

| Vereiste             | Details                                                                                                        |
| -------------------- | -------------------------------------------------------------------------------------------------------------- |
| OS                   | macOS, Linux, native Windows PowerShell, of Windows met WSL                                                    |
| Git                  | 2.23+ aanbevolen                                                                                               |
| Codex                | Installeer de Codex-app of Codex CLI via de [Codex quickstart](https://developers.openai.com/codex/quickstart) |
| CometAPI API-sleutel | Haal er een op via het [CometAPI-dashboard](https://www.cometapi.com/console/token)                            |
| Model ID             | Gebruik een model ID van de [Models-pagina](/nl/overview/models)                                               |

## Kies een configuratiepad

We bieden twee opties om je te helpen Codex snel te configureren.

<CardGroup cols={2}>
  <Card title="Optie 1: Codex handmatig configureren (aanbevolen)" icon="bolt" href="#configure-codex-manually">
    Bewerk het gebruikersniveaubestand `~/.codex/config.toml` direct. Dit is de meest betrouwbare aanpak, vooral voor Windows- en WSL-gebruikers.
  </Card>

  <Card title="Optie 2: Configureren via script" icon="puzzle-piece" href="#run-the-setup-script">
    Voer het installatiescript uit als snelle route. Het schrijft dezelfde providerconfiguratie en slaat de CometAPI API-sleutel op voor Codex.
  </Card>
</CardGroup>

## Codex handmatig configureren

Codex leest persoonlijke providerstandaarden uit het gebruikersniveaubestand `~/.codex/config.toml`. Configureer daar de CometAPI-provider, niet in een projectbestand `.codex/config.toml`. Codex negeert provider- en provider-auth-instellingen in projectconfiguratiebestanden.

De aanbevolen configuratie gebruikt een benoemde `cometapi`-provider en authenticatie op basis van een commando. Hierdoor blijft CometAPI gescheiden van de ingebouwde OpenAI-provider, is overerving van shell-omgevingsvariabelen niet nodig en wordt `~/.codex/auth.json` niet vervangen.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    Sla je CometAPI API key op in een lokaal sleutelbestand:

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

    Voeg deze configuratie toe aan `~/.codex/config.toml`:

    ```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">
    Sla je CometAPI API key op in de Windows Codex-homemap:

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

    Voeg deze configuratie toe aan `$HOME\.codex\config.toml`:

    ```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 native Codex gebruikt `$HOME\.codex`, meestal `C:\Users\<user>\.codex`. WSL gebruikt de `~/.codex` van de Linux-distributie. Bewerk de map die overeenkomt met de omgeving waarin de Codex-agent draait.
</Note>

## Authenticatie via omgevingsvariabele gebruiken

Als je de CometAPI API key liever in een omgevingsvariabele bewaart, gebruik dan `env_key` in plaats van het blok `[model_providers.cometapi.auth]`.

Gebruik deze providerconfiguratie alleen wanneer `COMETAPI_KEY` beschikbaar is in de omgeving waarmee Codex wordt gestart:

```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>
  Combineer `env_key` niet met `[model_providers.cometapi.auth]`. Codex ondersteunt één authenticatiemethode per aangepaste provider.
</Warning>

## Voer het setupscript uit

Het setupscript is optioneel. Het schrijft dezelfde `cometapi` providerconfiguratie naar `~/.codex/config.toml`, slaat je CometAPI API-sleutel op in `~/.codex/cometapi_key`, maakt back-ups voordat bestanden worden gewijzigd en verifieert de configuratie met `codex exec` wanneer de Codex CLI beschikbaar is.

Voer voor macOS, Linux of WSL de interactieve installer uit:

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

Geef voor niet-interactieve setup de API-sleutel expliciet door:

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

Voer voor Windows native PowerShell de interactieve installer uit:

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

Geef voor niet-interactieve Windows-setup de API-sleutel expliciet door:

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

<Warning>
  Standaard vervangt het script `~/.codex/auth.json` niet en verwijdert het geen ChatGPT-login. Gebruik `--force-auth-json` of `-ForceAuthJson` alleen als je wilt dat het script de Codex API-sleutel-login beheert via `auth.json`.
</Warning>

## Kies of wijzig een model ID

Gebruik een model ID van de [Models-pagina](/nl/overview/models). Wijzig in handmatige configuratie de waarde van `model` in `~/.codex/config.toml`.

Geef voor macOS, Linux of WSL `--model` door wanneer je het setupscript uitvoert:

```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
```

Geef voor Windows native PowerShell `-Model` door wanneer je het setupscript uitvoert:

```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>
  Het script gebruikt `CODEX_HOME` wanneer die is ingesteld. Anders schrijft het naar `~/.codex` van de huidige omgeving.
</Note>

## Verifieer de setup

Voer deze alleen-lezen-opdracht uit vanuit een lokaal project om de setup te verifiëren met de Codex CLI:

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

Als de Codex CLI niet beschikbaar is in `PATH`, open dan de Codex-app en verstuur een korte prompt vanuit een lokaal project.

## Probleemoplossing

<AccordionGroup>
  <Accordion title="Codex gebruikt nog steeds de standaard OpenAI-provider">
    Controleer of `model_provider = "cometapi"` in het gebruikersniveaubestand `~/.codex/config.toml` staat.
  </Accordion>

  <Accordion title="De API-sleutel is gewijzigd">
    Werk `~/.codex/cometapi_key` bij, of voer het setupscript opnieuw uit met de bijgewerkte waarde van `$COMETAPI_KEY`.
  </Accordion>

  <Accordion title="Het PowerShell-script mislukt tijdens pre-flight-controles">
    Gebruik de handmatige native Windows PowerShell-stappen en voer daarna de verificatieopdracht uit.
  </Accordion>

  <Accordion title="De gepipete shell-setup vraagt om geen API-sleutel">
    Gebruik `--key "$COMETAPI_KEY"`, stel `COMETAPI_KEY` in, of voer de interactieve opdracht `sh -c "$(curl ...)"` uit.
  </Accordion>

  <Accordion title="De verbinding loopt vast of gebruikt de verkeerde base URL">
    Controleer of `base_url` gelijk is aan `https://api.cometapi.com/v1` in `~/.codex/config.toml`.
  </Accordion>

  <Accordion title="Het model is niet gevonden">
    Bekijk de [pagina Models](/nl/overview/models) voor beschikbare model IDs.
  </Accordion>

  <Accordion title="Windows-setup beïnvloedt de verkeerde omgeving">
    Bewerk `$HOME\.codex` voor de native Windows-modus, of bewerk `~/.codex` binnen WSL voor de WSL-agentmodus.
  </Accordion>

  <Accordion title="De ChatGPT-login is gewijzigd">
    Gebruik `--force-auth-json` of `-ForceAuthJson` niet, tenzij je de API-key-aanmeldmodus wilt gebruiken.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/codex#howto",
        "name": "Codex gebruiken met CometAPI",
        "description": "Gebruik deze handleiding om Codex met CometAPI te configureren door de providerinstellingen in config.toml op gebruikersniveau te bewerken.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-1",
            "position": 1,
            "name": "Vereisten bekijken",
            "text": "Voltooi de stap Vereisten bekijken in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-2",
            "position": 2,
            "name": "Een setup-pad kiezen",
            "text": "Voltooi de stap Een setup-pad kiezen in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-3",
            "position": 3,
            "name": "Codex handmatig configureren",
            "text": "Voltooi de stap Codex handmatig configureren in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-4",
            "position": 4,
            "name": "Authenticatie met omgevingsvariabele gebruiken",
            "text": "Voltooi de stap Authenticatie met omgevingsvariabele gebruiken in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-5",
            "position": 5,
            "name": "Het setupscript uitvoeren",
            "text": "Voltooi de stap Het setupscript uitvoeren in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-6",
            "position": 6,
            "name": "Een model ID kiezen of wijzigen",
            "text": "Voltooi de stap Een model ID kiezen of wijzigen in de handleiding Codex gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-7",
            "position": 7,
            "name": "De setup verifiëren",
            "text": "Voltooi de stap De setup verifiëren in de handleiding Codex gebruiken met CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Docs",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraties",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Codex gebruiken met CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/codex"
          }
        ]
      }
    ]
    }
    `}
</script>