Guide d'installation Codex 2026 : GPT-5.5-Codex de A à Z

En 2026, OpenAI a redéfini Codex : plus seulement l'ancien modèle de complétion, mais une plateforme Agent de programmation complète. Le Codex CLI tourne dans votre terminal, lit le dépôt, modifie les fichiers et exécute des commandes ; GPT-5.5-Codex est la variante de modèle dédiée à l'ingénierie logicielle. Ce guide est la page de référence installation + usage pour le site français — trois méthodes d'installation, connexion ChatGPT, config.toml, sandbox d'approbation, bascule /model et première tâche validable. Pour le rapport avec Claude Code et Cursor, voir le comparatif structuré ci-dessous.

1. Pourquoi installer Codex CLI en 2026 ?

ChatGPT dans le navigateur peut écrire du code, mais le vrai problème des équipes est ailleurs : les suggestions dans une fenêtre de chat ne deviennent pas un git diff auditable ; les boucles de tests ne tournent pas de façon fiable ; la CI reste hors circuit. Codex CLI règle la frontière d'exécution — il place la série GPT-5.5 dans le répertoire que vous choisissez et modifie les fichiers, exécute le shell, le tout sous sandbox et politique d'approbation.

Contrairement au « Codex API » de complétion de 2021, le Codex 2026 est un Agent terminal open source écrit en Rust (dépôt openai/codex), lié à l'abonnement ChatGPT, avec extensions IDE, application desktop et tâches asynchrones Codex Cloud. Le vrai clivage n'est pas « OpenAI vs Anthropic qui gagne », mais acceptez-vous de déléguer des tâches à un Agent terminal.

2. Comment classer les quatre entrées Codex ?

Ce guide se concentre sur le Codex CLI, mais la plateforme compte quatre faces partageant ~/.codex/ :

Le chemin principal ici est CLI d'abord : une fois le CLI opérationnel, extensions IDE et App réutilisent en général la même connexion et configuration.

3. Comparatif : Codex vs Claude Code vs Cursor

Prix en langage clair : les trois démarrent autour de 20 $/mois, mais vous n'achetez pas la même chose —

• Codex et Claude Code : comme un forfait data mobile — quota qui se réinitialise toutes les quelques heures ; laisser l'IA modifier des dizaines de fichiers d'un coup consomme vite.
• Cursor : comme un abonnement salle de sport — 20 $/mois fixes, idéal si vous passez vos journées dans l'IDE ; la facture est la plus simple à prévoir.

La colonne surlignée en vert ci-dessous répond à « comment ça se facture et la note de fin de mois surprend-elle ? » — c'est souvent le critère décisif. Les colonnes de gauche décrivent les capacités ; le vert parle du budget.

Comparatif IDE détaillé : Claude Code vs Cursor 2026 ; contexte Anthropic vs OpenAI Agent : l'ère Claude Code.

4. Choisir selon le scénario

5. Combinaisons recommandées (stack 2026)

• Développeur solo — Codex CLI (GPT-5.5-Codex) + IDE habituel pour petits edits ; gros chantiers le week-end via codex.
• Full-stack + iOS — Codex/Cursor en local ; builds Xcode et signature sur Cloud Mac ou nœud GitHub Runner.
• CI d'équipe — codex exec ou Codex Cloud produit le patch → Actions compile et teste → review humaine du PR. Runner avec un job un workspace.
• Dépôts knowledge-intensive — MCP pour issues + CodeGraph optionnel ; règles dans .codex/config.toml et AGENTS.md.

6. Prérequis avant installation

• Compte — ChatGPT Plus / Pro / Business / Edu / Enterprise (Codex inclus), ou clé API OpenAI valide.
• Système — macOS et Linux en priorité ; Windows via PowerShell natif ou WSL2.
• Dépôt Git — validez dans un vrai projet, pas un dossier vide.
• Node.js 18+ — uniquement pour npm install -g @openai/codex.

uname -a
git --version
node -v   # si vous passez par npm
which codex # doit être vide (pas encore installé)

7. Trois méthodes d'installation (chemins officiels 2026)

# CI non interactive : définir d'abord
export CODEX_NON_INTERACTIVE=1

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

npm install -g @openai/codex@latest
codex --version
# EACCES : npm config set prefix ~/.npm-global, ajouter ~/.npm-global/bin au PATH

8. Connexion et authentification

Au premier codex, le TUI interactif propose :

• Sign in with ChatGPT (recommandé) — OAuth navigateur, quota dans votre plan ChatGPT.
• API Key — pour automatisation et facturation au token ; ne jamais committer la clé.

Config et identifiants dans ~/.codex/. Sur machine partagée, verrouillez les permissions ; en CI, injectez la clé via un gestionnaire de secrets.

9. GPT-5.5-Codex : modèle et config.toml

GPT-5.5 est le flagship généraliste ; GPT-5.5-Codex est optimisé pour le code (lecture dépôt, patchs, raisonnement outillage). Pour l'ingénierie quotidienne, gardez la variante Codex ; questions générales → gpt-5.5.

En session : tapez /model, choisissez gpt-5.5-codex et le niveau de reasoning.

Par défaut persistant : éditez ~/.codex/config.toml (ou .codex/config.toml au niveau projet si vous faites confiance au dépôt) :

# Modèle de programmation par défaut
model = "gpt-5.5-codex"

# Approbation : on-request = demander si l'Agent sort du sandbox
approval_policy = "on-request"

# Sandbox : read-only au début, puis workspace-write une fois le flux maîtrisé
sandbox_mode = "read-only"

# Effort de raisonnement (ajuster selon la tâche)
model_reasoning_effort = "medium"

Priorité (la dernière l'emporte) : défauts intégrés → ~/.codex/config.toml → .codex/config.toml projet → profil (codex --profile ci) → arguments CLI. Voir Config basics.

10. Usage quotidien : TUI, approbations, MCP et scripts

Mode interactif

cd your-repo
codex
# ou tâche en une ligne
codex "lance npm test et corrige les échecs sans toucher package-lock"

Modes d'approbation (ligne rouge sécurité)

Pour rm, config prod ou fichiers secrets : approuvez manuellement. L'entreprise peut interdire never ou sandbox danger-full-access via requirements.toml.

Extension MCP

Codex supporte le Model Context Protocol : déclarez un serveur MCP dans config.toml pour lire GitHub, bases de données, etc. Même logique que Claude Code MCP — voir notre tutoriel MCP pour le principe PAT à privilèges minimaux.

Exec scripté et Cloud

• codex exec "..." — exécution headless, cron / pré-vol CI.
• Subagents — découpage parallèle des grosses tâches (dans le TUI).
• Code Review local — Agent indépendant sur le diff avant commit.
• Codex Cloud — lance une tâche cloud depuis le terminal, récupère le patch en local.

11. Erreurs courantes

1. Traiter Codex comme ChatGPT web — sans CLI ni review de diff, pas de boucle d'ingénierie.
2. sandbox_mode = danger-full-access d'emblée — moins de clics, suppressions irréversibles ; commencez en read-only.
3. Lancer codex dans un sous-dossier — l'Agent ne voit que le cwd ; en monorepo, partez de la racine du package.
4. Ignorer les chemins Windows — PowerShell natif et WSL ne partagent pas le même filesystem ; choisissez une voie.
5. Comparer les modèles sans l'entrée — GPT-5.5-Codex est fort, mais si vous vivez dans Tab complétion, Cursor + extension Codex bat le TUI seul.

12. Checklist en 7 étapes

1. Installer le CLI — install.sh ou npm i -g @openai/codex, valider codex --version.
2. Se connecter — OAuth ChatGPT ou clé API, vérifier ~/.codex/.
3. Écrire config.toml — model = "gpt-5.5-codex", approval_policy = "on-request", sandbox_mode = "read-only".
4. Choisir un dépôt — projet moyen connu, git status propre ou branche feature.
5. Tâche fumée — codex "explique la structure src et dessine un arbre", vérifier la lecture fichiers.
6. Boucle complète — codex "lance [votre cmd test] et corrige les échecs", confirmer l'exécution shell.
7. Brancher la stack équipe — builds 24/7 sur Cloud Mac ; graphe via MCP si besoin.

13. FAQ

Codex, Claude Code ou Cursor — le moins cher ?

Tous partent d'environ 20 $/mois, sans gagnant absolu « moins cher ». Déjà sur ChatGPT → Codex inclus ; déjà Claude Pro → Claude Code pareil. Budget fixe depuis zéro → Cursor le plus prévisible. Usage intensif multi-fichiers → paliers 100–200 $ des deux côtés ; voir le tableau comparatif.

Codex se paie-t-il à part ?

En général non. ChatGPT Plus (20 $/mois) inclut Codex. Clé API à la consommation possible, sans certaines fonctions membres (ex. review cloud). Détails : documentation OpenAI.

Différence GPT-5.5 vs GPT-5.5-Codex ?

GPT-5.5 généraliste ; GPT-5.5-Codex affiné pour lire le code, écrire des patchs et enchaîner les outils. Par défaut pour coder : variante Codex.

Codex et Claude Code ensemble ?

Oui. Config séparée (~/.codex/ vs ~/.claude.json) ; même dépôt, scénarios différents. Harmonisez le style de code pour éviter que deux Agents se contredisent sur le formatage.

command not found après install ?

Relancez le shell ou ajoutez le binaire au PATH. Homebrew : /opt/homebrew/bin ; npm : ~/.npm-global/bin.

Comment mettre à jour Codex ?

npm install -g @openai/codex@latest ou relancez le script install ; Homebrew : brew upgrade codex.

14. Conclusion

Le tutoriel Codex 2026, c'est brancher l'Agent de programmation OpenAI sur votre filesystem et votre terminal. Trois commandes pour le CLI, connexion ChatGPT, gpt-5.5-codex par défaut dans config.toml, approbation on-request pour la sécurité — vous obtenez un workflow reproductible, scriptable et compatible Cloud. Codex rivalise avec Claude Code sur l'entrée terminal ; avec Cursor sur « qui pilote l'écriture ». La plupart des équipes finissent en double ou triple stack, pas en pari unique.

Pour les builds macOS réels : l'Agent accélère l'écriture, Xcode et le Runner restent sur du vrai Apple Silicon. Cloud Mac combine Codex en local pour les diffs et compilation distante — séparer « écrire » et « vérifier » raccourcit le chemin vers la prod.