configuration API personnalisée Codex CLI
Utilisez le mécanisme officiel de model provider de Codex pour accéder à 穷哥么. La clé reste dans une variable d’environnement et le fournisseur utilise l’API Responses.
Configuration rapide
- Commande d’installation
npm install -g @openai/codex- Fichier de configuration
~/.codex/config.toml- model_provider
qionggeme- base_url
https://qionggeme.com/v1- env_key
QIONGGEME_API_KEY- Il s’agit du nom de la variable d’environnement, pas de la clé API en clair.
- wire_api
responses- Le provider personnalisé officiel actuel doit utiliser Responses.
Ce guide utilise la configuration model_providers officiellement prise en charge par Codex. La clé API n’est pas inscrite dans le fichier TOML : elle est placée dans la variable QIONGGEME_API_KEY, puis référencée par env_key.
Créez d’abord une clé dans la console de jetons 穷哥么. Le modèle de l’exemple est gpt-5.3-codex-spark. La liste réellement accessible dépend de votre jeton ; la page des tarifs présente les modèles mis en avant.
Étapes de configuration
Installer Codex CLI
Installez le paquet npm officiel de façon globale :
npm install -g @openai/codex
Une fois l’installation terminée, la commande
codexlance le client en ligne de commande.Configurer ~/.codex/config.toml
Créez ou modifiez
~/.codex/config.tomlavec la configuration suivante :model_provider = "qionggeme" model = "gpt-5.3-codex-spark" [model_providers.qionggeme] name = "穷哥么" base_url = "https://qionggeme.com/v1" env_key = "QIONGGEME_API_KEY" wire_api = "responses"
La valeur de
env_keyest le nom de la variable que Codex doit lire, pas la clé elle-même. N’ajoutez pas de champapi_key.Définir la clé sur macOS ou Linux
Dans le terminal qui lancera Codex, définissez la variable :
export QIONGGEME_API_KEY="<VOTRE_CLÉ_API_QIONGGEME>"
Si vous ajoutez cette ligne à la configuration du shell, rechargez le fichier ou ouvrez un nouveau terminal avant de démarrer une nouvelle session Codex.
Définir la clé dans Windows PowerShell
Exécutez dans PowerShell :
$env:QIONGGEME_API_KEY="<VOTRE_CLÉ_API_QIONGGEME>"
Cette syntaxe vaut pour la session PowerShell courante. Lancez
codexdans la même fenêtre. Après toute modification de la variable ou du fichier TOML, fermez l’ancienne session Codex et redémarrez-la.Redémarrer la session Codex et vérifier
Après une modification du fichier ou des variables, arrêtez Codex puis exécutez à nouveau
codex. Si le modèle d’exemple ne figure pas dans la liste accessible à votre jeton, remplacez uniquement la valeurmodelpar un modèle compatible Codex réellement disponible. La page des tarifs peut servir de référence pour les modèles mis en avant.
Exemple de configuration
model_provider = "qionggeme" model = "gpt-5.3-codex-spark" [model_providers.qionggeme] name = "穷哥么" base_url = "https://qionggeme.com/v1" env_key = "QIONGGEME_API_KEY" wire_api = "responses" # macOS / Linux export QIONGGEME_API_KEY="<VOTRE_CLÉ_API_QIONGGEME>" # Windows PowerShell $env:QIONGGEME_API_KEY="<VOTRE_CLÉ_API_QIONGGEME>"
Dépannage
Codex signale que QIONGGEME_API_KEY est absente
Vérifiez que QIONGGEME_API_KEY est définie dans le terminal courant. env_key contient seulement le nom de la variable ; Codex lit la vraie clé dans l’environnement du processus. Redémarrez ensuite la session Codex.
Erreur 401 Unauthorized
Recopiez la clé depuis la console de jetons, vérifiez l’absence d’espace ou de guillemet superflu dans la variable, puis contrôlez l’état du jeton, le solde et les autorisations du modèle.
Erreur 404 ou mauvaise adresse de requête
Le champ base_url doit être exactement https://qionggeme.com/v1. Le provider Responses de Codex attend la Base URL OpenAI ; n’utilisez ni le domaine racine seul ni /docs.
Le provider personnalisé refuse le protocole ou l’interface
Vérifiez la ligne wire_api = "responses". Le provider personnalisé officiel actuel doit utiliser Responses, pas Chat Completions ni une autre valeur.
gpt-5.3-codex-spark est introuvable ou indisponible
Consultez d’abord la liste de modèles visible pour votre jeton dans la console. Si cet ID n’y figure pas, remplacez model par un modèle compatible Codex de cette liste. La page des tarifs ne montre que les modèles actuellement mis en avant.
Codex conserve l’ancienne configuration après modification
Confirmez que le fichier se trouve bien dans ~/.codex/config.toml, enregistrez-le, arrêtez l’ancien processus Codex puis ouvrez une nouvelle session. Une session déjà lancée ne recharge pas nécessairement le fichier immédiatement.
Prêt à commencer ?
Créez un compte 穷哥么 pour obtenir une clé API et accéder aux modèles disponibles.
Créer un compteQuestions fréquentes
env_key doit-il contenir la clé API ?
Non. env_key contient le nom QIONGGEME_API_KEY. La vraie clé est définie avec export ou avec $env dans PowerShell.
Puis-je ajouter un champ api_key dans config.toml ?
Ne le faites pas. Cette configuration suit le provider officiel et utilise env_key afin de ne pas stocker la clé en clair dans le fichier.
Puis-je remplacer wire_api par chat ?
Non. Le provider personnalisé officiel actuel doit utiliser wire_api = "responses".
Pourquoi la base_url de Codex contient-elle /v1 ?
Ce champ cible la Base URL de l’API OpenAI Responses, donc https://qionggeme.com/v1. N’utilisez ni le domaine racine seul ni l’adresse du site contenant /docs.
Faut-il redémarrer après une modification du TOML ou des variables ?
Oui. Fermez l’ancienne session Codex et relancez-la afin que le nouveau processus lise la configuration et l’environnement à jour.
Où vérifier les modèles Codex disponibles ?
Consultez en priorité la liste visible dans la console pour votre jeton. La page des tarifs présente les modèles mis en avant. Si l’ID d’exemple n’est pas disponible, remplacez-le par un modèle compatible Codex de la liste.