Utiliser Codex avec CometAPI

Utilisez ce guide pour exécuter Codex avec CometAPI comme fournisseur de modèles. Références officielles :

Prérequis

Exigence	Détails
OS	macOS, Linux, Windows PowerShell natif, ou Windows avec WSL
Git	2.23+ recommandé
Codex	Installez l’application Codex ou le Codex CLI depuis le guide de démarrage Codex
Clé d’API CometAPI	Obtenez-en une depuis le tableau de bord CometAPI
Model ID	Utilisez un model ID depuis la page Models

Choisissez une méthode de configuration

Nous proposons deux options pour vous aider à configurer Codex rapidement.

Option 1: Configurer Codex manuellement (recommandé)

Modifiez directement le fichier ~/.codex/config.toml au niveau utilisateur. C’est la méthode la plus fiable, en particulier pour les utilisateurs de Windows et WSL.

Option 2: Configurer via un script

Exécutez le script d’installation comme raccourci. Il écrit la même configuration de fournisseur et stocke la clé d’API CometAPI pour Codex.

Configurer Codex manuellement

Codex lit les paramètres par défaut du fournisseur personnel à partir du fichier ~/.codex/config.toml au niveau utilisateur. Configurez le fournisseur CometAPI à cet endroit, et non dans un fichier de projet .codex/config.toml. Codex ignore les paramètres provider et provider-auth dans les fichiers de configuration de projet. La configuration recommandée utilise un fournisseur nommé cometapi et une authentification adossée à une commande. Cela permet de garder CometAPI séparé du fournisseur OpenAI intégré, ne nécessite pas l’héritage des variables d’environnement du shell et ne remplace pas ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Stockez votre clé API CometAPI dans un fichier de clé local :

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Ajoutez cette configuration à ~/.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\""]

Stockez votre clé API CometAPI dans le répertoire d’accueil Codex de Windows :

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Ajoutez cette configuration à $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()",
]

Codex natif sur Windows utilise $HOME\.codex, généralement C:\Users\<user>\.codex. WSL utilise le ~/.codex de la distribution Linux. Modifiez le répertoire correspondant à l’environnement dans lequel l’agent Codex s’exécute.

Utiliser l’authentification par variable d’environnement

Si vous préférez conserver la clé API CometAPI dans une variable d’environnement, utilisez env_key au lieu du bloc [model_providers.cometapi.auth]. Utilisez cette configuration de fournisseur uniquement lorsque COMETAPI_KEY est disponible dans l’environnement qui lance Codex :

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"

Ne combinez pas env_key avec [model_providers.cometapi.auth]. Codex prend en charge une seule méthode d’authentification par fournisseur personnalisé.

Exécuter le script de configuration

Le script de configuration est facultatif. Il écrit la même configuration du provider cometapi dans ~/.codex/config.toml, stocke votre clé d’API CometAPI dans ~/.codex/cometapi_key, crée des sauvegardes avant les modifications de fichiers et vérifie la configuration avec codex exec lorsque le CLI Codex est disponible. Pour macOS, Linux ou WSL, exécutez l’installateur interactif :

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Pour une configuration non interactive, transmettez explicitement la clé d’API :

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Pour PowerShell natif sous Windows, exécutez l’installateur interactif :

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Pour une configuration Windows non interactive, transmettez explicitement la clé d’API :

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

Par défaut, le script ne remplace pas ~/.codex/auth.json et ne supprime pas une connexion ChatGPT. Utilisez --force-auth-json ou -ForceAuthJson uniquement si vous voulez que le script gère la connexion par clé d’API Codex via auth.json.

Choisir ou modifier un model ID

Utilisez un model ID depuis la page Models. En configuration manuelle, modifiez la valeur de model dans ~/.codex/config.toml. Pour macOS, Linux ou WSL, transmettez --model lorsque vous exécutez le script de configuration :

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Pour PowerShell natif sous Windows, transmettez -Model lorsque vous exécutez le script de configuration :

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

Le script utilise CODEX_HOME lorsqu’il est défini. Sinon, il écrit dans le ~/.codex de l’environnement actuel.

Vérifier la configuration

Pour vérifier la configuration avec le CLI Codex, exécutez cette commande en lecture seule depuis n’importe quel projet local :

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Si le CLI Codex n’est pas disponible dans PATH, ouvrez l’application Codex et envoyez un court Prompt depuis un projet local.

Dépannage

Codex utilise toujours le fournisseur OpenAI par défaut

Vérifiez que model_provider = "cometapi" se trouve dans le fichier ~/.codex/config.toml au niveau utilisateur.

La clé API a changé

Mettez à jour ~/.codex/cometapi_key, ou réexécutez le script d’installation avec la valeur $COMETAPI_KEY mise à jour.

Le script PowerShell échoue pendant les vérifications préalables

Utilisez les étapes manuelles de PowerShell natif Windows, puis exécutez la commande de vérification.

La configuration shell via un pipeline ne demande aucune clé API

Utilisez --key "$COMETAPI_KEY", définissez COMETAPI_KEY, ou exécutez la commande interactive sh -c "$(curl ...)".

La connexion expire ou utilise la mauvaise URL de base

Vérifiez que base_url est défini sur https://api.cometapi.com/v1 dans ~/.codex/config.toml.

Le modèle est introuvable

Consultez la page Models pour voir les model IDs disponibles.

La configuration Windows affecte le mauvais environnement

Modifiez $HOME\.codex pour le mode natif Windows, ou modifiez ~/.codex dans WSL pour le mode agent WSL.

La connexion ChatGPT a changé

N’utilisez pas --force-auth-json ou -ForceAuthJson sauf si vous souhaitez le mode de connexion par clé API.

Vue d'ensemble

Agents de codage IA

Agents IA

Clients de chat IA

Traduction et langue

Plateformes d’automatisation

Observabilité et évaluation

Frameworks IA

Prérequis

Choisissez une méthode de configuration

Option 1: Configurer Codex manuellement (recommandé)

Option 2: Configurer via un script

Configurer Codex manuellement

Utiliser l’authentification par variable d’environnement

Exécuter le script de configuration

Choisir ou modifier un model ID

Vérifier la configuration

Dépannage

​Prérequis

​Choisissez une méthode de configuration

Option 1: Configurer Codex manuellement (recommandé)

Option 2: Configurer via un script

​Configurer Codex manuellement

​Utiliser l’authentification par variable d’environnement

​Exécuter le script de configuration

​Choisir ou modifier un model ID

​Vérifier la configuration

​Dépannage

Prérequis

Choisissez une méthode de configuration

Configurer Codex manuellement

Utiliser l’authentification par variable d’environnement

Exécuter le script de configuration

Choisir ou modifier un model ID

Vérifier la configuration

Dépannage