Comment utiliser Codex — de l’installation à l’utilisation avec une clé API sans abonnement, jusqu’au coût réel d’une tâche

Codex est l’agent de codage d’OpenAI. Pour l’utiliser, installez Codex CLI, qui s’exécute dans le terminal (npm install -g @openai/codex), puis lancez codex dans le dépôt sur lequel vous allez travailler et formulez votre demande en coréen. Il existe deux façons de commencer : vous connecter avec un forfait ChatGPT (Plus · Pro · Business, etc.) et l’utiliser dans la limite de consommation, ou l’exécuter avec une clé API et ne payer que les jetons utilisés. Comme la plupart des articles coréens consacrés à son utilisation ne couvrent que la première méthode, cet article détaille la seconde — configurer Codex CLI sans abonnement, choisir un modèle pour chaque tâche et calculer le coût réel d’une tâche — dans cet ordre. Les limites par forfait et les options disponibles une fois la limite atteinte sont présentées séparément dans Limites de consommation de Codex.

Codex n’est pas un outil dans lequel on colle du code dans une fenêtre de chat : c’est un agent qui lit et modifie les fichiers du dépôt, puis exécute des tests et des commandes. Après le lancement, vous pouvez déterminer ce que vous lui confiez sans vérification avec /permissions.

Deux façons d’utiliser Codex

Avec une clé API, la facturation est calculée séparément de la consommation du forfait ChatGPT. Vous pouvez utiliser directement une clé API OpenAI, mais cet article explique la connexion à un point de terminaison compatible avec l’API Responses. Vous pouvez utiliser la même clé pour passer de GPT-6 Astra à GPT-5.6 Terra ; par exemple, GPT-5.6 Sol coûte $2.00 / $12.00 par million de jetons, contre $5.00 / $30.00(OpenAI le propose actuellement au tarif promotionnel de $4.00 / $20.00, qui, selon la page des tarifs, est maintenu au moins jusqu’au 21 novembre 2026) au tarif public d’OpenAI (les tarifs sont lus directement dans le catalogue).

Installer Codex — npm ou Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Les deux méthodes figurent dans le README officiel d’OpenAI. Sous Windows également, l’installation s’effectue avec la commande npm. Une fois l’installation terminée, saisissez codex dans le répertoire du dépôt sur lequel vous allez travailler pour le lancer. Si vous comptez l’utiliser en vous connectant avec ChatGPT, vous pouvez vous arrêter ici ; la configuration ci-dessous n’est pas nécessaire.

Obtenir et configurer une clé API Codex — un bloc dans config.toml

Commencez par créer un compte et approvisionnez-le à partir de $10, puis créez une clé depuis l’écran des clés API. La clé n’est affichée qu’une seule fois : enregistrez-la immédiatement. Ajoutez ensuite un bloc de fournisseur dans le 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’erreur la plus fréquente se trouve à env_key. Il faut y inscrire le nom de la variable d’environnement qui contiendra la clé, et non la clé elle-même. Comme la clé ne figure pas dans le fichier de configuration, config.toml peut être validé ou publié dans une question sans risque.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Dans Windows PowerShell, 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, vérifiez la clé et le point de terminaison avec une requête ; cela facilite le diagnostic.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
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 le JSON est renvoyé, la clé et le point de terminaison sont corrects ; le problème restant se situe du côté de config.toml. Les paramètres sont décrits dans la documentation d’intégration de Codex CLI (anglais), et l’explication sur l’appel de modèles Claude depuis Codex figure dans le guide des clés API de Codex CLI (anglais).

Première tâche

# 1. 작업할 저장소로 들어가 실행합니다
cd ~/work/my-app
codex

# 2. AGENTS.md 초안을 만들게 합니다 (테스트 실행법이나 규칙을 적는 파일)
> /init

# 3. 이후엔 한국어로 요청합니다. 파일 경로를 붙일수록 빠르고 싸게 끝납니다
> src/utils/date.test.ts가 실패해. 원인을 찾아서 고치고 테스트가 통과하는지 확인해줘

Le /init généré par AGENTS.md est un fichier qui décrit les « règles impossibles à connaître en lisant le code », comme la façon d’exécuter les tests, les bibliothèques utilisées et les chemins à ne pas modifier ; il est ensuite lu automatiquement lors des sessions suivantes. Le contenu généré est un brouillon : peaufinez-le manuellement.

Les conseils de formulation sont les mêmes que pour Claude Code. Indiquez le chemin du fichier et évitez de lancer une tâche trop importante en une seule fois. Cela réduit les jetons utilisés pour l’exploration, accélère et améliore les résultats et diminue le montant facturé. Le fonctionnement de Claude Code est décrit dans Utiliser Claude Code.

Choisir un modèle pour chaque tâche — coût réel d’une tâche

Le principal avantage de l’utilisation d’une clé API est de pouvoir choisir un modèle adapté à la difficulté de la tâche. model n’est que le nom du modèle du point de terminaison ; le changer ne nécessite ni nouvelle clé ni configuration supplémentaire.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

Une « tâche » correspond ici à la correction d’un test défaillant en 20 étapes. Une étape comprend 25 000 jetons d’entrée (prompt système + historique de conversation + fichiers lus) et 1 200 jetons de sortie (une modification ou une explication), soit 500 000 jetons d’entrée et 24 000 jetons de sortie par tâche. Avec GPT-5.6 Sol, cela représente $1.29, pour les mêmes jetons payés directement à OpenAI au tarif promotionnel actuel : $2.48(au tarif public : $3.22). Les modèles moins chers peuvent nécessiter davantage d’allers-retours pour corriger puis recorriger ; si la tâche ne se termine pas en une fois, passer au niveau supérieur est souvent plus réaliste. Pour saisir directement votre nombre de jetons, utilisez le calculateur de coûts.

Ce calcul ne tient pas compte du cache. Codex renvoie l’historique de conversation à chaque étape : les entrées mises en cache sont facturées à 0.10 fois le tarif d’entrée (GPT-5.6 Sol par million de jetons selon $0.20), tandis que le contenu nouvellement écrit dans le cache est facturé à 1.25 fois le tarif d’entrée. De plus, pour la famille GPT-5.6 et GPT-6 Astra, si le prompt d’une requête dépasse 272K jetons, l’intégralité de cette requête est facturée à 2 fois le tarif d’entrée et 1.5 fois le tarif de sortie. Évitez de concentrer trop de tâches dans une même session ; il est plus sûr de lancer une nouvelle session pour chaque tâche. Les jetons de raisonnement des modèles de raisonnement sont facturés comme des jetons de sortie : plus la tâche est difficile, plus la sortie augmente. Consultez le usage et l’historique d’utilisation de la réponse pour connaître le montant réel. Les spécifications du modèle figurent sur la page du modèle GPT-5.6 Sol, les tarifs complets dans le barème tarifaire, et le tableau comparant les tarifs par jeton des modèles GPT utilisés par Codex dans Prix de l’API GPT.

Erreurs fréquentes

En toute franchise — quand un forfait ChatGPT est préférable

Si vous dialoguez avec Codex plusieurs heures par jour pour travailler, un forfait fixe est généralement moins cher. La facturation à l’usage étant directement proportionnelle au nombre de jetons, plus l’utilisation est importante et régulière, plus l’avantage du forfait est marqué. Le critère est « forfait mensuel ÷ coût d’une tâche » ; le seuil de rentabilité par rapport au forfait est calculé dans Tarifs de Codex.

Deux autres points sont à connaître. Selon la documentation d’OpenAI, les fonctionnalités dépendant d’un espace de travail ChatGPT ou du cloud sont limitées, voire indisponibles, lorsqu’elles sont utilisées avec une clé API. De plus, le chemin Kunavo repose sur une capacité partagée et ne fournit ni quota dédié ni SLA contractuel. Si vous avez besoin d’une limite ou d’un SLA garanti, il est préférable de contracter directement avec OpenAI.

À l’inverse, la clé API convient aux personnes dont l’utilisation varie fortement entre les jours d’activité et les jours sans activité, qui veulent choisir un modèle pour chaque tâche, qui souhaitent répartir les limites et l’historique d’utilisation entre les clés d’une équipe, ou qui veulent continuer à travailler uniquement lorsque la limite du forfait est épuisée. Les deux modes peuvent être utilisés ensemble. Supprimez la ligne model_provider de config.toml pour revenir à la connexion ChatGPT, ou utilisez le --profile de Codex si vous souhaitez changer de mode à chaque exécution.

Le rechargement Kunavo s’effectue avec une carte, Apple Pay, Google Pay, etc. Lorsque l’écran de paiement affiche les montants en wons, KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes coréennes (y compris celles dont les paiements internationaux ne sont pas activés) sont également proposés. Toss n’est pas pris en charge. Le solde n’expire pas et les requêtes échouées ne sont pas facturées. Si vous hésitez entre Codex et Claude Code, consultez Codex vs Claude Code.

Questions fréquentes