01 — Démarrer avec Codex — Codex — Le guide pratique

Ce que tu vas apprendre

Installer et configurer Codex CLI en 3 commandes
Comprendre le modèle mental : inspecter → planifier → modifier → vérifier
Lancer ta première session avec un prompt d’orientation
Adapter ton workflow si tu viens de Claude Code ou Cursor

Prérequis

Node.js 18+ installé (node --version)
Un repo Git local sur lequel tester
Clé API OpenAI avec accès à Codex (gpt-4o ou o3)

Codex partage ton workspace. Il voit tes fichiers, ton Git, tes tests. Ce n’est pas un chatbot : c’est un agent qui travaille dans ton repo. La première étape n’est jamais “écris du code”. C’est “comprends le repo”.

Le modèle mental tient en quatre phases :

@diagram:flow
Inspecter :: Lire le repo, le Git, les tests avant tout.
Planifier :: Décrire l'approche et la valider.
Modifier :: Implémenter par petits incréments.
Vérifier :: Tests + diff avant de conclure.

Étapes

1. Installer Codex CLI

# Via npm (recommandé)
npm install -g @openai/codex

# Vérifier l'installation
codex --version

# Authentifier
codex login

2. Configurer ton environnement

# Créer le répertoire de config
mkdir -p ~/.codex

# Vérifier que la clé API est définie
echo $OPENAI_API_KEY

# Si non, l'ajouter à ton shell (~/.bashrc, ~/.zshrc, etc.)
export OPENAI_API_KEY="sk-..."

3. Lancer ta première session

# Se placer dans un repo
cd /chemin/vers/ton-repo

# Démarrer Codex
codex

4. Orienter le repo avant toute modification

Colle ce prompt d’orientation à chaque nouvelle session :

Inspecte ce repo avant de proposer des modifications.

Retourne :
1. Les fichiers et dossiers les plus pertinents pour ma tâche
2. Une explication courte de la structure actuelle
3. La plus petite étape sûre à faire ensuite
4. Les commandes ou vérifications pour valider le résultat
5. Les risques ou inconnus qui pourraient changer le plan

5. Choisir une première tâche minimale

Bonnes options pour tester :

Expliquer un module confus
Renommer un symbole en toute sécurité
Corriger un test qui échoue
Améliorer une section du README

Mauvaise option : “refactorise toute l’app”.

6. Valider avant d’arrêter

# Vérifier les fichiers modifiés
git diff

# Lancer les tests concernés
npm test -- chemin/vers/test

# Vérifier qu'il n'y a pas de régression
npm test

Vérification

codex --version retourne un numéro de version
codex login a réussi
Une session a été lancée dans un repo Git
Le prompt d’orientation a été utilisé avant toute modification
Au moins un test a été exécuté après la modification

Pièges courants

Demander une solution avant d’inspecter le repo → Toujours commencer par l’orientation
Penser que les habitudes Claude/Cursor se transfèrent 1:1 → Les skills sont des workflows obligatoires, pas des décorations
Sauter la vérification parce que la modification semble petite → “Ça marche sur ma machine” ne suffit pas
Lancer Codex hors d’un repo Git → Le contexte repo est essentiel

Récapitulatif

Commande	Usage
`npm install -g @openai/codex`	Installer Codex CLI
`codex --version`	Vérifier la version
`codex login`	Authentifier
`codex`	Lancer une session interactive
`git diff`	Vérifier les modifications
`npm test`	Valider les changements

Pour aller plus loin

Inspiré du guide codex-howto de anup4khandelwal (MIT)