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 key

⚠

La 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.