Codex (CLI OpenAI)

Exécutez les nouvelles tâches locales de Codex via l’API Responses en streaming d’OneProvider.

Agent de code Codex, CLI et application de bureau

Ce qui fonctionne

Prend en charge les réponses en streaming, les appels de fonctions, les outils locaux comme apply_patch et le suivi de la consommation. Cela modifie les nouvelles tâches locales de la CLI, de l’application de bureau et de l’IDE ; les chats cloud de Codex ne changent pas.

Limite du client

Redémarrez Codex et créez une nouvelle tâche locale après avoir changé de fournisseur. Les tâches existantes gardent le modèle et le fournisseur avec lesquels elles ont démarré.

Configuration

1. Installer ou vérifier Codex

   Si codex --version affiche déjà une version, passez à la suite. Sinon, installez la CLI actuelle.

   npm install --global @openai/codex
   codex --version

2. Rendre une clé dédiée disponible

   Créez une clé OneProvider dédiée et exportez-la dans la même session de terminal que celle qui lance Codex.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Ajouter le fournisseur personnalisé

   Ouvrez ~/.codex/config.toml (application de bureau : Settings → Configuration → Open config.toml) et ajoutez le fournisseur OneProvider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Redémarrer et tester une nouvelle tâche locale

   Les utilisateurs de la CLI doivent lancer une sonde en lecture seule. Les utilisateurs de l’application de bureau doivent la quitter complètement, la rouvrir et démarrer une nouvelle tâche locale.

   codex

Vérifier la connexion

Confirmer la requête dans votre Dashboard

La requête terminée doit afficher le modèle choisi, /v1/responses, la consommation de jetons et le montant débité.

Paramètres de connexion

Protocole

responses

Endpoint

https://api.oneprovider.dev/v1

Sécurité de la clé

Utilisez une clé dédiée à portée limitée. Sous macOS, une application de bureau ouverte depuis le Dock peut ne pas hériter des variables d’environnement du terminal ; utilisez l’authentification par commande de Codex via le Keychain (trousseau macOS) plutôt que de placer le secret dans config.toml.

Quel modèle choisir

Définissez model dans le même config.toml, sous model_provider. gpt-6.1-sol est le niveau frontière pour les tâches d’agent difficiles, gpt-6.1-terra le choix équilibré par défaut pour le travail courant, et gpt-5.6-luna le niveau économique pour les gros volumes et les tâches rapides. Codex parle l’API Responses, choisissez donc des ID GPT sur la page des modèles  ; les tarifs sont sur la page des tarifs .

Erreurs courantes et solutions

401 ou « missing credentials »

ONEPROVIDER_API_KEY n’est pas visible par Codex. Exportez-la dans le terminal qui lance Codex. Sous macOS, une application de bureau ouverte depuis le Dock n’en hérite pas : utilisez l’authentification par commande via le Keychain (trousseau macOS).

404

base_url doit être https://api.oneprovider.dev/v1 avec /v1, et wire_api doit valoir "responses".

Codex utilise toujours l’ancien modèle ou fournisseur

Les tâches existantes gardent le fournisseur avec lequel elles ont démarré. Redémarrez Codex et créez une nouvelle tâche locale.

« You've hit your usage limit » ou Codex me demande de me connecter à ChatGPT

C’est la limite d’un abonnement ChatGPT : la requête est partie vers ChatGPT, donc le fournisseur OneProvider n’est pas actif. Placez model_provider = "oneprovider" tout en haut de config.toml, au-dessus de toute [table] (sans guillemets « intelligents »), quittez complètement Codex et démarrez une nouvelle tâche locale. Déconnectez-vous ensuite de ChatGPT avec codex logout (application de bureau : dans ses paramètres) et lancez codex dans le terminal où ONEPROVIDER_API_KEY est exportée : avec le fournisseur actif, la clé seule suffit. Test rapide : codex -c model_provider=oneprovider. wire_api n’accepte que "responses".

429 « Insufficient balance »

Le solde est épuisé ou la limite de la clé est atteinte. Rechargez le solde ; réessayer ne servira à rien.

FAQ

Cela change-t-il les chats cloud de Codex ?

Non, seulement les nouvelles tâches locales de la CLI, de l’application de bureau et de l’IDE.

Ai-je besoin d’un compte OpenAI ?

Non, la clé OneProvider le remplace pour les tâches locales.

Puis-je utiliser des modèles Claude dans Codex ?

Codex utilise l’API Responses avec des ID GPT. Pour Claude, utilisez Claude Code .

Où vérifier le coût ?

Sur la page « Consommation » du Dashboard : chaque requête affiche le modèle, /v1/responses et le montant débité.

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .