Codex CLI est l'agent en ligne de commande d'OpenAI, basé sur les modèles GPT-5.4 et GPT-5.3-Codex. C'est l'un des plus riches en surface : 20+ sous-commandes, 35+ slash commands en mode interactif, et un système de sandbox multi-OS parmi les plus robustes du marché (Seatbelt sur macOS, Landlock sur Linux).
Cet article regroupe toutes les commandes documentées dans une référence interactive : sous-commandes, slash commands, flags globaux, options de codex exec et codex cloud, et la gestion MCP / plugins.
Astuce : utilisez la barre de recherche pour filtrer par nom (
exec,cloud,mcp...) ou par mot-clé (« sandbox », « plan », « modèle »...).
Toutes les commandes Codex CLI
| Commande | Description |
|---|---|
| Sous-commandes principales | |
codex | Lance l'interface terminal interactive (TUI) de Codex. |
codex "prompt" | Démarre une session interactive avec un prompt initial. |
codex execalias : codex e | Exécution non-interactive (scripting). Alias : codex e. |
codex resume | Reprend une session interactive précédente. --last pour la plus récente. |
codex fork | Branche une session précédente dans un nouveau thread. |
codex apply <task-id> | Applique le diff d'une tâche cloud au dépôt local. |
codex cloud | Gère les tâches cloud depuis le terminal (sélecteur interactif). |
codex login | Authentification : OAuth navigateur (par défaut), --device-auth, ou --with-api-key. |
codex logout | Supprime les identifiants stockés. |
codex app | Ouvre l'application desktop Codex. |
codex app-server | Lance un serveur d'application local pour le développement. |
codex completion <shell> | Génère les scripts d'auto-complétion shell (bash, zsh, fish). |
codex update | Vérifie et applique les mises à jour de la CLI. |
codex mcp | Gère les serveurs MCP (Model Context Protocol). |
codex mcp-server | Lance Codex lui-même comme serveur MCP. |
codex sandbox | Exécute des commandes sous différentes politiques de sandbox. |
codex execpolicy | Évalue les règles de politique d'exécution. |
codex features | Gère les feature flags (list, enable, disable). |
codex plugin marketplace | Gère les sources du marketplace de plugins (add, remove, upgrade). |
| Session & navigation (slash) | |
/model | Choisit le modèle actif (GPT-5.4, GPT-5.3-Codex, etc.) et ajuste le niveau de raisonnement. |
/fast | Active le mode rapide pour les modèles supportés. |
/plan | Bascule en mode Plan, optionnellement avec un prompt. |
/goal | Définit ou affiche l'objectif d'une tâche longue (expérimental). |
/personality | Choisit un style de communication pour les réponses. |
/new | Démarre une nouvelle conversation dans la même session CLI. |
/resume | Reprend une conversation sauvegardée depuis la liste de sessions. |
/fork | Branche la conversation courante dans un nouveau thread. |
/side | Démarre une conversation secondaire éphémère sans quitter le travail principal. |
| Permissions & configuration (slash) | |
/permissions | Définit ce que Codex peut faire sans demander confirmation. |
/sandbox-add-read-dir | Accorde l'accès lecture au sandbox (Windows uniquement). |
/experimental | Active/désactive les fonctionnalités expérimentales. |
/statusline | Configure les éléments de la barre d'état (footer). |
/title | Configure les champs de titre du terminal/onglet. |
/keymap | Remappe les raccourcis clavier de l'interface terminal. |
/debug-config | Affiche les couches de configuration et diagnostics. |
| Outils & espace de travail (slash) | |
/diff | Affiche le diff Git, y compris les fichiers non suivis par Git. |
/mention | Attache un fichier à la conversation (avec autocomplétion de chemin). |
/mcp | Liste les outils MCP (Model Context Protocol) configurés. |
/apps | Parcourt les apps disponibles et les insère dans les prompts. |
/plugins | Parcourt les plugins installés et découvrables. |
| Gestion de session (slash) | |
/status | Affiche la configuration de session et la consommation de tokens. |
/agent | Bascule entre les threads d'agent actifs. |
/clear | Efface le terminal et démarre un nouveau chat. |
/compact | Résume la conversation visible pour libérer des tokens. |
/copy | Copie la dernière sortie complète de Codex. |
/review | Demande à Codex de relire votre arbre de travail (working tree). |
/init | Génère un fichier AGENTS.md (équivalent de CLAUDE.md pour Codex). |
/ps | Affiche les terminaux en arrière-plan et leur sortie récente. |
/stop | Annule tous les terminaux en arrière-plan. |
| Système (slash) | |
/feedback | Envoie des logs aux mainteneurs Codex. |
/logout | Déconnecte le compte Codex. |
/quitalias : /exit | Quitte la CLI Codex. |
| Flags globaux CLI | |
-m, --model <nom> | Définit le modèle pour la session (ex : gpt-5.4). |
-p, --profile <nom> | Charge un profil de configuration nommé. |
-c, --config <CLE=VAL> | Surcharge une valeur de configuration ponctuellement. |
-C, --cd <chemin> | Définit le répertoire de travail avant exécution. |
--add-dir <chemin> | Accorde l'accès en écriture à des répertoires supplémentaires. |
-s, --sandbox <politique> | Niveau du sandbox : read-only, workspace-write, danger-full-access. |
-a, --ask-for-approval | Contrôle les demandes d'approbation : untrusted, on-request, never. |
--dangerously-bypass-approvals-and-sandboxalias : --yolo | Saute toutes les vérifications de sécurité (à utiliser avec extrême prudence). |
-i, --image <fichier> | Attache un ou plusieurs fichiers image au prompt (screenshots, design). |
--search | Active la recherche web en direct. |
--enable <flag> | Active un feature flag de force. |
--disable <flag> | Désactive un feature flag de force. |
--oss | Utilise un fournisseur open source local au lieu d'OpenAI. |
--remote ws://host:port | Connecte le TUI à un app-server distant. |
--no-alt-screen | Désactive l'écran alternatif (mode terminal classique). |
| Flags codex exec | |
--json | Sortie en JSON ligne par ligne (newline-delimited JSON). |
-o, --output-last-message <fichier> | Enregistre le dernier message assistant dans un fichier. |
--output-schema <fichier> | Valide la sortie contre un schéma JSON Schema fourni. |
--ephemeral | Ne persiste pas les fichiers de session (mode jetable). |
--ignore-rules | Saute les règles d'execpolicy. |
--ignore-user-config | Ignore le chargement de config.toml utilisateur. |
--skip-git-repo-check | Autorise l'exécution dans un répertoire non-Git. |
--color <auto|always|never> | Contrôle le coloriage ANSI de la sortie. |
| Flags codex cloud | |
codex cloud exec <query> | Soumet directement une tâche au cloud sans passer par le sélecteur interactif. |
codex cloud list | Liste les tâches récentes (sortie scriptable). |
--env <env-id> | Environnement cloud cible (requis pour les tâches cloud). |
--attempts 1-4 | Nombre de tentatives best-of-N pour la tâche. |
--limit 1-20 | Nombre maximum de tâches à retourner (avec list). |
--cursor <token> | Token de pagination pour parcourir les tâches. |
| MCP & plugins | |
codex mcp add <nom> | Enregistre un serveur MCP (stdio ou HTTP). Options : -- <commande>, --url, --env. |
codex mcp list | Liste tous les serveurs MCP configurés. |
codex mcp get <nom> | Affiche la configuration d'un serveur MCP. |
codex mcp remove <nom> | Supprime la définition d'un serveur MCP. |
codex mcp login <nom> | Connexion OAuth pour les serveurs MCP HTTP. |
codex mcp logout <nom> | Supprime les identifiants OAuth d'un serveur MCP. |
codex plugin marketplace add <source> | Ajoute une source au marketplace (GitHub shorthand, URL Git, SSH, chemin local). |
codex plugin marketplace remove <nom> | Supprime une source du marketplace. |
codex plugin marketplace upgrade [nom] | Met à jour les plugins (tous ou un en particulier). |
Préfixes & syntaxe
Codex CLI utilise le préfixe / pour les slash commands en mode interactif. Pour attacher un fichier au prompt, utilisez la commande /mention (équivalent du @ chez Claude Code et Gemini).
Modes & sandbox
Codex offre l'un des systèmes de sandbox les plus stricts. Trois niveaux sont disponibles via -s, --sandbox :
| Politique | Comportement |
|---|---|
read-only |
Lecture seule. Codex ne peut rien modifier. |
workspace-write |
Écriture autorisée dans le workspace courant uniquement. |
danger-full-access |
Accès complet (équivalent de --yolo). À éviter en production. |
Sur macOS, Codex s'appuie sur Seatbelt. Sur Linux, sur Landlock. Cela offre une isolation au niveau noyau, plus forte que les autres CLI d'agents.
Authentification
Trois méthodes :
| Méthode | Commande |
|---|---|
| OAuth navigateur (par défaut) | codex login |
| Authentification par appareil | codex login --device-auth |
| Clé API | codex login --with-api-key |
| Vérifier le statut | codex login status |
Pour les utilisateurs de ChatGPT Plus / Pro, la connexion via compte ChatGPT est la méthode recommandée — pas besoin de gérer une clé API.
Mode non-interactif : codex exec
codex exec est conçu pour le scripting et l'automatisation :
codex exec --json --sandbox workspace-write "Refactore ce module en TypeScript"
codex e -o /tmp/result.txt --output-schema schema.json "Génère du JSON valide"
Les flags clés : --json (sortie ligne par ligne), --output-schema (validation JSON Schema), --ephemeral (pas de persistance), --ignore-rules (sauter execpolicy).
Codex Cloud
Codex peut déléguer des tâches à un environnement cloud OpenAI :
codex cloud # sélecteur interactif
codex cloud exec "Lance la suite de tests sur Node 20"
codex cloud list --limit 10
codex apply <task-id> # applique le diff de retour au dépôt local
C'est le pendant de Cloud Agents chez Cursor ou /ultrareview chez Claude Code.
Pour aller plus loin
AGENTS.md: généré par/init, c'est l'équivalent duCLAUDE.md. Documentez votre projet une fois pour toutes.- Profils
-p: créez des profils nommés dansconfig.toml(modèle, sandbox, approbations) et activez-les aveccodex -p production. --oss: utilisez un fournisseur LLM open source local pour les données sensibles, sans envoyer de tokens à OpenAI.- MCP étendu :
codex mcp addsupporte stdio ET HTTP, ce que peu d'agents proposent. - Subagents avec
/agent: Codex permet de basculer entre threads d'agent indépendants dans la même session.
Conclusion
Codex CLI excelle sur deux axes : la rigueur de sandbox (Seatbelt / Landlock natifs) et la scriptabilité (exec + --json + --output-schema). Si vous automatisez des workflows ou avez besoin d'isoler strictement vos exécutions IA, Codex est probablement le meilleur choix.
Pour les utilisateurs déjà abonnés à ChatGPT Plus / Pro, l'accès est inclus, ce qui en fait un excellent point d'entrée gratuit.
Chez ReadyGo, nous évaluons régulièrement ces agents IA pour livrer des sites Next.js modernes à nos clients. Si vous cherchez un partenaire qui maîtrise les outils nouvelle génération, parlons de votre projet.
À lire aussi : Claude Code : Guide Complet, Cursor Agent CLI : Guide Complet, Comparatif Claude Code vs Cursor vs Codex vs Gemini.
À retenir.
- Codex CLI est riche : 20+ sous-commandes, 35+ slash commands, des dizaines de flags. Plus large surface que Cursor, comparable à Claude Code.
- Sandbox multi-OS robuste : Seatbelt (macOS) et Landlock (Linux) en natif. Trois niveaux : read-only, workspace-write, danger-full-access.
- Mode non-interactif puissant : codex exec --json --output-schema permet du scripting JSON validé contre un schéma. Idéal pour CI/CD.
- Codex Cloud déporte les tâches longues sur des environnements distants, puis applique les diffs au dépôt local via codex apply.
- AGENTS.md (généré par /init) joue le rôle du CLAUDE.md chez Anthropic. Documentez votre projet une fois pour toutes.