Gebruik Codex met CometAPI

Gebruik deze gids om Codex met CometAPI als modelprovider uit te voeren. Officiële referenties:

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
CometAPI API-sleutel	Haal er een op via het CometAPI-dashboard
Model ID	Gebruik een model ID van de Models-pagina

Kies een configuratiepad

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

Optie 1: Codex handmatig configureren (aanbevolen)

Bewerk het gebruikersniveaubestand ~/.codex/config.toml direct. Dit is de meest betrouwbare aanpak, vooral voor Windows- en WSL-gebruikers.

Optie 2: Configureren via script

Voer het installatiescript uit als snelle route. Het schrijft dezelfde providerconfiguratie en slaat de CometAPI API-sleutel op voor Codex.

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.

macOS / Linux / WSL
Windows PowerShell

Sla je CometAPI API key op in een lokaal sleutelbestand:

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:

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\""]

Sla je CometAPI API key op in de Windows Codex-homemap:

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:

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()",
]

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.

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:

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"

Combineer env_key niet met [model_providers.cometapi.auth]. Codex ondersteunt één authenticatiemethode per aangepaste provider.

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:

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:

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 -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 -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

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.

Kies of wijzig een model ID

Gebruik een model ID van de Models-pagina. 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:

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 -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Het script gebruikt CODEX_HOME wanneer die is ingesteld. Anders schrijft het naar ~/.codex van de huidige omgeving.

Verifieer de setup

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

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

Codex gebruikt nog steeds de standaard OpenAI-provider

Controleer of model_provider = "cometapi" in het gebruikersniveaubestand ~/.codex/config.toml staat.

De API-sleutel is gewijzigd

Werk ~/.codex/cometapi_key bij, of voer het setupscript opnieuw uit met de bijgewerkte waarde van $COMETAPI_KEY.

Het PowerShell-script mislukt tijdens pre-flight-controles

Gebruik de handmatige native Windows PowerShell-stappen en voer daarna de verificatieopdracht uit.

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.

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.

Het model is niet gevonden

Bekijk de pagina Models voor beschikbare model IDs.

Windows-setup beïnvloedt de verkeerde omgeving

Bewerk $HOME\.codex voor de native Windows-modus, of bewerk ~/.codex binnen WSL voor de WSL-agentmodus.

Overzicht

AI-codeeragents

AI-agents

AI-chatclients

Vertaling en taal

Automatiseringsplatforms

Observeerbaarheid en evaluatie

AI-frameworks

Vereisten

Kies een configuratiepad

Optie 1: Codex handmatig configureren (aanbevolen)

Optie 2: Configureren via script

Codex handmatig configureren

Authenticatie via omgevingsvariabele gebruiken

Voer het setupscript uit

Kies of wijzig een model ID

Verifieer de setup

Probleemoplossing

​Vereisten

​Kies een configuratiepad

Optie 1: Codex handmatig configureren (aanbevolen)

Optie 2: Configureren via script

​Codex handmatig configureren

​Authenticatie via omgevingsvariabele gebruiken

​Voer het setupscript uit

​Kies of wijzig een model ID

​Verifieer de setup

​Probleemoplossing

Vereisten

Kies een configuratiepad

Codex handmatig configureren

Authenticatie via omgevingsvariabele gebruiken

Voer het setupscript uit

Kies of wijzig een model ID

Verifieer de setup

Probleemoplossing