Codex CLI sur un solde prépayé, avec un seul bloc provider

Codex CLI est l'agent de code en ligne de commande d'OpenAI. Sa configuration a un réglage model_provider dont la valeur par défaut est openai : les requêtes partent donc vers l'interface d'OpenAI. Ce réglage se remplace : définissez votre provider dans config.toml avec l'adresse de l'endpoint et le nom de la variable d'environnement qui contient la clé, puis pointez model_provider dessus. Les commandes et l'usage de Codex restent les mêmes ; seul change celui qui facture.

Codex ne parle qu'un protocole, la Responses API d'OpenAI : sa référence de configuration indique que wire_api n'accepte que la valeur responses. La première chose à vérifier sur une passerelle est donc la présence de /v1/responses, et pas seulement de /v1/chat/completions. Ici, les deux routes existent, et Codex utilise la première.

Le bloc ci-dessous tient en quatre lignes, et la clé API n'est pas écrite dans le fichier. Le rôle de chaque réglage :

• model_provider choisit le bloc par le nom de sa table. Ce nom, vous le choisissez, mais openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime et gcp sont des id intégrés à Codex qui ne peuvent pas être redéfinis.
• base_url reçoit https://api.relayswitch.io/v1, avec /v1 ; Codex ajoute /responses derrière.
• env_key est le nom de la variable d'environnement qui contient la clé, pas la clé elle-même. Comme la clé reste dans la variable d'environnement, le fichier de configuration peut être commité ou synchronisé sans risque.
• wire_api n'a qu'une valeur valide, responses, qui est aussi sa valeur par défaut : cette ligne peut donc être supprimée.
• requires_openai_auth vaut false par défaut et n'a pas à être écrit : un provider personnalisé utilise la clé de env_key, pas la connexion à un compte OpenAI.

Écrivez ce bloc dans ~/.codex/config.toml. Ce répertoire est fixé par la variable d'environnement CODEX_HOME et vaut ~/.codex par défaut ; le provider doit être écrit dans ce fichier de niveau utilisateur. Exportez ensuite la clé dans le terminal où Codex est lancé, puis démarrez. Ajoutez la ligne export au fichier de configuration de votre shell pour que les nouveaux terminaux la reprennent.

Avant de lancer Codex, envoyez une petite requête Responses pour vérifier la clé et l'adresse. L'option -i affiche la ligne de statut et les en-têtes de la réponse, dont l'id de la requête.

Si la réponse est 200, lancez codex et envoyez une première instruction. La requête apparaît en quelques secondes sur la page Usage de la console, avec ses tokens et son coût. Pour changer de modèle temporairement, utilisez codex --model suivi de l'id.

Ce tableau présente les modèles GPT du catalogue en USD par million de tokens, avec des prix distincts pour l'entrée, l'entrée en cache et la sortie. Codex est conçu pour les modèles GPT et la route Responses : assurez-vous donc que l'id écrit dans config.toml répond au test curl ci-dessus.

Codex renvoie la conversation et les sorties d'outils à chaque tour. Ces tokens sont facturés au prix de l'entrée en cache quand ils touchent le cache, et la réponse indique le nombre de tokens en cache ; qu'ils le touchent ou non dépend du modèle et de la requête elle-même. Les économies deviennent alors concrètes : un modèle moins cher pour les modifications quotidiennes et un plus cher seulement pour les revues et les refactorings difficiles, une nouvelle session une fois la tâche terminée pour que le contexte ne s'allonge pas sans fin, et une clé dédiée à Codex avec un budget en dollars et un plafond de dépenses quotidien. Quand la limite est atteinte, la passerelle répond 402 et seule cette clé s'arrête ; le reste du solde du compte n'est pas touché.

Un profil est un fichier nommé ~/.codex/<name>.config.toml qui ne contient que les lignes différentes de config.toml, et qui s'y superpose quand Codex est lancé avec codex --profile <name>. Depuis Codex 0.134.0, les tables [profiles.<name>] dans config.toml ne sont plus lues et le sélecteur profile = de premier niveau a été supprimé ; les tutoriels écrits avant cela utilisent encore l'ancienne méthode et ne fonctionnent pas s'ils sont copiés. La valeur de model_reasoning_effort suit les niveaux pris en charge par le modèle choisi ; Codex l'envoie à chaque requête et la passerelle la transmet telle quelle au modèle.

Avec un provider personnalisé, le menu /model de Codex affiche toujours ses modèles OpenAI intégrés, pas ceux de votre provider. En choisir un réécrit le fichier de profil actif : le modèle change, le provider non. Si l'id écrit existe dans le catalogue, Codex tourne au prix de ce modèle ; sinon, la réponse est 404. Pour changer de modèle, utilisez --profile ou --model.

Les statuts 401 à 404 sont renvoyés avant que la requête n'atteigne le modèle, tandis que 429, 502 et 503 ne portent aucune réponse ; aucun n'est facturé. Le tableau complet par statut est sur la page OpenAI API. Pour coder avec Claude dans le terminal, utilisez Claude Code ; les deux tournent avec la même clé et le même solde, et la création d'une clé est expliquée sur la page Clé API Claude.