Utiliser OpenAI Codex : guide du débutant, de l'installation à la première tâche réelle

OpenAI Codex est un assistant de programmation capable de lire du code, modifier des fichiers et exécuter des commandes. Ce guide suit l'ordre logique : quelle interface choisir, comment l'installer, comment formuler sa première tâche, comment utiliser AGENTS.md pour qu'il s'améliore à l'usage, et les erreurs que font le plus souvent les débutants.

utiliser OpenAI Codextutoriel Codex débutantinstaller Codex CLIexemple AGENTS.mddébuter en programmation IA

Beaucoup de gens ouvrent Codex pour la première fois, tapent « fais-moi un site web », reçoivent une pile de fichiers incompréhensibles et abandonnent. Le problème vient rarement de l'outil, mais de l'usage. Codex n'est pas un chatbot : c'est plutôt un jeune ingénieur assis devant votre ordinateur. Il sait lire votre projet, modifier des fichiers et exécuter des commandes, mais il faut lui expliquer la tâche clairement et poser des limites.

Étape 1 : choisir une interface

Il existe plusieurs façons d'utiliser Codex : la ligne de commande (Codex CLI), une extension d'éditeur, l'application de bureau, ou le transfert de tâches exécutées dans le cloud depuis le web. En débutant complet, commencez par l'application de bureau ou l'extension : l'interface est lisible et vous voyez quels fichiers ont changé. Une fois à l'aise, passez à la CLI, plus rapide et mieux adaptée au travail en série. Quel que soit le point d'entrée, la connexion se fait avec votre compte ChatGPT et les capacités sont les mêmes.

Étape 2 : l'ouvrir dans un vrai projet

N'ouvrez pas un dossier vide en demandant « construis un gros système de zéro ». Mieux vaut prendre un petit projet réel que vous avez déjà — une page statique, un script qui traite des fichiers Excel — et lancer Codex dans ce répertoire. Il lit d'abord la structure du dossier, puis agit. Pour la première question, essayez « à quoi sert ce projet et comment le lancer ? » et vérifiez qu'il a bien compris.

Étape 3 : une première tâche petite et vérifiable

Une bonne première tâche ressemble à ceci : « change le titre de la page d'accueil en XXX, démarre le serveur local et dis-moi à quelle adresse voir le résultat ». Trois qualités : périmètre réduit, résultat visible immédiatement, étape de vérification incluse. Une fois qu'il a juste, donnez la suivante. Une chose à la fois réussit bien plus souvent que dix choses d'un coup.

Étape 4 : utiliser AGENTS.md pour qu'il retienne votre projet

Répéter « on utilise pnpm », « la commande de test est npm test », « ne touche pas au dossier config » à chaque fois devient vite épuisant. Codex lit un fichier AGENTS.md à la racine du projet : mettez-y les conventions et il les suivra à chaque démarrage. Un AGENTS.md suffisant couvre l'installation des dépendances, le lancement, les tests, les dossiers interdits et les règles de style. Vous pouvez en faire générer une première version par Codex, puis l'ajuster.

Étape 5 : ne pas tout autoriser tout de suite

Codex peut demander votre accord avant de modifier un fichier ou d'exécuter une commande. Au début, gardez les validations actives et regardez ce qu'il veut faire à chaque étape : vous apprendrez beaucoup et vous interceptez les erreurs. Quand vous faites confiance à son comportement sur un projet donné, élargissez progressivement. Faites aussi un commit Git avant chaque tâche pour pouvoir revenir en arrière : c'est l'assurance la moins chère du développement assisté par IA.

Les quatre erreurs de débutant les plus fréquentes

Un : des tâches trop grosses, demander tout un produit en une phrase et le voir dériver en cours de route. Deux : utiliser ses modifications sans les relire, si bien que les problèmes s'accumulent. Trois : dire « ça ne marche pas » au lieu de coller le message d'erreur. Quatre : sauter AGENTS.md, donc repartir de zéro à chaque conversation. Évitez ces quatre points et Codex devient beaucoup plus utile.

Si vous voulez l'apprendre méthodiquement, des bases de l'ordinateur jusqu'à la CLI, MCP, les Skills et le travail en équipe, regardez Zero to Codex (cours en chinois) : les 8 premières leçons sont gratuites et consultables sans compte. Pour approfondir AGENTS.md, lisez AGENTS.md : mettre les conventions du projet dans un fichier.