Comment utiliser Codex — de l’installation à son exécution avec une clé API sans abonnement

Codex est l’agent de codage d’OpenAI. Pour l’utiliser, installez Codex CLI dans le terminal (npm install -g @openai/codex), lancez codex dans le dépôt sur lequel vous souhaitez travailler et faites votre demande en japonais. Il existe deux façons de commencer : vous connecter avec un forfait ChatGPT (Plus, Pro, Business, etc.) et utiliser le quota inclus, ou utiliser une clé API et payer uniquement les jetons consommés. Les articles explicatifs en japonais traitant presque exclusivement de la première méthode, cette page présente la seconde — configuration de Codex CLI sans abonnement, choix du modèle par tâche et coût réel d’une tâche — dans cet ordre.

Codex n’est pas un outil auquel on colle du code dans une interface de chat : c’est un agent qui lit et modifie les fichiers du dépôt et exécute des tests et des commandes. Après le lancement, /permissions permet de définir ce que vous lui confiez sans confirmation.

Deux façons d’utiliser Codex

Avec une clé API, la facturation est comptabilisée séparément du quota du forfait OpenAI. Vous pouvez utiliser directement une clé API OpenAI, mais cette page traite de la redirection vers un point de terminaison compatible avec l’API Responses. Les modèles, de GPT-6 Astra à GPT-5.6 Terra, sont sélectionnables avec la même clé ; par exemple, GPT-5.6 Sol coûte $2.00 / $12.00 par million de jetons, contre le tarif catalogue OpenAI de $5.00 / $30.00(OpenAI le propose actuellement au tarif promotionnel de $4.00 / $20.00. D’après la page des tarifs, cette offre est maintenue au moins jusqu’au 21 novembre 2026) (les tarifs sont chargés directement depuis le catalogue).

Installation — npm ou Homebrew

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Ces deux méthodes figurent dans le README officiel d’OpenAI. La commande npm fonctionne également sous Windows. Une fois l’installation terminée, saisissez codex dans le répertoire du dépôt sur lequel vous souhaitez travailler. Si vous vous connectez avec ChatGPT, l’installation est terminée à ce stade et aucune configuration supplémentaire n’est nécessaire.

Utilisation avec une clé API — un bloc dans config.toml

Commencez par créer un compte, approvisionnez-le à partir de 10 $ et créez une clé dans l’écran des clés API. La clé ne s’affiche qu’une seule fois ; notez-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 concerne env_key. Il faut écrire le nom de la variable d’environnement qui contiendra la clé, et non la clé elle-même. La clé ne figurant pas dans le fichier de configuration, vous pouvez committer ou publier config.toml sans risque.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Dans PowerShell sous Windows, exécutez setx KUNAVO_API_KEY sk-kn-..., puis ouvrez à nouveau un nouveau terminal. Le fichier de configuration se trouve à %USERPROFILE%\.codex\config.toml. Vérifier en une requête, avant de lancer Codex, que la clé et le point de terminaison sont corrects facilite le diagnostic ultérieur.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
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 sont corrects ; tout problème restant se situe du côté de config.toml. Les détails des paramètres figurent dans la documentation d’intégration de Codex CLI (en anglais), et la guide de configuration d’une clé API pour Codex CLI (en anglais) explique également comment appeler des modèles Claude depuis Codex.

Première tâche

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

Le AGENTS.md créé par /init est un fichier qui contient les règles impossibles à déduire en lisant le code — méthode d’exécution des tests, bibliothèques à utiliser, chemins à ne pas modifier — et qui est automatiquement chargé lors des sessions suivantes. Le contenu généré est un brouillon : corrigez-le manuellement.

Comme avec Claude Code, joignez le nom et le chemin des fichiers et évitez d’envoyer une grande demande en une seule fois. En réduisant les jetons consacrés à l’exploration, vous obtenez des résultats plus rapides et précis, tout en diminuant la facture. La fréquence des boîtes de dialogue de confirmation se règle avec /permissions. Le fonctionnement côté Claude Code est récapitulé dans Utiliser Claude Code.

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

Le principal avantage de l’utilisation avec une clé API est de choisir le modèle selon la difficulté du travail. model n’est que le nom du modèle sur le point de terminaison ; le changer ne nécessite donc ni clé ni configuration supplémentaires.

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

Le calcul d’« une tâche » considère la correction d’un test défaillant en 20 étapes. Une étape comprend 25 000 jetons en entrée (prompt système, historique de conversation et fichiers lus) et 1 200 jetons en sortie (une modification ou explication), soit 500 000 jetons en entrée et 24 000 en sortie par tâche. Avec GPT-5.6 Sol, cela donne $1.29 ; pour le même nombre de jetons directement auprès d’OpenAI, le prix promotionnel actuel est de $2.48 (prix catalogue : $3.22). Les modèles moins chers peuvent nécessiter davantage d’allers-retours en raison des reprises ; en pratique, passez au niveau supérieur si la tâche ne se termine pas en une fois.

Ce calcul ne tient pas compte du cache. Codex renvoyant l’historique à chaque étape, les entrées déjà en cache sont facturées à 0,10 fois le tarif d’entrée (avec GPT-5.6 Sol, $0.20 par million de jetons) et les nouvelles écritures dans le cache à 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’ensemble de la requête est facturé avec des entrées multipliées par 2 et des sorties par 1,5. Évitez de surcharger une seule session et relancez Codex pour chaque tâche. Les jetons de raisonnement des modèles de raisonnement sont facturés comme des sorties ; les tâches difficiles augmentent donc également la sortie. Vérifiez le coût réel dans le champ usage de la réponse et dans l’historique d’utilisation. Les spécifications du modèle figurent sur la page du modèle GPT-5.6 Sol et les tarifs de tous les modèles dans le tableau tarifaire.

Erreurs courantes

En toute franchise — quand le forfait ChatGPT est plus avantageux

Si vous travaillez chaque jour pendant de longues heures avec Codex, le forfait fixe est généralement moins cher. La facturation à l’usage étant directement proportionnelle au nombre de jetons, l’avantage du forfait fixe augmente pour les utilisateurs dont le volume est élevé et stable. Le seuil se calcule comme « montant mensuel ÷ coût d’une tâche » ; le seuil de rentabilité par rapport au forfait est calculé dans Tarifs Codex.

Deux autres points sont à connaître. Selon la documentation OpenAI, les fonctions dépendant de l’espace de travail ou du cloud ChatGPT sont limitées ou indisponibles avec une clé API. De plus, la voie Kunavo utilise une capacité partagée, sans quota dédié ni SLA contractuel. Si vous avez besoin d’un quota ou d’un SLA garanti, un contrat direct avec OpenAI est plus approprié.

À l’inverse, la clé API convient aux personnes dont l’utilisation varie fortement selon les jours, qui veulent choisir le modèle pour chaque tâche, séparer les limites et l’historique par clé au sein d’une équipe, ou poursuivre leur travail uniquement les jours où le quota du forfait est épuisé. Les deux méthodes sont compatibles. Supprimez la ligne model_provider de config.toml pour revenir à la connexion ChatGPT ; pour changer à chaque lancement, utilisez --profile de Codex.

Le paiement s’effectue par carte, notamment JCB, Apple Pay ou Google Pay, et le solde n’expire pas. Les paiements en supérettes et PayPay ne sont pas pris en charge. Les requêtes échouées ne sont pas facturées. Si vous hésitez entre Codex et Claude Code, consultez Comparaison de Codex et Claude Code.

Questions fréquentes