Débuter avec Codex d'OpenAI : installation et réglages

Codex d’OpenAI : ce que c’est et ce qu’il te faut

Codex est l’agent de programmation d’OpenAI : il lit un projet, modifie des fichiers et exécute des commandes à partir d’une consigne en langage courant. Il fonctionne dans l’app ChatGPT desktop, le terminal (CLI), l’extension d’éditeur ou le cloud. CLI désigne l’interface en ligne de commande, c’est-à-dire un programme que l’on pilote en tapant des instructions dans le terminal. Pour débuter, installe-le, connecte ton compte ChatGPT, puis règle Git, AGENTS.md et les approbations avant la première ligne de code.

Ce guide s’adresse à quelqu’un qui n’a jamais utilisé Codex et veut créer un site ou une petite application. Il parle de l’agent actuel, pas du modèle Codex de 2021, qui n’a que le nom en commun. Précision d’honnêteté : chez Peechy, on travaille surtout avec Claude Code, pas avec Codex au quotidien. Pour un comparatif, lis Claude Code ou Codex pour créer un site.

Prérequis :

• un compte ChatGPT (vérifie sur la page officielle des tarifs d’OpenAI, le jour où tu t’inscris, quel forfait donne accès à Codex) ;
• un dossier vide pour ton projet, par exemple mon-site ;
• Git installé sur ta machine ;
• pour le terminal avec npm : Node 16 ou plus source : OpenAI, paquet npm ;
• un objectif simple, par exemple une page d’accueil avec un formulaire de contact.

1. Choisis où lancer Codex

Codex existe sur six surfaces : l’app ChatGPT desktop, l’app ChatGPT mobile, ChatGPT sur le web, le CLI, l’extension IDE et Codex Cloud source : OpenAI, Codex IDE extension. L’extension couvre VS Code, Cursor et Windsurf, tandis que Xcode et JetBrains ont leurs propres intégrations.

Le Quickstart marque l’application desktop comme recommandée : elle sert à travailler sur plusieurs projets, des fichiers locaux et des tâches longues source : OpenAI, Quickstart. Le web fonctionne sans installation, mais travaille dans le cloud, avec un environnement à créer. Les commandes de ce guide valent pour le CLI : elles ne s’appliquent pas à ChatGPT web source : OpenAI, Developer commands.

2. Installe et connecte-toi

Pour le CLI, choisis une seule méthode :

# macOS et Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm ou Homebrew
npm install -g @openai/codex
brew install --cask codex

Ces méthodes figurent sur la page npm du paquet et dans la documentation du CLI. Ouvre ensuite ton dossier de projet et lance codex. Au premier lancement, choisis « Sign in with ChatGPT ».

Dans VS Code, si l’icône Codex n’apparaît pas, ouvre la palette de commandes et lance « Codex: Open Codex Sidebar ». En cas de souci, codex doctor produit un rapport de diagnostic sur l’installation, la configuration, l’authentification et l’environnement d’exécution source : OpenAI, Developer commands.

3. Fais un premier échange sans rien modifier

Commence par une demande en lecture seule : « Explique-moi la structure de ce dossier et propose un plan pour une page d’accueil. Ne modifie aucun fichier. » Tu vérifies ainsi que la connexion marche et que l’agent comprend ton projet.

Regarde aussi le modèle actif. Depuis le 14 octobre 2026, GPT-5.5 n’est plus proposé dans Codex avec une connexion ChatGPT : OpenAI indique GPT-6.1 Sol comme remplaçant quand il est disponible pour ton forfait et ton application source : OpenAI, changelog. Les connexions par clé d’API ne sont pas concernées. La liste des modèles change vite : vérifie celle que ton application ou ton terminal affiche.

4. Initialise Git et crée AGENTS.md

Git n’est pas imposé par la documentation d’OpenAI, mais c’est la bonne pratique : il permet d’annuler ce que l’agent a fait. Avant toute demande de code :

git init
git add -A
git commit --allow-empty -m "Point de départ"

AGENTS.md est le fichier de règles que Codex lit avant de commencer le travail. Il peut être global (~/.codex/AGENTS.md) ou propre au projet, de la racine Git jusqu’au dossier courant. Les fichiers sont concaténés de la racine vers le dossier courant, les plus proches priment, et AGENTS.override.md est vérifié avant AGENTS.md source : OpenAI, AGENTS.md. Voir aussi : CLAUDE.md et AGENTS.md : donner ses règles à l’agent IA.

La documentation recommande de le garder court source : OpenAI, Customization. Exemple minimal à la racine :

# Règles du projet
- Site statique Astro, pas de dépendance ajoutée sans me demander.
- Lance `npm run build` après chaque modification.
- Ne touche jamais aux fichiers .env.
- Explique en une phrase chaque changement.

Vérifie qu’il est pris en compte : codex --ask-for-approval never "Summarize the current instructions.". C’est le même principe que le fichier de règles décrit dans notre guide Claude Code.

5. Comprends les approbations et le bac à sable

Le bac à sable désigne la limite que le système d’exploitation impose à ce que l’agent peut lire, écrire et exécuter. Les approbations, elles, décident quand l’agent doit te demander la permission. Ce sont deux contrôles distincts qui fonctionnent ensemble source : OpenAI, Sandboxing.

La combinaison recommandée pour débuter est workspace-write avec on-request : codex --sandbox workspace-write --ask-for-approval on-request. L’agent travaille dans ton dossier et te demande avant d’écrire ailleurs ou d’utiliser le réseau.

Évite --dangerously-bypass-approvals-and-sandbox (alias --yolo), qui lance toutes les commandes sans approbation ni bac à sable : la documentation le réserve à un environnement durci de l’extérieur source : OpenAI, Developer commands. La valeur untrusted n’est plus acceptée : la documentation la déclare retirée source : OpenAI, Sandboxing. Lance codex --help pour voir ce que ta version accepte. Les noms de préréglages varient aussi selon l’interface et la version.

6. Découpe le travail en petites étapes vérifiables

Une consigne comme « fais-moi un site complet » produit beaucoup de code que tu ne peux pas relire. Procède par tâches courtes, avec un critère de réussite :

1. « Crée la structure de pages : accueil, services, contact. » Vérifie que npm run build passe.
2. « Ajoute l’en-tête et le menu. » Vérifie sur mobile et sur ordinateur.
3. « Ajoute le formulaire de contact. » Envoie-toi un message de test.

Fais un git commit après chaque étape validée. Sans commit préalable, ne lance pas une tâche longue sans surveillance.

7. Prends trois habitudes valables pour tout agent

• Lis ce qui change avant d’accepter. Parcours le diff (git diff ou la vue de l’éditeur) et refuse ce que tu ne comprends pas. Diff désigne l’affichage des lignes ajoutées et supprimées entre deux versions d’un fichier.
• Teste toi-même. Ouvre le site, remplis le formulaire, essaie sur téléphone. « Les tests passent » dit par l’agent ne remplace pas ton essai.
• Fais une revue de sécurité avant toute mise en ligne. Clés d’API, accès, formulaires et dépendances se contrôlent avant de publier : voir Vibe coding : les risques de sécurité. Les erreurs courantes avec Claude Code ou Codex complètent ce point.

Pièges courants

• Une connexion par clé d’API (codex login --with-api-key) est facturée au tarif standard de l’API, et non sur les crédits inclus dans ton forfait ChatGPT. Lance codex login status pour voir la méthode de connexion active source : OpenAI, Authentication.
• Les anciens tutoriels citent --full-auto, un flag déprécié en avril 2026 source : OpenAI, dépôt Codex, PR 20133 et absent de la référence actuelle : utilise --sandbox workspace-write --ask-for-approval on-request. Les permissions évoluent aussi vers des profils (:read-only, :workspace, :danger-full-access) : confronte toujours un tutoriel à codex --help.
• Lancer codex dans le mauvais dossier, par exemple ton dossier personnel, donne à l’agent un périmètre trop large. Place-toi dans le dossier du projet.
• Un AGENTS.md trop long noie les règles importantes. Cinq à dix lignes suffisent.
• Passer en danger-full-access pour « aller plus vite » supprime ton filet de sécurité. Garde-le pour un environnement jetable.

Avant ta première vraie tâche, fais donc ces trois choses dans l’ordre : un commit de départ, un AGENTS.md de cinq lignes, et workspace-write avec on-request.