Passer au contenu principal
Utilisez ce guide pour exécuter Codex CLI avec CometAPI comme fournisseur de modèles. Références officielles :
La disponibilité des modèles change fréquemment. Les exemples ci-dessous utilisent your-model-id — remplacez-le par un identifiant de modèle actuel adapté au code depuis la page des modèles CometAPI.

Prérequis

ExigenceDétails
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), ou Windows 11 via WSL2
Node.js22+ (LTS recommandé)
Git2.23+ recommandé
Clé CometAPIObtenez-en une depuis le tableau de bord CometAPI (commence par sk-)

Installer Codex CLI

npm i -g @openai/codex
Ou via Homebrew :
brew install --cask codex
Vérifiez l’installation :
codex --version

Configurer CometAPI

Il existe deux façons de faire pointer Codex vers CometAPI. Choisissez celle qui convient le mieux à votre workflow.
L’option la plus simple — rediriger le fournisseur OpenAI intégré vers CometAPI avec une seule ligne. Pas besoin de définir un fournisseur personnalisé.Créez ~/.codex/config.toml :
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Stocker votre clé API

Créez ~/.codex/auth.json :
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Remplacez sk-your-cometapi-key par votre véritable clé CometAPI.
Ce fichier est obligatoire. Sans entrée OPENAI_API_KEY valide dans auth.json, Codex se ferme avec API key auth is missing a key.

Démarrer Codex

cd your-project
codex
Au premier lancement, Codex vous demande de choisir un thème et de confirmer les paramètres de sécurité.

Remplacer le modèle pour une session

Basculez vers un autre modèle pour une seule exécution sans modifier config.toml :
codex --model your-model-id

Alternative : variable d’environnement

Au lieu de auth.json, exportez directement la clé :
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
Cela définit la clé uniquement pour la session de terminal en cours. Pour la conserver, ajoutez la ligne export à ~/.zshrc ou ~/.bashrc.

Dépannage

SymptômeCorrectif
API key auth is missing a keyAssurez-vous que ~/.codex/auth.json contient "OPENAI_API_KEY": "sk-..."
L’invite de connexion apparaît de manière inattendueSupprimez l’ancien ~/.codex/auth.json et recréez-le avec votre clé CometAPI
Modèle introuvableConsultez la page des modèles pour voir les modèles actuellement disponibles
Délai d’attente de connexionVérifiez que openai_base_url ou base_url vaut https://api.cometapi.com/v1 dans config.toml
Problèmes sous WindowsCodex nécessite WSL2 sous Windows — CMD/PowerShell natif n’est pas pris en charge