Ce que c'est
Codex CLI est l'agent en ligne de commande officiel d'OpenAI pour le coding, sorti en 2025 et maintenu sur le repo openai/codex sous Apache-2.0. Il tourne localement dans votre terminal, se branche sur l'auth ChatGPT Pro/Plus ou API, et utilise les modèles de raisonnement d'OpenAI (famille GPT-5 + série o) avec un tooling complet d'édition de fichiers, shell et patch.
Codex CLI est aussi l'outil qui a popularisé la convention AGENTS.md — un équivalent vendor-neutre du CLAUDE.md de Claude. AGENTS.md est désormais adopté par plusieurs agents (Aider, Continue.dev, bientôt Gemini CLI), rendant vos instructions au niveau projet portables.
C'est l'outil à atteindre quand :
- Vous payez déjà ChatGPT Pro/Plus et voulez utiliser ce quota pour coder en terminal.
- Vous voulez un fichier d'instructions vendor-neutre que d'autres agents respecteront.
- Vous aimez les forces des modèles de raisonnement d'OpenAI sur les passes de bug-finding et de planification de refactor.
Pourquoi il se démarque
| Fonctionnalité | Ce qu'elle apporte |
|---|---|
| Auth ChatGPT | Connexion avec votre compte ChatGPT Pro/Plus — pas d'API key séparée |
| AGENTS.md | Fichier d'instructions vendor-neutre, supporté entre agents |
| Apache-2.0 | Même licence OSI que Gemini CLI ; vous pouvez forker librement |
| Support MCP | Ajouté fin 2025 ; Codex CLI lit désormais ~/.codex/mcp.json |
| Modes d'approbation | --auto-edit, --full-auto, --read-only pour confiance graduée |
| Modèles de raisonnement | Forces de GPT-5 / série o sur les passes de planification profonde |
| Shell sandboxé | Apple Seatbelt sur macOS, Landlock sur Linux pour exec plus sûr |
Comment installer
# macOS / Linux / WSL
npm install -g @openai/codex
# Ou via Homebrew
brew install codex
Après installation, lancez codex dans n'importe quel répertoire de projet. Le premier run demande un login ChatGPT (OAuth navigateur) ou OPENAI_API_KEY. Déposez un AGENTS.md à la racine du repo avec les conventions du projet et Codex CLI le lira au début de chaque session.
Quoi installer dans Codex CLI
La surface de Codex CLI utilise deux configs principales : ~/.codex/config.toml pour les settings globaux et AGENTS.md (niveau projet) pour les instructions. Trois packs TokRepo pour démarrer :
- Templates AGENTS.md — fichiers d'instructions éprouvés pour monorepos Python / Node / Go / Rust
- Stack de Serveurs MCP — serveurs MCP Postgres, GitHub, Filesystem partagés avec Claude Code
- OpenAI Reasoning Workflow Pack — commandes codex calibrées pour les forces de la série o
Lancez tokrepo install sur n'importe lequel et votre AGENTS.md plus le répertoire ~/.codex/ démarrent sur la baseline montrée dans les previews de recherche d'OpenAI.
Pièges courants
- Mélanger API key et auth ChatGPT — choisissez l'un ; mélanger fait que le CLI ping les deux endpoints avec des quotas conflictuels.
- Oublier le coût de
--full-auto— full auto exécute toutes les commandes shell proposées ; couplez avec un sandbox ou vous refereznpm install30 fois dans une boucle de refactor. - AGENTS.md qui enfle — Codex le relit à chaque tour. Gardez sous 200 lignes ou découpez en fichiers
AGENTS.mdpar répertoire. - Résolution de path MCP — Codex regarde
~/.codex/mcp.json, pas.claude/. Ne les symlinkez pas ; convertissez avec le flagtokrepo migrateinclus. - macOS Seatbelt bloque les outils GUI — si vos tâches ont besoin d'automation navigateur, lancez avec
--sandbox=noneuniquement dans une VM jetable, jamais sur votre machine de dev.
Relation avec les autres outils
La plus grande victoire de Codex CLI est la convention AGENTS.md — beaucoup d'agents respectent ce fichier, donc bien l'écrire paie à travers toute votre toolchain. Comparé à Claude Code, Codex CLI a un écosystème subagent moins mature mais une intégration plus serrée avec les comptes ChatGPT Pro. Comparé à Gemini CLI, il manque la fluidité multimodale mais offre les modèles série o pour refactors durs. Beaucoup d'équipes en 2026 utilisent Codex CLI comme environnement d'écriture AGENTS.md et font tourner d'autres agents pour des phases spécifiques.
Les plus installés pour Codex CLI
7 ressources compatibles avec Codex CLI
Questions fréquentes
Codex CLI est-il gratuit ?
Le CLI lui-même est Apache-2.0 open source et gratuit. Pour le faire tourner il faut soit une API key OpenAI (pay-as-you-go) soit un abonnement ChatGPT Pro/Plus. ChatGPT Pro à $200/mois donne le quota Codex CLI le plus généreux ; Plus à $20/mois marche pour usage léger.
Qu'est-ce qu'AGENTS.md et pourquoi Codex CLI l'utilise ?
AGENTS.md est un fichier vendor-neutre à la racine de votre projet qui dit à n'importe quel agent comment travailler dans ce codebase — conventions de code, commandes de build, choses à éviter. Codex CLI a été le premier agent majeur à le supporter, et la spec sur agents.md est désormais adoptée par Aider, Continue et d'autres. Écrivez une fois, portez entre outils.
Codex CLI fonctionne-t-il avec les modèles Claude ou Gemini ?
Officiellement Codex CLI sort en pointant sur les modèles OpenAI (GPT-5, série o). Des forks communautaires permettent de changer les base URLs vers OpenRouter ou des endpoints Anthropic-compatibles, mais les schémas tool-call diffèrent assez pour être fragiles. La voie mainstream est modèles OpenAI pour Codex CLI, CLIs séparés pour les autres vendors.
Codex CLI vs Claude Code — lequel est meilleur ?
Forces différentes. Claude Code a l'écosystème subagent et hooks le plus mature. Codex CLI a la meilleure intégration ChatGPT Pro et a démarré la convention AGENTS.md. Beaucoup de devs lancent les deux : Codex CLI quand ils veulent les modèles de raisonnement OpenAI, Claude Code pour refactors longs multi-étapes.
Codex CLI peut-il tourner en CI / non-interactif ?
Oui. Utilisez codex --quiet --full-auto avec OPENAI_API_KEY réglé. Pattern courant : job GitHub Actions qui lance Codex CLI pour drafter une review de PR ou un codemod, puis des humains approuvent avant le merge. Couplez avec --sandbox=workspace-write pour limiter les dégâts.
Découvrez tous les outils sur la page d'accueil
8 outils curatés · logos réels · groupés par type
Retour à tous les outils