Tutoriel Codex CLI en francais

Ce qu'est Codex CLI

Codex CLI est un agent harness d'OpenAI: un coding agent leger qui tourne dans votre terminal, met un modele dans une boucle avec des tools (lire des fichiers, editer des fichiers, executer des commandes shell) et travaille directement dans votre repository vers un objectif que vous fixez. Comme Claude Code, il ne vous donne pas juste des snippets a coller; il fait des modifications multi-fichiers et execute des commandes, et vous gardez le controle en verifiant ce qu'il propose et en approuvant les actions importantes. Il est open-source et a grandi vite: debut 2026, il avait depasse deux millions d'utilisateurs actifs par semaine. Le modele de configuration de projet est AGENTS.md, une convention ouverte et agnostique aux outils pour donner a un coding agent ses instructions permanentes, l'equivalent Codex du CLAUDE.md de Claude Code. Voir le glossaire sur l'agent harness pour le concept sous-jacent.

• Un coding agent de terminal qui lit, edite et execute du code dans votre repo, pas de l'autocomplete.
• Vous supervisez: il propose des actions et vous approuvez les importantes.
• Open-source, avec plus de deux millions d'utilisateurs actifs par semaine debut 2026.
• Configure avec AGENTS.md, une convention ouverte et agnostique aux outils pour les instructions permanentes.

Installer Codex CLI

Installez Codex CLI avec npm ou Homebrew. L'installation npm place le binaire codex globalement sur votre path et requiert Node.js 18 ou plus recent; le cask Homebrew est l'option pratique sur macOS. Choisissez-en une, puis confirmez qu'il est sur votre path. Ces commandes sont a jour en juin 2026 contre le quickstart officiel, mais comme l'outil bouge vite, verifiez la doc OpenAI Codex si quelque chose a change.

# npm (needs Node.js 18+)
npm install -g @openai/codex

# Homebrew on macOS
brew install --cask codex

# Confirm it is installed and on your path
codex --version

Se connecter

Au premier lancement, Codex vous invite a vous authentifier, et vous avez deux voies. La recommandee pour la plupart est la connexion avec votre compte ChatGPT, qui utilise Codex dans le cadre d'un plan ChatGPT payant (Plus, Pro, Business, Edu ou Enterprise). L'alternative est une cle API OpenAI, facturee au token, le bon choix pour l'automatisation, le CI ou si vous preferez une facturation a l'usage; notez que certaines fonctionnalites peuvent differer entre les deux. Pour utiliser une cle, definissez-la comme variable d'environnement avant le lancement, ou suivez le flux de login in-app pour ChatGPT. Lancez simplement codex et choisissez "Sign in with ChatGPT" quand on vous le demande.

# Start Codex; on first run it walks you through sign-in
codex

# Option A (recommended): choose "Sign in with ChatGPT" in the prompt
# uses your paid ChatGPT plan (Plus, Pro, Business, Edu, Enterprise)

# Option B: authenticate with an API key (good for CI and automation)
export OPENAI_API_KEY="your-api-key"
codex

Lui donner des regles avec AGENTS.md

AGENTS.md est la facon dont vous enseignez a Codex les regles permanentes de votre projet, le meme role que CLAUDE.md joue pour Claude Code, et comme c'est une convention ouverte, beaucoup d'agents la lisent. Codex construit une instruction chain au demarrage, va d'un fichier global jusqu'a votre repertoire courant et les enchaine, les fichiers plus proches de votre repertoire de travail ayant priorite en cas de conflit. Cela donne trois scopes utiles: un ~/.codex/AGENTS.md global pour vos defauts personnels, un AGENTS.md a la racine de votre repo pour les regles de projet que tous partagent, et des fichiers AGENTS.md imbriques dans des sous-repertoires pour des overrides specifiques a une zone. Gardez-les concentres sur le setup, les conventions et les exigences de test; Codex respecte une limite de taille standard (environ 32 Kio sur la chain), et comme tout fichier d'instructions permanentes, un fichier concis bat un fichier tentaculaire.

# AGENTS.md (at your repository root)

## Setup
- Install with `bun install`. The dev server is `bun run dev`.

## Conventions
- TypeScript only. Use "-" not em dashes. Border radius is always rounded-sm.

## Tests and quality gate
- Before you call a task done, run: bun run lint && bun run typecheck && bun run test.

## Out of scope
- Do not edit files under /generated; they are built, not hand-edited.

Votre premiere tache

Ouvrez un terminal dans le projet sur lequel vous voulez travailler, et executez codex. Commencez petit pour batir la confiance: demandez-lui d'expliquer le projet ou de trouver ou se trouve quelque chose avant de le laisser changer quoi que ce soit. Quand vous demandez un changement, faites-lui de preference proposer d'abord son approche, verifiez le changement qu'il fait, et gardez vos tests verts. Une habitude de securite que la doc recommande est de committer un checkpoint Git propre avant une tache et de nouveau apres, pour qu'un changement qui ne vous plait pas soit a un git restore de distance. Codex offre des modes d'approbation qui pilotent combien il peut faire sans demander; commencez plus prudent, ou il demande avant d'executer des commandes ou d'editer, et ne le detendez qu'une fois que vous faites confiance au workflow sur un repo.

• Executez codex dans votre projet; commencez par une requete en lecture seule comme "explain what this project does".
• Pour les edits, faites-lui proposer l'approche, puis verifiez le diff avant de l'accepter.
• Committez un checkpoint Git avant et apres une tache, pour pouvoir revenir en arriere proprement.
• Commencez avec un mode d'approbation prudent (il demande avant d'agir) et ne le detendez qu'une fois que vous lui faites confiance.

Ou aller ensuite

Une fois les bases acquises, les habitudes qui rendent Codex fiable sont les memes que celles qui rendent tout coding agent fiable, et elles se transferent directement de nos autres guides. Appuyez-vous sur le guide Prompt patterns pour coding agents pour bien briefer, sur le guide Context Engineering pour un window affute sur les longues taches, et sur le pilier Qu'est-ce que l'agentic engineering pour la discipline de diriger et verifier plutot que d'accepter un output non verifie. Si vous utilisez aussi l'agent d'Anthropic, le comparatif Claude Code vs Codex CLI expose ou chacun convient, et le cours Foundations installe et execute les deux cote a cote.

• Prompt patterns pour coding agents: comment briefer Codex avec une spec, des exemples et une verification loop.
• Context Engineering: gardez son context window affute sur les longues taches.
• Claude Code vs Codex CLI: quel agent de terminal convient a quel job.
• Cours Foundations: installe et execute Claude Code et Codex cote a cote.

Pas à pas

1. 01

   Installer Codex CLI

   Installez avec npm ("npm install -g @openai/codex", requiert Node.js 18+) ou Homebrew ("brew install --cask codex" sur macOS). Confirmez avec "codex --version".

2. 02

   Se connecter

   Executez "codex" et choisissez "Sign in with ChatGPT" pour utiliser un plan ChatGPT payant, ou definissez OPENAI_API_KEY dans votre environnement pour authentifier avec une cle API pour l'automatisation et le CI.

3. 03

   Ecrire un AGENTS.md

   Ajoutez un AGENTS.md a la racine de votre repo avec votre setup, vos conventions et la commande de quality gate. Codex lit les fichiers globaux, de projet et imbriques, le plus proche du repertoire de travail gagnant.

4. 04

   Executer une premiere tache en securite

   Executez "codex" dans votre projet, commencez par une requete en lecture seule, committez un checkpoint Git avant et apres, et utilisez un mode d'approbation prudent, pour qu'il demande avant d'executer des commandes ou d'editer.

5. 05

   Verifier et continuer

   Lisez le diff avant d'accepter un changement, gardez vos tests verts, et ne detendez le mode d'approbation qu'une fois que vous faites confiance au workflow sur ce repo.

Questions fréquemment posées

Continuez à apprendre