OpenAI Codex CLI
L'agent de codage en terminal officiel d'OpenAI. Comme il parle l'API OpenAI standard, les deux mêmes variables d'environnement débloquent tous les outils compatibles OpenAI de l'écosystème — une fois que Codex fonctionne, Aider / Continue / LangChain / la CLI openai brute fonctionnent aussi.
Avant de commencer
Créez une clé API sur Console → API Keys. Copiez-la immédiatement — elle n'est affichée qu'une seule fois.
Étape 1 — Définir les variables d'environnement
# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..." # your Synthorai keyLa base URL compatible OpenAI doit se terminer par /v1. Contrairement au SDK Anthropic, le SDK OpenAI ne l'ajoute pas automatiquement. Une erreur courante est de coller https://synthorai.io ; les requêtes atteindront alors /chat/completions (404) au lieu de /v1/chat/completions.
Étape 2 — Envoyer votre première requête
# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py
# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"La même configuration fonctionne pour le openai CLI, les SDK Python/Node, Aider et tout autre outil compatible OpenAI — ils lisent tous OPENAI_BASE_URL et OPENAI_API_KEY.
Modèles recommandés
| Paramètre | Type | Description |
|---|---|---|
gpt-5.3-codex | coding | Optimisé pour la génération de code. Choix par défaut pour Codex CLI. |
gpt-5.4 | reasoning | Raisonnement phare. À utiliser pour des refactorisations au niveau de l'architecture. |
gpt-5.4-mini | fast | Rapide, économique, et toujours très capable. Bon choix par défaut pour les tâches courtes. |
gpt-5.4-nano | cheapest | L'option OpenAI la moins chère. À utiliser pour les petites modifications et la classification. |
Dépannage
« 404 Not Found » sur /chat/completions — votre OPENAI_BASE_URL n'a pas le /v1 suffixe. Correctif : export OPENAI_BASE_URL="https://synthorai.io/v1".
« Toujours en train d'atteindre api.openai.com » — les nouvelles variables d'environnement ne s'appliquent qu'aux nouveaux shells. Ouvrez un terminal neuf, ou source votre profil.
« Modèle introuvable » — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" pour voir la liste exacte disponible pour votre workspace.
Surcharge par projet — si vous ne voulez pas ces variables globalement, placez-les dans un projet .envrc (avec direnv) ou une fonction par shell.
Découvrez comment les quatre niveaux se comparent en prix dans le model price comparison.