Découvrir Codex et ses quatre points d'entrée
📚 Navigation de la série : Voici le premier article du « Tutoriel Codex pour les débutants ». Sans aucune base requise, nous allons commencer par expliquer « Qu'est-ce que Codex exactement ? ». Dans le prochain article 〈02 Aperçu des concepts de base〉, nous clarifierons tous les termes techniques en une seule fois.
Qu'est-ce que Codex, à quoi servent ses quatre points d'entrée, et quelle est la différence avec ChatGPT et Claude Code
Les amis, ce tutoriel va parler d'OpenAI Codex.
Codex, ce nom vous semble-t-il familier ? OpenAI avait déjà un ancien modèle appelé Codex il y a quelques années, et en ouvrant son site officiel, c'est encore plus confus : pourquoi y a-t-il à la fois une application de bureau, une ligne de commande, un plugin de navigateur, et une version Web cloud ? Lequel est le "vrai Codex" ? Lequel dois-je installer ?
Pour être honnête, c'est exactement là que Codex embrouille le plus facilement les débutants : ce n'est pas "un seul logiciel", mais le même agent de programmation IA (Agent) qui possède quatre visages. Si vous ne comprenez pas cela, vous bloquerez longtemps sur "lequel télécharger".
Cet article n'enseigne pas l'installation, ni la saisie de commandes (ce sera le sujet du 3e article). Il ne fait qu'une chose : vous expliquer clairement "ce qu'est Codex, ce que gère chaque visage, et quelles sont les différences avec ChatGPT et Claude Code", afin que vous ayez d'abord une carte en tête. Avec cette carte, vous saurez vous-même lequel installer et lequel utiliser par la suite.
Après avoir lu cet article, vous obtiendrez :
- Une phrase pour expliquer clairement "ce qu'est Codex" aux autres, sans être trompé par le nom
- Un tableau comparatif des quatre points d'entrée (Application de bureau / CLI / Extension d'IDE / Web), pour savoir par lequel commencer
- Un ensemble de critères : en quoi Codex diffère-t-il de ChatGPT, et de Claude Code, pour ne plus les confondre
- Une petite action gratuite, pour vérifier en 30 secondes si votre ordinateur le reconnaît
Cette image résume le cœur de tout l'article en un coup d'œil : l'application de bureau, la ligne de commande CLI, l'extension d'IDE et le Web sont les quatre visages de Codex — leur apparence et leur emplacement diffèrent, mais derrière se cache le même compte et le même agent Codex interconnecté.
01 Qu'est-ce que Codex exactement ?
Commençons par la conclusion : Codex est l'"agent de programmation IA" officiel d'OpenAI — vous lui donnez un objectif, il peut lire tout votre projet, modifier directement les fichiers, exécuter des commandes, lancer des tests, et terminer le travail pour que vous le validiez, au lieu de simplement vous renvoyer un morceau de code dans une boîte de discussion.
Vous connaissez sûrement OpenAI, c'est l'entreprise qui a créé ChatGPT. Codex est un outil spécialement conçu pour le scénario de "l'écriture de code". Selon la documentation officielle, les tâches qu'il accomplit se divisent principalement en ces catégories (ces points équivalent à sa "liste de capacités", familiarisez-vous avec, le 2e article les détaillera) :
- Écrire du code : Vous décrivez ce que vous voulez, et il génère du code en suivant la structure et le style existants de votre projet, et ne vous balance pas un fragment isolé.
- Comprendre des bases de code inconnues : Lorsque vous reprenez un vieux projet sans documentation, demandez-lui d'abord "explique l'architecture de ce projet", c'est bien plus rapide que de s'y casser les dents tout seul.
- Revoir le code : Vous aide à trouver les bugs potentiels, les conditions limites oubliées, les erreurs de logique.
- Déboguer et réparer : Lancez-lui l'erreur, il remontera la cause racine en suivant le code, la localisera, et fournira un correctif.
- Automatiser les tâches fastidieuses : Refactorisation, ajout de tests, migration, configuration de l'environnement, déléguez ces tâches répétitives en une phrase.
Il y a ici une différence cruciale où les débutants se trompent le plus souvent, je la souligne particulièrement :
Analogie : Consulter une recette (ChatGPT) vs Faire venir un chef privé à domicile pour cuisiner (Codex). Lorsque vous utilisez habituellement ChatGPT pour écrire du code, c'est comme consulter une recette — il vous dit "pour ce plat, ajoutez du sel, ajoutez du sucre, faites sauter pendant trois minutes", mais vous devez toujours tenir la poêle vous-même : copier le code, revenir à l'éditeur, coller, corriger les erreurs, c'est du travail manuel pour vous. Codex est différent, il est comme un chef qui entre directement dans votre cuisine — vous dites "je veux manger ça", il fouille lui-même dans le frigo (lit les fichiers), allume le feu (exécute des commandes), et sert le plat sur la table une fois terminé (code modifié, tests passés), vous n'avez plus qu'à y goûter et valider.
Cette différence dans la pratique se traduit par une expérience radicalement différente.
Laissez-moi vous donner un de mes propres exemples. En mars dernier, j'ai repris un petit crawler Python mis de côté depuis plus de six mois, les dépendances étaient obsolètes depuis longtemps, et son exécution générait un tas d'erreurs. Autrefois, j'aurais dû copier les erreurs une par une dans ChatGPT, qui m'aurait dit "c'est peut-être un problème de version d'une certaine bibliothèque", et j'aurais dû retourner chercher, modifier, relancer... J'aurais perdu tout un après-midi à jongler entre les fenêtres. Cette fois-ci, j'ai directement ouvert Codex dans le répertoire du projet, et je lui ai dit : "ce projet ne tourne plus, cherche la cause racine et répare-le pour qu'il puisse tourner". Il a fouillé de lui-même requirements.txt et la pile d'erreurs, localisé deux dépendances incompatibles, modifié les numéros de version et relancé pour confirmer. Je suis allé me chercher un café, et à mon retour, il m'attendait déjà pour que je regarde le diff.
Cela permet de réaliser immédiatement le poids du mot "agent (Agent, une IA capable d'exécuter des tâches de manière autonome)" — il ne vous donne pas d'idées, il met la main à la pâte pour vous et accomplit le travail.
💡 En résumé : Codex = l'agent de programmation IA officiel d'OpenAI, vous donnez l'objectif, il fait le travail, ce n'est pas "une boîte de discussion qui sait écrire du code".
02 Quatre visages : le même Codex, quatre points d'entrée
C'est là que Codex diffère le plus de nombreux outils, et c'est aussi là qu'il est le plus facile de s'embrouiller, nous allons donc insister dessus.
Lorsqu'on évoque "ligne de commande" ou "terminal", beaucoup de débutants imaginent immédiatement une fenêtre noire austère, ce qui les rebute instantanément. Pas de panique — Codex est justement l'un des outils de programmation IA grand public les plus conviviaux pour ceux qui "ne veulent pas toucher à la ligne de commande", car il a spécialement développé une application de bureau avec interface graphique.
Selon la documentation officielle, Codex dispose d'un total de quatre points d'entrée, et vous pouvez entrer par n'importe lequel :
| Point d'entrée | À quoi ça ressemble | Où ça tourne | Pour qui / Quel scénario |
|---|---|---|---|
| Application de bureau (Codex app) | Application indépendante, interface graphique, permet de voir les diffs visuellement, d'exécuter plusieurs tâches en parallèle | Votre machine locale | Ceux qui ne veulent pas toucher à la ligne de commande, qui aiment cliquer sur des interfaces, qui veulent surveiller plusieurs tâches en même temps |
| Ligne de commande CLI (Codex CLI) | Outil en ligne de commande où l'on tape codex dans le terminal | Votre machine locale | Ceux qui sont habitués au terminal, qui veulent écrire des scripts d'automatisation, qui travaillent sur serveur / SSH |
| Extension d'IDE (IDE extension) | Plugin dans la barre latérale de VS Code / Cursor / Windsurf / JetBrains | Votre machine locale | Ceux qui passent habituellement leur temps à coder dans l'éditeur |
| Web (Codex cloud) | Ouvrir chatgpt.com/codex dans le navigateur, les tâches s'exécutent dans l'environnement cloud d'OpenAI | Cloud | Pour lancer une longue tâche en arrière-plan, en exécuter plusieurs en parallèle, sans monopoliser la machine locale |
Parmi ces quatre, les trois premiers (Application de bureau, CLI, Extension d'IDE) travaillent sur votre propre ordinateur — ils lisent les fichiers de votre machine locale et exécutent les commandes de votre machine locale. Seul le quatrième, le Web, est différent :
Analogie : Externaliser le travail. Les trois premiers points d'entrée, c'est comme engager un assistant qui s'assoit à votre bureau, utilise votre ordinateur et vos documents pour travailler, sous vos yeux du début à la fin. Le Web, c'est comme externaliser les tâches à une équipe à distance — vous passez commande dans le navigateur, OpenAI lance un environnement isolé dans son propre cloud, récupère votre dépôt sur GitHub, travaille à huis clos, et une fois terminé, vous remet un diff, ou va même jusqu'à ouvrir directement une PR (Pull Request) pour vous. Il continue de tourner même si votre ordinateur est éteint.
Ce mode "d'externalisation" présente deux avantages concrets : le premier est le parallélisme — vous pouvez lancer trois à cinq tâches d'un coup en parallèle, sans qu'elles se bloquent mutuellement ; le deuxième est l'isolation — il travaille dans son propre bac à sable, ne touche pas à votre système local, et même s'il échoue, cela ne vous impactera pas. Ma combinaison la plus utilisée est la suivante : pour les petites modifications rapides, j'utilise l'application de bureau ou la CLI et je surveille sur place ; pour les tâches longues et fastidieuses comme "exécuter toute la suite de tests et réparer les cas d'échec", je les envoie sur le cloud et je reviens récolter les résultats plus tard.
Il y a ici un point particulièrement crucial, qu'il faut retenir et mettre en gras :
Ces quatre points d'entrée reposent sur le même Codex, et leurs configurations sont en grande partie interconnectées. Par exemple, le AGENTS.md (le fichier de description du projet, dont nous parlerons en détail plus tard) ou les Skills (instructions et flux de travail réutilisables) que vous définissez — la documentation officielle indique clairement qu'ils peuvent être réutilisés entre l'application de bureau, la CLI et l'extension d'IDE. Paramétrez une fois, utilisez partout. Si vous avez déjà utilisé l'un d'entre eux, en en ouvrant un autre, vous verrez toujours l'historique de vos projets passés.
Un petit conseil amical : les débutants ne doivent pas se prendre la tête sur "lequel apprendre en premier". Ma recommandation est la suivante — si la ligne de commande vous fait peur, commencez par l'application de bureau (interface graphique, diff visuel, le plus sûr) ; si vous aimez déjà traîner dans le terminal, passez directement à la CLI. Cette série détaillera chacun de ces quatre points d'entrée (articles 07 à 10), ici il suffit de retenir qu'il y a "un même Codex, quatre visages".
💡 En résumé : Codex dispose de quatre points d'entrée : l'application de bureau, la CLI, l'extension d'IDE et le Web. Les trois premiers travaillent sur votre machine locale, le Web externalise le travail dans le cloud, mais à la base, c'est le même Codex et les configurations sont interconnectées.
03 Ce qu'il peut faire et ce qu'il ne peut pas faire
La liste de capacités a déjà été énumérée dans la section 01, ici nous allons compléter par l'autre moitié qu'il faut absolument identifier — ce qu'il ne peut pas faire. Ce point est plus précieux que "ce qu'il peut faire", car c'est généralement là que les débutants se plantent.
| ❌ Ce qu'il ne faut pas attendre de lui | Pourquoi |
|---|---|
| Prendre des décisions techniques à votre place | Quelle architecture choisir, si une refactorisation en vaut la peine, comment prioriser les exigences — le jugement et la prise de décision sont votre affaire, il n'est pas doué pour la conception de systèmes globaux |
| Garantir un code à 100% sans bug | Il fournit des suggestions de haute qualité, pas des réponses absolument correctes, après modification, c'est à vous de faire la revue |
| Deviner vos exigences mal formulées | La logique métier que vous n'avez pas clairement expliquée, il ne peut que la deviner à l'aveugle, et plus c'est automatique, plus il est facile de s'écarter de la bonne voie |
| Vous laisser en mode pilote automatique si vous n'y comprenez rien | Si vous ne comprenez pas ce qu'il a modifié, vous ne pouvez pas juger si c'est bon ou mauvais, c'est comme conduire les yeux fermés |
Le piège le plus courant est le deuxième. J'ai déjà fait cette erreur stupide par le passé : j'ai demandé à Codex d'ajouter en masse la gestion des erreurs dans un projet, il a modifié une dizaine de fichiers à toute vitesse, et pour gagner du temps, j'ai tout commité directement. Résultat, il avait "pris l'initiative" de modifier la logique existante à deux endroits, et ce n'est que quelques jours plus tard que j'ai remarqué que le comportement d'une interface avait changé. Depuis lors, je me suis fixé une règle stricte : pour chaque ligne qu'il modifie, je parcours au moins le diff avant de commiter. Au passage, la documentation de démarrage rapide de Codex mentionne également — avant et après toute intervention, créez un point de contrôle avec Git (checkpoint, on peut le voir comme une "sauvegarde" du projet), pour pouvoir revenir en arrière d'un clic en cas de pépin. Plus tôt les débutants prennent cette habitude, mieux c'est.
L'état d'esprit pour bien utiliser Codex se résume en fait à une phrase :
Laissez Codex vous proposer des solutions candidates de haute qualité, et non des réponses absolument correctes.
En d'autres termes — l'humain fixe la direction, vérifie, juge ; l'IA se charge de l'exécution, de l'analyse, et des tâches répétitives. Telle est sa philosophie de conception : la collaboration, pas le remplacement.
💡 En résumé : Il peut lire des projets, modifier des fichiers, exécuter des commandes, accomplir des tâches fastidieuses, mais prendre les décisions et vérifier seront toujours de votre ressort — c'est un partenaire, pas un bouc émissaire à qui l'on délègue tout sans réfléchir.
04 Codex vs ChatGPT vs Claude Code
Les deux questions les plus posées par les débutants : "Codex et ChatGPT ne sont-ils pas de la même famille, quelle est la différence ?" et "Quelle est sa différence avec Claude Code ?" Clarifions tout d'un coup.
Quelle est la différence entre Codex et ChatGPT ?
Ils appartiennent tous deux à OpenAI, mais ne sont pas du tout sur le même plan.
Analogie : Officier d'état-major vs Force spéciale. ChatGPT est comme un officier d'état-major assis au quartier général — vous lui décrivez la situation, il vous donne des idées, élabore des plans, mais il ne va pas sur le terrain, vous devez effectuer l'exécution vous-même. Codex est comme une force spéciale capable d'être parachutée sur place — vous lui donnez un objectif, il s'infiltre dans votre projet (lit les fichiers, exécute les commandes, modifie le code), accomplit la mission puis revient vous faire son rapport.
Pour le dire simplement : Vous posez des questions à ChatGPT et il répond, vous donnez des ordres à Codex et il agit. Et ce qui est intéressant — Codex est lui-même inclus dans l'abonnement de ChatGPT (selon la documentation officielle, chaque compte ChatGPT — y compris le niveau gratuit — inclut un quota d'utilisation de Codex, les niveaux payants Plus / Pro / Business / Edu / Enterprise ayant des limites plus élevées), et il est également possible de se connecter via la clé API d'OpenAI avec un paiement à l'utilisation. Le quota précis alloué à chaque niveau d'abonnement, et la disponibilité des fonctionnalités selon le mode de connexion, évoluent rapidement, fiez-vous toujours à la page de tarification officielle (cela sera abordé en détail dans le 4e article).
Quelle est la différence entre Codex et Claude Code ?
Ces deux-là sont souvent comparés. Commençons par refroidir vos ardeurs : ne demandez pas "lequel est le plus fort", leur positionnement est trop similaire, la force ou la faiblesse dépend de votre usage spécifique. La véritable différence réside dans le "centre de gravité du flux de travail" :
| Dimension | Codex (OpenAI) | Claude Code (Anthropic) |
|---|---|---|
| Origine | OpenAI, basé sur les modèles de la série GPT | Anthropic, basé sur les modèles de la série Claude |
| Point d'entrée le plus ergonomique | La version officielle propose une application de bureau avec interface graphique, conviviale pour ceux qui évitent la ligne de commande | Natif au terminal (CLI), avec les fonctionnalités les plus complètes pour bien comprendre le fonctionnement |
| Fichier de description du projet | AGENTS.md | CLAUDE.md |
| Quatre points d'entrée | Application de bureau / CLI / Extension d'IDE / Web | Terminal / Plugin d'éditeur / Application de bureau / Web · Mobile |
| Peut-il modifier des fichiers et exécuter des commandes ? | Oui, c'est un véritable agent | Oui, c'est un véritable agent |
Vous l'aurez compris — leur squelette est presque identique : tous deux sont des agents de programmation capables de "lire les projets et d'agir", tous deux offrent de multiples points d'entrée locaux et dans le cloud, et tous deux utilisent un fichier de description de projet pour être "paramétrés". Les différences les plus évidentes sont de deux ordres : premièrement, leur lignée est différente (GPT vs Claude, le modèle sous-jacent est différent) ; deuxièmement, leur philosophie par défaut est différente — Codex met fortement en avant son application de bureau avec interface graphique, manifestement pour attirer ceux qui "ne veulent pas toucher à la ligne de commande" ; Claude Code, en revanche, est natif au terminal, et a une saveur de ligne de commande beaucoup plus prononcée.
J'utilise moi-même les deux, et ma répartition des tâches est grosso modo : pour les travaux qui nécessitent une interface graphique, où je veux visualiser et surveiller les diffs, ou lorsque je lance plusieurs tâches en parallèle dans un même projet, j'utilise l'application de bureau Codex ; pour les travaux où je plonge dans le terminal, et où je dois relier un tas de scripts personnalisés et de hooks, je les réserve à Claude Code. L'un complète l'autre, il ne le remplace pas.
Attention : qui a le modèle le plus intelligent, qui a les prix les plus avantageux, et quelles fonctionnalités ont été ouvertes, ces informations changent extrêmement vite, les conclusions d'aujourd'hui pourraient être obsolètes la semaine prochaine. C'est pourquoi cet article évite délibérément de graver dans le marbre des scores de performance ou des prix — pour comparer ces points, consultez directement les pages officielles respectives des deux entreprises.
💡 En résumé : ChatGPT est l'officier d'état-major qui donne des idées, Codex est la force spéciale d'OpenAI qui agit sur le terrain ; Codex et Claude Code sont deux agents de programmation "similaires mais de familles différentes", avec une structure semblable mais une lignée et une philosophie différentes, il ne faut pas choisir l'un ou l'autre, mais leur attribuer les tâches selon le besoin.
05 Pratique : vérifiez en 30 secondes si votre ordinateur le reconnaît
Nous avions convenu que cet article n'enseignerait pas l'installation, mais voici une petite action gratuite, pour vérifier votre environnement (que ce soit installé ou non, cette commande s'exécutera et ne cassera rien).
Ouvrez votre terminal (l'application "Terminal" sur Mac, "PowerShell" sur Windows), tapez cette ligne et appuyez sur Entrée :
codex --versionDeux résultats sont attendus, et tous deux sont normaux :
- Scénario 1 : Une chaîne de numéros de version apparaît — félicitations, vous avez déjà installé la CLI, et dans le 3e article, vous pourrez passer directement à la section "Utilisation".
- Scénario 2 : Une erreur
command not found: codex(sur Windows ce sera probablement'codex' n'est pas reconnu en tant que commande interne ou externe) — c'est tout à fait normal aussi, cela signifie que la CLI n'est pas encore installée, et c'est précisément la première chose que nous réglerons dans le 3e article.
Voici un petit aperçu des commandes d'installation de la CLI (ne vous précipitez pas pour les taper maintenant, jetez juste un œil), la version officielle ressemble à ça :
# macOS / Linux : Script d'installation standard
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Une fois installé, tapez la commande codex dans le terminal, il vous guidera pour vous connecter (avec un compte ChatGPT ou une clé API OpenAI), et vous pourrez ensuite travailler dans le répertoire courant.
Remarque 1 : Les commandes ci-dessus concernent l'installation de la CLI en ligne de commande. Si vous avez peur de la ligne de commande, l'application de bureau suit le chemin de l'interface graphique "télécharger le fichier d'installation, double-cliquer pour installer" (disponible pour macOS / Windows, en attente pour Linux), ce qui n'est pas différent de l'installation d'un logiciel ordinaire — le 3e article détaillera séparément les quatre points d'entrée, sans omettre aucune étape.
Remarque 2 : Codex s'appuie sur le système de comptes d'OpenAI / ChatGPT, ce qui signifie que les utilisateurs en Chine continentale ont généralement besoin de "magie" pour l'installer et se connecter. Comment s'y prendre et comment se connecter sera expliqué en détail dans le 3e article, nous ne nous étendrons pas dessus ici.
L'image ci-dessous résume la relation "local / cloud" des quatre points d'entrée, et ne pas la voir ne gênera pas la compréhension, retenez juste le tableau précédent :
Ce que cette image veut dire, c'est que : les quatre points d'entrée sont les "portes" par lesquelles vous donnez des objectifs à Codex, les trois premières portes mènent à votre machine locale, la dernière mène au cloud d'OpenAI, mais derrière la porte, il y a le même Codex.
💡 En résumé : Une ligne
codex --versionsuffit pour vérifier si l'ordinateur le reconnaît — et pas de panique en cas d'erreur, ce sera la première tâche du 3e article ; si la ligne de commande vous effraie, n'oubliez pas qu'il y a toujours l'application de bureau avec interface graphique en option.
06 Résumé
Cet article n'a pas nécessité de taper beaucoup de commandes, mais il a clarifié les choses les plus importantes auxquelles il faut penser au début :
- Ce que c'est : L'agent de programmation IA officiel d'OpenAI, vous lui donnez un objectif, il lit le projet, modifie le code, exécute des commandes, et accomplit le travail — ce n'est pas "une boîte de discussion qui sait écrire du code".
- Quatre visages : Application de bureau, CLI, Extension d'IDE, Web, avec les trois premiers travaillant sur votre machine locale, et le Web externalisant le travail dans le cloud, mais basés sur le même Codex, et avec des configurations interconnectées.
- Ce qu'il peut / ne peut pas faire : Il peut lire du code, modifier des fichiers, réparer des bugs, faire des tâches répétitives ; mais prendre des décisions, vérifier, et compléter les exigences seront toujours votre travail, et vous devez absolument revoir le diff après modification.
- Comparé à qui et comment : ChatGPT est un officier d'état-major, Codex est la force spéciale d'OpenAI qui agit ; Codex et Claude Code sont de la même famille mais de parents différents, avec une structure semblable mais une lignée et une philosophie différentes, attribuez les tâches selon les besoins, n'en choisissez pas qu'un seul.
Vous devriez maintenant être capable de : expliquer clairement à vos collègues en une phrase ce qu'est Codex, et déterminer par quel point d'entrée vous devez passer et quelles tâches lui confier. C'est la "carte mentale" que vous devez absolument acquérir pour débuter — toutes les fonctionnalités qui suivront viendront s'ajouter sur cette carte.
Article suivant 〈02 Aperçu des concepts de base〉 : Nous allons clarifier d'un coup tous les termes de l'univers Codex — boucle de l'agent, contexte, AGENTS.md, mode d'approbation, bac à sable, Skills, MCP... Ce sont des mots avec lesquels vous jonglerez tous les jours par la suite. Allez d'abord taper la commande codex --version ci-dessus pour voir si vous êtes dans le "Scénario 1" ou le "Scénario 2", le 3e article traitera justement ce point.