Tutoriel Codex CLI : installation, connexion et première tâche
Tout ce qu'il faut pour une première session : installer et se connecter, faire expliquer un dépôt inconnu, livrer un changement en mode full-auto, et reconstruire une capture d'écran en application fonctionnelle — à jour avec la version 0.157.0 et GPT-6 Sol et Luna.
Codex CLI en un coup d'œil
- Une seule installation : npm install -g @openai/codex, puis connexion avec votre forfait ChatGPT ou une clé API.
- Le premier prompt qui paie toujours : "explain this codebase to me and how do I run it?"
- --full-auto modifie les fichiers et exécute les commandes en bac à sable — la démo de lancement a livré tout un thème sombre en un seul prompt.
- La 0.157.0 ajoute GPT-6 Sol et Luna au catalogue, la prise en charge d'Amazon Bedrock et une touche f qui crée un fork de la session vers une autre application.
OpenAI Codex CLI
Vidéo:OpenAI6:19
Codex CLI in 12 mins
Vidéo:lustoykov12:14
openai/codex releases
Changelog:GitHub changelog
Chaque capture d'écran de cette page provient de la vidéo de lancement officielle de Codex CLI par OpenAI — uniquement des captures de terminal et de navigateur, sans aucun cadrage caméra. Les commandes, drapeaux et détails du flux de travail ont été recoupés avec la seconde vidéo ; les faits de version viennent du changelog officiel lié ci-dessus.
Vidéos sources : OpenAI ("OpenAI Codex CLI") et lustoykov ("Codex CLI in 12 mins") sur YouTube, reliées par liens profonds horodatés. Le texte de la page est original.
Le pas-à-pas : 14 étapes
Installer Codex CLI et se connecter
- 1
Installer Codex CLI globalement
Codex CLI se distribue via npm — lancez npm install -g @openai/codex dans n'importe quel terminal. Seul prérequis : Node.js (à prendre sur nodejs.org si besoin) ; sur macOS, brew install --cask codex fonctionne aussi. Le CLI est open source sur GitHub sous Apache-2.0.
- 2
Lancer Codex et se connecter
Lancez codex : le premier démarrage guide la connexion. Choisissez Sign in with ChatGPT pour utiliser un forfait Plus, Pro, Business, Edu ou Enterprise existant (une option par code d'appareil est aussi proposée), ou fournissez votre propre clé API pour payer au token. Le navigateur gère la connexion et le terminal confirme quand c'est fait.
Première tâche : faire expliquer une base de code
- 3
Lancer Codex dans un dépôt et poser LA question qui compte
cd dans n'importe quel projet puis relancez codex — une session de travail démarre cette fois. Avant même de taper, l'en-tête affiche le répertoire de travail, le modèle actif et le mode d'approbation. Dans la démo de lancement d'OpenAI, la cible était openai-fm et la question universelle : "explain this codebase to me and how do I run it?"
L'en-tête de session d'abord, la question ensuite — puis Entrée.Voir à 1:27 - 4
Lire le High-level overview renvoyé par Codex
Codex lit les fichiers et répond de façon structurée : quel framework et quelle pile de styles, où vit l'état, comment l'audio est généré et quelles routes sont optionnelles. C'est le moyen le plus rapide de se repérer dans une base de code inconnue.
L'aperçu nomme la pile : Next.js 15, React 19, Tailwind 4 et Zustand.Voir à 1:45 - 5
Étudier la Typical file map
La réponse enchaîne avec une carte des fichiers — layout.tsx pour le HTML global, page.tsx comme page d'entrée, api/ pour les routes serveur — pour que vos prochains prompts citent de vrais chemins au lieu de descriptions vagues.
Chaque chemin de la carte est un contexte à citer dans le prompt suivant.Voir à 1:50 - 6
Suivre les instructions d'exécution écrites par Codex
La même réponse se termine par un mode opératoire prêt à coller : Node 20+ et une clé API, git clone et npm install, une ligne OPENAI_API_KEY dans .env.local, puis npm run dev avec next dev --turbopack et un passage sur http://localhost:3000. Dans Codex, vous pouvez aussi lancer des commandes shell vous-même avec le préfixe !.
Du clone au serveur de dev sans ouvrir une seule doc.Voir à 1:55 - 7
Voir la page cible en mode clair
La première modification de la démo est un changement de thème sur le site qui vient de tourner. OpenAI.fm s'affiche en mode clair avec des cartes de voix, des préréglages de vibe et le bouton orange Play — connaître l'état actuel avec cette précision, c'est ce qui fait fonctionner le prompt suivant.
Avant : mode clair, cartes de voix, préréglages de vibe, Play orange.Voir à 1:15
Première modification : un thème sombre en full-auto
- 8
Relancer en full-auto avec un prompt précis
Quittez puis relancez codex --full-auto, et décrivez le changement : "Implement dark mode based on system settings — make sure every surface adapts automatically, like buttons and toggles." Full-auto laisse Codex modifier les fichiers et exécuter des commandes sans redemander à chaque fois ; la démo d'OpenAI le décrit comme réseau désactivé et bac à sable limité au répertoire de lancement. Les builds actuels exposent ces réglages via --ask-for-approval (untrusted, on-request, never) et --sandbox (read-only, workspace-write, danger-full-access).
- 9
Vérifier le résultat : chaque surface s'adapte
Après un rafraîchissement, le site est entièrement sombre — fond, cartes et texte suivent le réglage système, et le prompt de la démo a même renommé le bouton Play en Introduce Codex. Full-auto reste en bac à sable : une mauvaise modification ne touche que votre copie de travail.
Mode sombre après un seul prompt — texte du bouton mis à jour aussi.Voir à 3:05
D'une capture d'écran à une application qui tourne
- 10
Repartir de zéro dans un dossier vide
Capture d'écran vers application, c'est le numéro de Codex. Créez un dossier vide puis lancez avec modèle, mode d'approbation et pièce jointe en une ligne : codex -m o4-mini -a full-auto -i <capture>. -i joint une image, -a règle les approbations, -m choisit le modèle.
Une commande fixe modèle, approbations et image jointe.Voir à 3:50 - 11
Laisser Codex analyser la capture
L'en-tête de session confirme ce que Codex a reçu — workdir, modèle, approbation full-auto et chemin de l'image — puis le premier tour est pur Thinking : il étudie l'image avant la moindre ligne de code.
La capture jointe figure dans l'en-tête avant tout code écrit.Voir à 3:58 - 12
Répondre aux questions de clarification
Plutôt que de deviner, Codex répond par une section Clarifying user intent : construire quelque chose de semblable en Python/OpenCV ? implémenter un effet précis comme thermal-vision ? besoin de repères UI/mise en page ? Quelques lignes de texte transforment la capture floue en cahier des charges.
Trois questions plus tard, la capture devient un cahier des charges.Voir à 4:00 - 13
Regarder l'application mono-fichier s'écrire
Le cahier des charges posé, Codex diffuse un apply_patch qui crée index.html de haut en bas : une grille de canvas dimensionnée via devicePixelRatio, ctx.drawImage par panneau, requestAnimationFrame pour la vidéo en direct et un écouteur load — puis annonce Done.
Le patch se termine par Done — toute l'application tient dans un fichier HTML.Voir à 4:42 - 14
Ouvrir index.html et comparer
Codex conclut avec la recette : neuf canvas en grille 3×3, des filtres de Sepia et B&W à Comic Book, Thermal et X-Ray, l'orientation paysage via l'API Screen Orientation — et la consigne d'ouvrir simplement index.html en HTTPS ou localhost pour que la caméra fonctionne.
Ce message final fait office de README de l'application générée.Voir à 4:50
Règles de maison : AGENTS.md, bac à sable et commandes à connaître
Lancez /init et Codex génère un AGENTS.md dans le dépôt — un fichier façon prompt système lu avant chaque tâche : conventions de nommage, framework et tests vivent dans le projet au lieu d'être retapés à chaque session.
Approbations et isolement sont les deux molettes à comprendre. /permissions bascule l'accès complet dans une session ; --ask-for-approval (untrusted, on-request, never) et --sandbox (read-only, workspace-write, danger-full-access) fixent les valeurs par défaut, et ~/.codex/config.toml les conserve durablement. La combinaison --yolo, c'est never + danger-full-access — pratique, et dangereux exactement autant que ça en a l'air.
Les commandes du quotidien : /model change de modèle et d'effort de raisonnement (medium est un bon défaut — high brûle des tokens), /plan transforme une demande en plan vérifiable, /review audite les changements non commités ou une branche, /compact libère du contexte après les longues sessions, /new ouvre une conversation propre. Hors TUI, codex exec "…" exécute des tâches ponctuelles non interactives et codex resume (ou codex resume-last) rouvre une session fermée. Référencez les fichiers avec @ et chargez les skills avec $ — des dossiers avec un fichier d'instructions, installés sous ~/.codex/skills.
Nouveau dans Codex CLI 0.157.0 : GPT-6 Sol et Luna, Amazon Bedrock, touche de fork
La version 0.157.0 est arrivée le 25 septembre 2026. Cinq changements du changelog officiel qui justifient la mise à jour :
- 1GPT-6 Sol et Luna rejoignent le catalogue de modèles — ils apparaissent dans /model comme n'importe quelle autre entrée.
- 2La prise en charge d'Amazon Bedrock arrive, avec les catalogues Bedrock des nouveaux modèles et des invites de migration pour les anciens noms de modèles.
- 3La transcription plein écran est activée par défaut, avec une sélection de texte Shift-click élargie.
- 4Un nouveau raccourci f crée un fork de la conversation ouverte vers une autre application, en conservant brouillons et prompts en file d'attente.
- 5/import fonctionne désormais dans les sessions distantes et les sessions background-server locales, qui démarrent automatiquement pour les sessions interactives éligibles.
Quel modèle choisir ? GPT-6 Sol est ce que la barre d'état affiche par défaut — gardez-le pour le travail agentique exigeant. Luna est étiquetée modèle agentique rapide et abordable, idéale pour les petites modifications et les exécutions fréquentes, et Terra s'interpose comme l'option quotidienne équilibrée. Basculez avec /model, réglez l'effort de raisonnement par modèle ou figez un défaut dans config.toml — notre tutoriel sur le sélecteur de modèles Codex détaille toute la manœuvre.