Codex CLI

Stel OpenAI Codex CLI in met CometAPI: configureer openai_base_url of een aangepaste provider in config.toml, sla je API-sleutel op in auth.json en begin met coderen met een actueel model.

Gebruik deze handleiding om Codex CLI met CometAPI als modelprovider uit te voeren.

Officiële referenties:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

Beschikbaarheid van modellen verandert regelmatig. De voorbeelden hieronder gebruiken your-model-id — vervang dit door een actuele model-ID die geschikt is voor coderen van de CometAPI Models page.

​

Vereisten

Vereiste	Details
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), of Windows 11 via WSL2
Node.js	22+ (LTS aanbevolen)
Git	2.23+ aanbevolen
CometAPI-sleutel	Haal er een op via CometAPI Dashboard (begint met sk-)

​

Installeer Codex CLI

npm i -g @openai/codex

Of via Homebrew:

brew install --cask codex

Controleer de installatie:

codex --version

​

Configureer CometAPI

Er zijn twee manieren om Codex naar CometAPI te laten verwijzen. Kies wat het beste bij je workflow past.

Eenvoudig: openai_base_url

De eenvoudigste optie — stuur de ingebouwde OpenAI-provider met één regel door naar CometAPI. Je hoeft geen aangepaste provider te definiëren.

Maak ~/.codex/config.toml aan:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Benoemde provider

Definieer een benoemde cometapi-provider. Handig wanneer je wilt wisselen tussen meerdere providers met --profile of model_provider.

Maak ~/.codex/config.toml aan:

model = "your-model-id"
model_provider = "cometapi"

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

env_key vertelt Codex welke omgevingsvariabele je API-sleutel bevat. Codex leest de waarde van OPENAI_API_KEY tijdens runtime — dit is niet je daadwerkelijke sleutel.

​

Sla je API-sleutel op

Maak ~/.codex/auth.json aan:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Vervang sk-your-cometapi-key door je daadwerkelijke CometAPI-sleutel.

Dit bestand is verplicht. Zonder een geldige OPENAI_API_KEY-vermelding in auth.json sluit Codex af met API key auth is missing a key.

​

Start Codex

cd your-project
codex

Bij de eerste start vraagt Codex je om een thema te kiezen en de veiligheidsinstellingen te bevestigen.

​

Overschrijf het model per sessie

Schakel voor één uitvoering naar een ander model zonder config.toml te bewerken:

codex --model your-model-id

​

Alternatief: omgevingsvariabele

In plaats van auth.json kun je de sleutel direct exporteren:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Dit stelt de sleutel alleen in voor de huidige terminalsessie. Voor blijvende opslag voeg je de regel export toe aan ~/.zshrc of ~/.bashrc.

​

Probleemoplossing

Symptoom	Oplossing
API key auth is missing a key	Zorg dat ~/.codex/auth.json "OPENAI_API_KEY": "sk-..." bevat
Er verschijnt onverwacht een loginprompt	Verwijder verouderde ~/.codex/auth.json en maak het opnieuw aan met je CometAPI-sleutel
Model niet gevonden	Controleer de Models page voor momenteel beschikbare modellen
Time-out bij verbinding	Controleer of openai_base_url of base_url in config.toml is ingesteld op https://api.cometapi.com/v1
Problemen op Windows	Codex vereist WSL2 op Windows — native CMD/PowerShell wordt niet ondersteund