Codex : clé API ou connexion ChatGPT, réglages et facturation

Choisissez entre la connexion ChatGPT, une clé API officielle OpenAI et un fournisseur de Responses facturé séparément. Configurez BetterToken dans le fichier config.toml utilisateur, vérifiez les restrictions de pays et de carte, puis rapprochez l’authentification, le fournisseur et le relevé d’utilisation avant de travailler.

Sommaire
Codex : clé API ou connexion ChatGPT, réglages et facturation

Si Codex refuse la connexion ou si son utilisation apparaît sur une facture inattendue, vérifiez le mode d’authentification avant de changer de forfait. Pour travailler localement avec Codex, la connexion ChatGPT utilise les droits du forfait ; une clé API OpenAI entraîne une facturation distincte sur OpenAI Platform. Avec un fournisseur personnalisé de Responses, vérifiez le fournisseur sélectionné et ses relevés d’utilisation, en plus de codex login status.

Choisissez le compte qui doit payer

Au 2026-11-22, la documentation d’authentification d’OpenAI distingue la connexion par abonnement de l’accès par clé API. Un fournisseur tiers ajoute une facturation séparée pour le modèle, pas un abonnement ChatGPT.

Mode d’accèsConditionsOù l’utilisation est facturéeQuand le choisir
Connexion ChatGPTCompte ChatGPT dans une région prise en charge ; forfait éligible et moyen de paiement accepté pour les fonctions payantesQuota inclus dans le forfait et, selon les conditions applicables, crédits ChatGPT ou facturation à l’usageVous voulez le quota local inclus ou les fonctions de Codex cloud accessibles à votre compte
Clé API officielle OpenAIClé OpenAI Platform, facturation API configurée ou crédits API utilisables, région prise en charge ; moyen de paiement accepté lorsqu’un paiement est nécessaireOpenAI Platform, aux tarifs API et non sur le quota ChatGPTVous avez besoin de travailler localement dans la CLI ou d’automatiser dans un environnement de confiance, avec facturation à une organisation API
Fournisseur personnalisé BetterTokenVotre propre compte BetterToken, une clé API et un solde disponible ; les options de paiement dépendent de la consoleSolde BetterToken, selon les tarifs par token du modèle choisiVous souhaitez un accès local à Codex avec une facturation séparée, notamment une option de paiement en roubles

Configurez BetterToken pour une session locale dans la CLI

Utilisez l’accès à Codex via BetterToken avec la CLI officielle de Codex déjà installée. Consultez les tarifs actuels des tokens et du cache, puis ouvrez la console.

Vérifiez que votre compte dispose d’un solde utilisable suffisant pour le test. Si nécessaire, ajoutez du crédit avec un moyen de paiement disponible dans la console et confirmez la mise à jour du solde. Créez ensuite votre propre clé API en suivant les instructions de configuration du compte BetterToken.

L’exemple utilise gpt-6.2-sol, référencé comme compatible avec Responses au 2026-11-22. Il emploie l’authentification par variable d’environnement décrite dans le guide Codex de BetterToken.

Quittez Codex et sauvegardez votre configuration dans un emplacement privé. Intégrez ces réglages au fichier utilisateur ~/.codex/config.toml, en plaçant les clés racine avant toutes les tables. Remplacez les réglages correspondants déjà présents, sans dupliquer les clés ni les tables. Si CODEX_HOME est défini, modifiez plutôt le fichier config.toml de ce répertoire.

model = "gpt-6.2-sol"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
env_key = "BETTERTOKEN_API_KEY"
requires_openai_auth = false
supports_websockets = false

Dans Bash, collez la clé lorsque read attend une saisie, puis appuyez sur Entrée. La saisie reste masquée. Lancez le test depuis un répertoire sans données confidentielles du projet.

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
codex --sandbox read-only "Reply with exactly CODEX_ROUTE_OK. Do not use tools."

Codex lit la clé dans la variable exportée et envoie les requêtes Responses à https://www.bettertoken.ai/v1/responses. Cette configuration ne nécessite ni de remplacer auth.json, ni de fournir la clé BetterToken lors de la connexion à OpenAI. Lancez Codex depuis ce même terminal pour qu’il reçoive la variable.

Vérifiez la réponse demandée, puis retrouvez le modèle, l’heure, le statut et le montant correspondants dans la console BetterToken. La réponse confirme la connexion ; l’enregistrement correspondant confirme quelle plateforme a traité la requête. Vérifiez le montant facturé avant d’ouvrir un gros dépôt.

Créer un compte BetterToken

Que permettent les deux modes de connexion officiels ?

Pour accéder directement à OpenAI, suivez ses instructions officielles de connexion. Choisissez ChatGPT pour les droits du forfait ou une clé émise par OpenAI pour la facturation sur Platform. La configuration du fournisseur tiers ci-dessus constitue un autre mode d’accès.

Les deux modes officiels permettent le travail local dans Codex CLI, l’extension IDE et l’application de bureau ChatGPT. Codex cloud exige une connexion ChatGPT. La page de disponibilité des fonctions exclut de l’accès par clé API la revue de code GitHub dans le cloud et l’intégration Slack.

Choisissez une clé API pour le travail local ou les tâches CI dans un environnement de confiance, pas pour remplacer les droits aux fonctions cloud. Les modèles disponibles via l’API dépendent des accès de votre clé. Un forfait ChatGPT supérieur ne fait pas passer une session avec clé API dans le quota inclus de l’abonnement.

Pour revenir à OpenAI, définissez model_provider = "openai" à la racine de la configuration utilisateur. Restaurez aussi votre ancien réglage model pour OpenAI ou choisissez un modèle disponible avec votre connexion officielle. Ne conservez pas model = "gpt-6.2-sol" de l’exemple de passerelle sans vérifier l’accès à ce modèle sur votre compte officiel.

Supprimez toute valeur de openai_base_url qui redirige vers une passerelle. Pour remplacer des identifiants enregistrés, exécutez d’abord codex logout. Lancez codex login pour vous connecter avec ChatGPT.

Pour la connexion officielle par clé API, utilisez une clé émise par OpenAI. Ces commandes Bash la transmettent par l’entrée standard sans inscrire sa valeur dans le texte de la commande :

read -rs OPENAI_API_KEY && export OPENAI_API_KEY
codex login --with-api-key <<<"$OPENAI_API_KEY"
codex login status

Après la connexion, ouvrez une nouvelle session et relancez le test en lecture seule avec le modèle OpenAI choisi. Vérifiez la réponse, puis consultez le tableau de bord ChatGPT ou OpenAI Platform correspondant, comme indiqué dans la section sur la facturation.

Gardez la clé privée. Le guide de facturation d’OpenAI distingue la facturation API de celle de ChatGPT, y compris pour les crédits API promotionnels. Avant de compter sur un avantage d’abonnement, vérifiez les conditions d’éligibilité et exclusions des crédits API plutôt que de supposer qu’il couvre Codex.

Que faire si votre pays ou votre carte n’est pas pris en charge ?

Une clé API officielle ne supprime pas les conditions géographiques d’OpenAI. Au 2026-11-22, la Russie ne figure ni dans la liste des pays pris en charge pour l’API, ni dans la liste commune à ChatGPT et à l’API.

L’erreur "OpenAI's services are not available in your country." peut apparaître lors de l’inscription ou de la création d’une clé API. La politique d’OpenAI sur les pays non pris en charge avertit qu’un accès depuis ces pays peut entraîner la suspension du compte. Elle indique aussi que les moyens de paiement de pays non pris en charge entraînent un blocage des services.

Les paiements font l’objet de vérifications distinctes. Pour payer par carte, votre localisation et celle de la banque émettrice doivent se trouver dans des régions prises en charge. Selon le guide sur les refus de carte, les cartes prépayées ne permettent pas d’acheter des crédits API.

Pour les utilisateurs en Russie, BetterToken accepte les paiements en roubles sans la carte étrangère généralement nécessaire aux abonnements officiels des fournisseurs. Son point d’accès API est joignable sans VPN. Cela ne couvre pas les téléchargements, connexions, places de marché ou mises à jour de tiers. Les canaux de paiement, cartes acceptées, frais et conditions de règlement dépendent de la console.

La réinitialisation des données du navigateur n’est pertinente que si vous êtes actuellement dans un pays pris en charge. Après une erreur de détection liée à un voyage, OpenAI recommande d’effacer les cookies et le cache ou d’essayer un autre navigateur. Si cela ne suffit pas, contactez l’assistance OpenAI.

Pourquoi Codex ignore-t-il mon fournisseur personnalisé ?

Placez les réglages du fournisseur dans la configuration utilisateur, pas dans le fichier .codex/config.toml du dépôt. La référence de configuration indique que les entrées model_provider et model_providers propres au projet sont ignorées. Déclarer le projet comme fiable ne change pas cette restriction.

model_provider sélectionne l’identifiant du fournisseur ; [model_providers.bettertoken] le définit. base_url indique la racine de l’API, tandis que env_key nomme la variable d’environnement qui contient la clé. Utilisez votre propre identifiant de fournisseur. Les identifiants intégrés, notamment openai, ollama et lmstudio, sont réservés.

La seule valeur acceptée pour wire_api est responses. Une passerelle limitée à Chat Completions ne suffit pas pour cette configuration. Utilisez https://www.bettertoken.ai/v1 comme URL de base, pas l’URL complète de requête avec /responses.

Gardez les modes d’authentification séparés. OpenAI précise qu’avec requires_openai_auth = true, Codex ignore env_key. L’exemple définit explicitement false. Ne le combinez pas avec une configuration copiée d’authentification par fichier qui définit true.

supports_websockets = false conserve le transport HTTP/SSE dans cet exemple. N’ajoutez pas de réglages facultatifs au premier test. Le fournisseur de la passerelle doit confirmer la prise en charge de champs tels que service_tier. La présence d’un champ dans Codex ne suffit pas à l’établir.

Si la configuration reste sans effet, vérifiez CODEX_HOME ainsi que les valeurs imposées par la ligne de commande ou le profil sélectionné. Dans la CLI, /debug-config affiche les couches de configuration et les sources des politiques. Redémarrez Codex avec une nouvelle session après les modifications. Le guide de configuration d’un fournisseur personnalisé détaille les autres vérifications de connexion.

Comment vérifier quel compte est facturé ?

Vérifiez ensemble l’authentification, la destination des requêtes et les relevés d’utilisation. codex login status indique le mode d’authentification ; ce n’est pas un justificatif de facturation. Avec un fournisseur utilisant env_key, ne déduisez pas le compte facturé de la seule présence d’une connexion ChatGPT enregistrée.

Exécutez cette commande dans le même environnement que celui utilisé pour lancer Codex :

codex login status

Vérifiez ensuite les valeurs sélectionnées de model_provider et base_url. Dans la session, /status affiche le modèle actif et l’utilisation des tokens. Rapprochez ces informations de la requête de test avant de lancer une longue tâche.

Pour la connexion ChatGPT, consultez le tableau de bord d’utilisation de Codex afin de vérifier la consommation du quota inclus. Retrouvez les achats dans les paramètres de facturation du compte ou de l’espace de travail ChatGPT. Une utilisation incluse dans le forfait ne génère pas nécessairement un montant distinct par requête.

Pour une clé API officielle, utilisez les rapports d’utilisation d’OpenAI Platform et les paramètres de facturation de l’organisation API. Vérifiez le projet, le modèle, la clé API et la période du rapport. Les heures du tableau de bord sont en UTC, et l’activité récente peut mettre du temps à apparaître.

Pour BetterToken, vérifiez l’enregistrement de la requête et le solde dans la console. Le tableau de bord affiche l’heure, le modèle, le statut, l’utilisation des tokens et les montants facturés. Cette facturation n’apparaît pas sur votre compte personnel OpenAI Platform et ne consomme pas votre quota ChatGPT.

Si le test échoue, corrigez la cause correspondante

Si une variable d’environnement manque, saisissez de nouveau la clé et lancez Codex depuis le même terminal Bash. Pour une réponse 401 de BetterToken, vérifiez que la clé appartient à BetterToken et reste valide. Une réponse 402 indique un solde insuffisant.

Si le format de la requête est refusé, comparez le protocole et l’URL de base à la configuration minimale ci-dessus. Retirez les champs facultatifs propres au fournisseur avant de retester. La référence Responses de BetterToken associe 400 aux formats ou paramètres de requête non valides.

Si la réponse arrive sans le relevé d’utilisation attendu, arrêtez-vous avant d’envoyer une tâche plus importante. Revérifiez le fournisseur, l’origine de la clé, le compte ouvert dans le tableau de bord et la période du rapport. Un nom de modèle ou une connexion réussie ne suffit pas à prouver où la requête est facturée.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.

Commencer gratuitement