Aide-mémoire OpenAI Codex CLI : Commandes et configuration

OpenAI Codex CLI est l'agent de programmation natif en terminal d'OpenAI : il inspecte les bases de code, modifie des fichiers, lance les tests, s'intègre aux tâches distantes Codex Cloud et se connecte à des outils externes via MCP directement depuis votre ligne de commande.

Cet aide-mémoire couvre les sous-commandes et options de Codex CLI, les politiques de sandbox et d'approbation, les commandes slash interactives en TUI, les raccourcis clavier ainsi que la configuration via config.toml et AGENTS.md.

🔗 Aides-mémoire associés : Comparatif des CLI d'agents de codage en terminal · Aide-mémoire Claude Code CLI · Aide-mémoire Antigravity CLI (agy) · Aide-mémoire ingénierie AI Agent Harness

1. Installation, authentification et commandes CLI principales

1.1 Installation et authentification

Action	Commande	Remarques
Installation globale npm	`npm install -g @openai/codex`	Installation multiplateforme standard
Script d'installation officiel	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Installateur en une ligne pour macOS / Linux
Connexion via navigateur	`codex login`	Authentification avec un compte ChatGPT Plus / Pro / Team
Authentification par clé API	`export OPENAI_API_KEY="sk-..."`	Idéal pour la CI sans interface ou les environnements conteneurisés

1.2 Sous-commandes CLI et options globales

Commande / Option	Description	Exemple d'utilisation
`codex`	Lance la TUI interactive dans le répertoire courant	`codex`
`codex "prompt"`	Démarre une session interactive avec un prompt initial	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	Exécution non interactive (headless) pour scripts et CI	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	Diffuse des logs JSON structurés du raisonnement et des éditions	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	Revue de code non interactive sur le diff Git courant	`codex review`
`codex resume`	Ouvre le sélecteur de sessions (stockées dans `~/.codex/sessions/`)	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Applique localement les diffs produits par des tâches Codex Cloud	`codex apply <task_id>`
`codex cloud`	Inspecte ou gère les tâches distantes Codex Cloud	`codex cloud`
`codex mcp`	Gère les intégrations de serveurs Model Context Protocol (MCP)	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	Spécifie le modèle sous-jacent pour la session ou l'exécution	`codex -m gpt-6.1-sol`
`--strict-config`	Valide strictement la syntaxe et les clés de `config.toml`	`codex --strict-config`

2. Matrice des politiques de sandbox et d'approbation

Codex CLI sépare les permissions en deux couches orthogonales : ce à quoi l'environnement peut toucher (--sandbox) et quand demander confirmation à l'utilisateur (--ask-for-approval).

Option	Valeurs valides	Comportement et usage recommandé
`--sandbox <mode>` (alias `-s`)	`read-only`	Lecture seule : inspecter et rechercher dans le code sans modifier de fichiers
	`workspace-write`	Écriture dans le workspace (défaut recommandé) : autorise les éditions uniquement dans l'arborescence de travail
	`danger-full-access`	Accès sans restriction : accès complet au système de fichiers/système (conteneurs isolés uniquement)
`--ask-for-approval <policy>`	`on-request`	Défaut recommandé : le modèle demande confirmation lorsque des actions risquées l'exigent
	`on-failure`	Escalader uniquement en cas d'échec (utilisez `on-request` si les demandes d'élévation sandbox comptent)
	`never`	Totalement silencieux : ne jamais demander de confirmation interactive (pour CI / pipelines automatisés)

⚠️ Avis sur les options dépréciées et retirées :

--full-auto est dépréciée depuis v0.128.0. Indiquez explicitement les politiques de sandbox et d'approbation : codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

La politique d'approbation untrusted a été retirée dans v0.149.0 ; migrez vos configurations vers on-request.

3. Commandes slash interactives de la TUI

Saisissez / dans l'invite interactive codex pour piloter le contexte, les permissions et les workflows :

3.1 Contexte, modèles et permissions

Commande	Fonction	Remarques et usage
`/init`	Génère un fichier initial `AGENTS.md` adapté au dépôt	Première étape recommandée dans un nouveau projet
`/status`	Inspecte le modèle actif, les permissions et l'usage en tokens	Surveille la capacité restante dans la fenêtre de contexte
`/model`	Change interactivement de modèle et de niveau de Reasoning Effort	Ajuste la profondeur de réflexion sans redémarrer
`/permissions`	Modifie le mode sandbox et la politique d'approbation en cours de session	Resserre ou assouplit les permissions à la demande
`/mcp`	Inspecte et gère les serveurs MCP connectés	Vérifie la connectivité des outils externes et bases de données

3.2 Workflows d'ingénierie et contrôle de session

Commande	Fonction	Remarques et usage
`/plan`	Rédige et valide un plan d'implémentation avant d'éditer les fichiers	Aligne l'architecture avant de gros refactorings
`/review`	Lance une revue multi-angles sur les modifications non commitées	Détecte bugs, cas limites et risques de sécurité
`/diff`	Inspecte les modifications de fichiers non encore commitées	Relit les diffs ligne par ligne avant validation
`/fork`	Clone le fil de conversation vers un point de contrôle distinct	Explore une approche alternative sans polluer le contexte principal
`/compact`	Résume l'historique de conversation pour libérer du contexte	Évite la dérive lors de longues sessions multi-tours
`/copy`	Copie la dernière réponse complète dans le presse-papiers	Extrait rapidement correctifs ou synthèses
`/title`	Renomme le fil de conversation actif	Facilite le repérage dans `codex resume`
`/statusline` / `/theme`	Personnalise la barre d'état ou le thème de couleur de la TUI	Adapte l'affichage terminal
`/prompts:<name>`	Invoque un modèle de prompt Markdown personnalisé	Exécute `~/.codex/prompts/<name>.md`

4. Raccourcis clavier terminal et syntaxe de saisie

Raccourci / Syntaxe	Action	Effet et scénario
`@<path>`	Référence de fichier floue	Injecte le contenu d'un fichier en ligne (ex. `@src/auth.ts`)
`!<command>`	Commande shell locale en ligne	Exécute des commandes shell selon les règles sandbox actives (ex. `!npm test`)
`Tab`	Mettre en file le prochain prompt	Ajoute un prompt, une commande slash ou `!` en file d'attente pendant que Codex travaille
`Enter`	Interrompre / réorienter en direct	Injecte des consignes supplémentaires pendant la réponse de l'agent
`Ctrl + G`	Ouvrir l'éditeur externe	Rédige des prompts multilignes dans `$VISUAL` / `$EDITOR` (Vim, VS Code, etc.)
`Ctrl + R`	Rechercher dans l'historique	Recherche inversée dans les prompts précédemment envoyés
`Ctrl + L`	Effacer et redessiner l'écran	Nettoie le terminal tout en préservant l'état de la conversation
`Ctrl + O`	Copier la dernière sortie	Équivalent à `/copy`
`Ctrl + X`	Ouvrir le menu clavier	Accède aux préréglages clavier et extensions
`Ctrl + C`	Annuler / Quitter	Interrompt la tâche active ou quitte la session Codex

5. Fichiers de configuration et hiérarchie mémoire (`config.toml` et `AGENTS.md`)

Les réglages au niveau du projet remplacent les valeurs globales par défaut de l'utilisateur :

Couche	Portée globale (tous dépôts)	Portée projet (dépôt courant)	Rôle
Config principale	`~/.codex/config.toml`	`.codex/config.toml`	Modèle par défaut, sandbox, politique d'approbation, réseau, MCP
Instructions agent	`~/.codex/AGENTS.md`	`./AGENTS.md` (racine du dépôt)	Commandes build/test, normes de code, règles d'architecture
Prompts personnalisés	`~/.codex/prompts/*.md`	—	Modèles réutilisables de commandes slash `/prompts:<name>`
Journaux de session	`~/.codex/sessions/`	—	Historique persistant restauré par `codex resume`

Configuration minimale recommandée pour `~/.codex/config.toml`

# Modèle par défaut
model = "gpt-6.1-sol"

# Sandbox et politique d'approbation par défaut
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# Restreindre par défaut l'accès réseau sortant dans le sandbox
network_access = false