Tutoriel Codex — installer Codex CLI, utiliser une clé API sans abonnement et connaître le coût d’une tâche

Codex est l’agent de programmation IA d’OpenAI (coding agent). L’utilisation la plus élémentaire consiste à installer Codex CLI dans le terminal (npm install -g @openai/codex), à exécuter codex dans le dossier du projet à traiter, puis à lui dire en chinois ce qu’il doit faire. Deux modes de démarrage sont disponibles : se connecter avec un abonnement ChatGPT (Plus, Pro, Business, etc.) et utiliser le quota de l’offre, ou utiliser une clé API et payer selon le nombre de tokens. Les guides en chinois décrivent presque tous la première option ; cet article couvre la seconde — configuration de Codex CLI sans abonnement, choix du modèle selon la tâche et coût réel d’une tâche.

Codex n’est pas un outil qui colle du code dans une fenêtre de discussion : c’est un agent qui lit et modifie les fichiers du projet, exécute des tests et lance des commandes. Configurez les actions qu’il peut effectuer directement sans confirmation après le démarrage avec /permissions.

Les deux façons d’utiliser Codex

Avec une clé API, les coûts sont calculés séparément du quota du forfait ChatGPT. Vous pouvez aussi utiliser directement une clé API OpenAI, mais cet article traite de la connexion à un point de terminaison compatible avec l’API Responses : une même clé permet de basculer entre GPT-6 Astra et GPT-5.6 Terra. Par exemple, pour GPT-5.6 Sol, le tarif officiel d’OpenAI est $5.00 / $30.00(OpenAI propose actuellement un tarif promotionnel de $4.00 / $20.00, disponible au moins jusqu’au 21 novembre 2026 selon sa page officielle des tarifs), tandis qu’ici il est, par million de tokens, de $2.00 / $12.00 (les tarifs sont lus directement depuis le catalogue du site, ils ne sont pas saisis manuellement).

Installer Codex CLI — npm ou Homebrew

# npm（有 Node.js 就能用，macOS / Linux / Windows 通用）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Les deux méthodes d’installation figurent dans le README officiel d’OpenAI, et Windows peut également être installé avec la même commande npm en une ligne. Une fois l’installation terminée, saisissez codex dans le dossier du projet pour lancer Codex. Si vous prévoyez de vous connecter avec ChatGPT, vous avez terminé ici et pouvez ignorer la configuration ci-dessous.

Utiliser une clé API — ajouter un bloc à config.toml

Commencez par créer un compte, ajoutez au moins 10 $, puis accédez à la page des clés API pour créer une clé. La clé ne sera affichée qu’une seule fois : enregistrez-la immédiatement. Ajoutez ensuite un bloc fournisseur au fichier de configuration de Codex :

# ~/.codex/config.toml（沒有的話就新建一個）
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"   # 填「環境變數的名稱」，不是金鑰本身
wire_api = "responses"        # 唯一有效的值，省略也一樣

L’élément le plus facile à mal renseigner est env_key : il doit contenir le nom de la variable d’environnement qui stocke la clé, et non la clé elle-même. La clé n’apparaît pas dans le fichier de configuration : vous pouvez donc envoyer config.toml dans git ou le publier sur un forum pour demander de l’aide.

# 把金鑰放進 env_key 指定名稱的變數（金鑰以 sk-kn- 開頭）
export KUNAVO_API_KEY="sk-kn-..."

# 寫進 shell 的設定檔，就不必每次都 export
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Dans PowerShell sous Windows, exécutez setx KUNAVO_API_KEY sk-kn-..., puis ouvrez un nouveau terminal ; le fichier de configuration se trouve à %USERPROFILE%\.codex\config.toml. Avant de lancer Codex, effectuez une requête pour vérifier que la clé et le point de terminaison fonctionnent, afin de déterminer plus facilement l’origine d’une erreur ultérieure.

# 懷疑 Codex 之前，先用一個請求確認金鑰和端點
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-6-sol", "input": "只回 OK"}'

Si un JSON est renvoyé, la clé et le point de terminaison fonctionnent ; le problème restant se situe dans config.toml. La description des champs de configuration se trouve dans la documentation d’intégration de Codex CLI (anglais), et la méthode pour appeler des modèles Claude depuis Codex est décrite dans le guide des clés API de Codex CLI (anglais).

Première tâche

# 1. 進到要處理的專案資料夾，啟動 Codex
cd ~/work/my-app
codex

# 2. 讓它產生 AGENTS.md 草稿（寫測試怎麼跑、專案規則的檔案）
> /init

# 3. 之後直接用中文交代。附上檔名，做得更快也更省
> src/utils/date.test.ts 一直失敗，找出原因修好，並確認測試通過

Le AGENTS.md généré par /init est un fichier destiné à consigner les « règles impossibles à déduire du code » — exécution des tests, bibliothèques utilisées, chemins à ne pas modifier — et il est automatiquement lu à chaque session de travail. Le contenu généré n’est qu’un brouillon : pensez à le relire et à le modifier vous-même.

Les astuces de formulation sont les mêmes qu’avec Claude Code : indiquez les noms et chemins de fichiers et ne donnez pas les grosses tâches en une seule fois. L’exploration consomme moins de tokens, les résultats sont plus rapides et plus précis, et la facture diminue également.

Choisir le modèle selon la tâche — coût réel d’une tâche

Le principal avantage de l’utilisation d’une clé API est de pouvoir choisir le modèle selon la difficulté du travail. model n’est qu’un nom de modèle sur le point de terminaison : changer de modèle ne nécessite ni nouvelle clé ni configuration supplémentaire.

# config.toml 的預設（gpt-5-6-sol）不動，只有這次啟動換模型
codex -m gpt-6-astra     # 找不到原因的 bug、跨模組的修改
codex -m gpt-5-6-terra   # 例行修改、大量取代、整理日誌這類輕量工作

Pour calculer « une tâche », on considère la correction d’un test défaillant comme 20 étapes. Chaque étape utilise 25 000 tokens en entrée (instruction système + historique de conversation + fichiers lus) et 1 200 tokens en sortie (une modification ou une explication), soit 500 000 tokens en entrée et 24 000 en sortie par tâche. Avec GPT-5.6 Sol, cela représente environ $1.29 ; pour le même nombre de tokens, paiement direct à OpenAI : $2.48 au tarif promotionnel actuel ($3.22 au tarif standard). Les modèles moins chers peuvent nécessiter davantage d’allers-retours pour parvenir au bon résultat ; en pratique, passez donc au niveau supérieur si la première tentative échoue.

Ce calcul n’inclut pas le cache. Codex renvoie l’historique de conversation à chaque étape ; les entrées trouvées dans le cache sont facturées à 0,10 fois le prix d’entrée (GPT-5.6 Sol : $0.20 par million de tokens), tandis que les nouvelles données écrites dans le cache sont facturées à 1,25 fois le prix d’entrée. De plus, pour la série GPT-5.6 et GPT-6 Astra, lorsque le prompt d’une requête dépasse 272K tokens, l’ensemble de la requête est facturé à 2 fois le prix d’entrée et 1,5 fois le prix de sortie. Évitez donc de regrouper trop de travail dans une même session ; il est plus prudent de redémarrer une fois par tâche. Les tokens de raisonnement sont facturés au tarif de sortie ; plus le problème est difficile, plus la sortie est longue. Consultez le champ usage dans la réponse et le journal d’utilisation pour connaître le montant réel. Les spécifications du modèle sont disponibles sur la page du modèle GPT-5.6 Sol, et les tarifs de tous les modèles dans la grille tarifaire.

Erreurs courantes

Soyons francs — quand le forfait ChatGPT est plus avantageux

Si vous passez plusieurs heures par jour à dialoguer avec Codex, le forfait à prix mensuel fixe est généralement moins cher. La facturation à l’usage est proportionnelle au nombre de tokens : plus l’utilisation est élevée et régulière, plus l’avantage du forfait mensuel est important. Le seuil est « abonnement mensuel ÷ coût d’une tâche » ; le point d’équilibre entre les forfaits est calculé sur la page Coût de Codex.

Deux autres points sont à connaître. Selon la documentation d’OpenAI, les fonctions dépendant d’un espace de travail ChatGPT ou de services cloud sont limitées ou indisponibles avec une clé API. En outre, cette solution Kunavo repose sur une capacité partagée : il n’y a ni quota dédié ni SLA contractuel garanti. Si vous avez besoin d’un quota ou d’un SLA garantis, il est préférable de contracter directement avec OpenAI.

À l’inverse, la clé API convient aux personnes dont l’utilisation varie, à celles qui veulent choisir le modèle selon la tâche, aux équipes qui souhaitent séparer plafonds et relevés d’utilisation par clé, ainsi qu’à celles qui veulent continuer à travailler le jour où le quota du forfait est épuisé. Les deux solutions peuvent être utilisées ensemble : supprimez la ligne model_provider dans config.toml pour revenir à la connexion ChatGPT ; pour basculer à chaque lancement, utilisez --profile de Codex.

Payez avec une carte de crédit internationale (y compris JCB), Apple Pay ou Google Pay ; Taïwan ne dispose d’aucun moyen de paiement local — JKoPay et LINE Pay ne figurent pas parmi les options disponibles. Le prépaiement ne débite la carte qu’une seule fois lors de la recharge, le solde n’expire pas et les requêtes échouées ne sont pas facturées. Si vous hésitez encore entre Codex et Claude Code, consultez Claude Code vs Codex CLI (en anglais) ; le calcul du coût de Claude Code est expliqué dans Coût de Claude Code.

Questions fréquentes