Qu'est-ce que le Codex OpenAI ?

Codex est l'agent de codage d'OpenAI. Il lit un dépôt, planifie une modification, édite des fichiers, exécute des commandes dans un environnement isolé et vous fournit un diff à examiner, depuis quatre interfaces partageant la même configuration : l'application Codex, une extension IDE, une interface en ligne de commande et un environnement cloud/web pour les tâches de longue durée ou en arrière-plan. Ces quatre interfaces lisent le même code. ~/.codex La configuration, un serveur MCP ou un plugin que vous avez configuré une fois vous suit entre le terminal et l'IDE.

En bref: Codex est moins un outil unique qu'un environnement d'exécution — un lieu où les compétences, les connexions d'applications et les serveurs MCP s'assemblent autour d'une tâche de codage, au lieu de vous obliger à recréer la même configuration dans chaque projet.

Pourquoi les développeurs adoptent Codex

La plupart des comparatifs d’« assistants de programmation IA » se concentrent sur la qualité des modèles, mais le changement le plus intéressant est structurel. Codex sépare trois éléments qui coexistaient auparavant dans un seul et même système d’invite de commande : instructions (AGENTS.md), procédures réutilisables (compétences), et accès aux outils (Applications et serveurs MCP). Cette séparation rend les plugins possibles : un plugin est simplement un ensemble de ces trois éléments que vous pouvez installer et désinstaller comme une seule unité, au lieu de copier-coller du code standard dans chaque nouvelle conversation.

Résultat concret : une équipe peut standardiser la façon dont Codex examine les demandes de fusion, lit les problèmes Sentry ou rédige la documentation, et diffuser cette norme sous forme de package installable plutôt que de page wiki que personne ne lit.

Installation et configuration de Codex

L'interface de ligne de commande (CLI) est le moyen le plus rapide de voir la configuration prendre effet. Codex stocke les paramètres dans ~/.codex/config.toml par défaut (remplacer par CODEX_HOME pour un profil spécifique au projet).

# Ouvrir le navigateur de plugins dans le codex de l'interface de ligne de commande /plugins # Ajouter un serveur MCP directement depuis le codex de l'interface de ligne de commande mcp add context7 -- npx -y @upstash/context7-mcp # Afficher les serveurs MCP actifs dans une session en cours /mcp

Pour un contrôle plus précis (délai d'expiration, listes d'outils autorisés, modes d'approbation par outil), modifiez les paramètres. config.toml directement. Voici un bloc minimal et réaliste pour un serveur MCP compatible HTTP en flux continu :

[mcp_servers.figma] url = "https://mcp.figma.com/mcp" bearer_token_env_var = "FIGMA_OAUTH_TOKEN" [mcp_servers.figma] startup_timeout_sec = 20 tool_timeout_sec = 45

Plugins vs Compétences vs Applications vs MCP

Ces quatre termes sont souvent utilisés indifféremment dans les textes marketing, ce qui explique pourquoi les débutants se trompent. Voici la distinction qui compte vraiment pour choisir les logiciels à installer.

Ainsi, lorsque quelqu'un vous dit « installez le plugin GitHub », ce qui atterrit réellement sur votre machine peut être une compétence, une connexion d'application, un serveur MCP, ou les trois à la fois — le plugin n'est que l'interface qui permet de l'installer et de le partager.

Répertoire des plugins

Codex organise les plugins en trois groupes, que vous les consultiez dans l'application ou dans l'interface de ligne de commande :

• Sélectionné par OpenAI — plugins examinés disponibles pour tous les utilisateurs de Codex.
• Partagé avec vous — plugins publiés en interne par un autre membre de votre espace de travail ChatGPT.
• Créé par vous — les plugins que vous avez créés et ajoutés à votre propre espace de travail.

L'installation est identique partout : ouvrez la page de détails du plugin, sélectionnez installer (ou Installer le plugin Dans l'interface de ligne de commande (CLI), connectez les applications externes nécessaires lorsque vous y êtes invité, puis ouvrez un nouveau thread avant de les utiliser. Vos paramètres d'approbation existants continuent de déterminer les actions autorisées pour le plugin une fois en production ; son installation n'octroie pas d'autorisations générales.

Pour désactiver un plugin sans le supprimer, inversez son entrée dans config.toml:

[plugins."gmail@openai-curated"] activé = faux

L'écosystème des plugins Codex

À l'heure actuelle, le répertoire d'OpenAI se concentre sur une sélection d'outils plutôt que sur un vaste catalogue d'applications ; un choix délibéré, puisque chaque plugin sélectionné a été examiné. Les plugins tiers et ceux créés par les utilisateurs de l'espace de travail sont bien plus nombreux, mais leur niveau de fiabilité varie ; il est donc important de savoir les distinguer.

Comment lire une fiche technique

Chaque plugin présenté dans ce guide est étiqueté avec le type de limite de confiance derrière laquelle il se situe :

Développement

Documentation et conception

Productivité

Débogage

Déploiement

Intégration GitHub

GitHub bénéficie d'un traitement particulier car Codex propose un plugin dédié et une intégration native plus poussée, ainsi qu'une action GitHub dédiée pour les exécutions déclenchées par l'intégration continue. Concrètement, cela se traduit par trois points d'entrée distincts : assigner Codex à une tâche depuis l'interface utilisateur de GitHub, l'invoquer depuis la ligne de commande sur un dépôt extrait, ou le déclencher depuis un fichier de workflow à chaque demande de fusion. Les équipes qui adoptent Codex pour la revue de code commencent généralement par l'action, car elle ne nécessite pas que chaque contributeur ait Codex configuré localement.

Intégration Figma

Figma se connecte à Codex via son propre serveur MCP plutôt que par une intégration côté Codex, que ce soit en local (application de bureau) ou à distance (hébergé). C'est un bon exemple d'utilisation optimale du modèle de plugin : OpenAI n'a pas eu à développer d'outils spécifiques à Figma, il lui a suffi d'assurer une bonne compatibilité avec MCP, le serveur de Figma se chargeant du reste. En contrepartie, le comportement du serveur, les limitations de débit et la fiabilité ne dépendent pas d'OpenAI.

Intégration de Notion

Ce plugin Notion optimisé permet d'accéder aux pages et à la base de données en lecture/écriture, et offre des fonctionnalités permettant de transformer les données techniques (journaux de commits, résumés de demandes de fusion, chronologies d'incidents) en contenu Notion structuré. C'est un avantage indéniable pour les équipes qui utilisent déjà Notion comme source de référence pour leurs décisions, car il élimine l'étape de mise à jour manuelle de la documentation.

Intégration Slack

À l'instar de GitHub, Slack propose un plugin dédié et une intégration native plus poussée. La différence se manifeste concrètement dans les flux de travail sensibles à la latence : les intégrations natives prennent généralement en charge des déclencheurs plus riches (par exemple, l'exécution de Codex lancée depuis un message Slack, et non pas simplement la publication d'un message Codex sur Slack), tandis qu'un plugin seul est généralement unidirectionnel, de Codex vers le canal.

Intégration de Sentry

Sentry est sans doute le plugin le plus performant pour une équipe qui livre déjà rapidement, car il simplifie le processus « repérer l'erreur → trouver la trace de la pile → trouver le commit → proposer une correction » en une seule boucle conversationnelle. Le hic : Codex proposera sans hésiter une correction pour un problème ancien ou un doublon si vous ne précisez pas le périmètre de votre requête (problèmes ouverts, dernières 24 h, projet spécifique). La précision de votre requête est donc primordiale ici, plus que partout ailleurs dans ce guide.

Automatisation du navigateur

Pour toute fonctionnalité exécutée dans un navigateur plutôt que via une API (vérification visuelle d'une modification d'interface utilisateur, extraction de données d'une page sans API publique, gestion d'un processus de connexion), Codex utilise les serveurs MCP du navigateur plutôt qu'un plugin dédié. La documentation mentionne principalement Playwright et Chrome DevTools, tous deux contrôlables via MCP. L'application Codex intègre également son propre navigateur et une extension Chrome pour une interaction plus fluide entre la consultation de la page et la modification du code.

Flux de travail terminal

L'interface de ligne de commande (CLI) est l'endroit où la configuration des plugins et du MCP est mise en pratique au quotidien. Voici quelques commandes utiles à retenir :

/plugins # Parcourir, installer, activer/désactiver les plugins depuis le Marketplace /mcp # Lister les serveurs MCP actifs dans cette session codex mcp add # Ajouter un nouveau serveur MCP depuis le shell codex mcp --help

Dans les onglets du marché des plugins du navigateur, appuyez sur Espace Cette option sur un plugin installé permet de l'activer ou de le désactiver pour la session en cours — utile lorsque vous souhaitez exclure un plugin comme cause d'un appel d'outil inattendu sans le désinstaller complètement.

AGENTS.md

AGENTS.md est le levier le plus sous-utilisé dans la plupart des configurations Codex. Codex le lit avant toute opération, construisant une chaîne d'instructions à partir d'un fichier global. ~/.codex/AGENTS.md en descendant dans chaque répertoire entre la racine de votre projet et votre répertoire de travail actuel — chaque fichier imbriqué se superposant ou remplaçant ceux situés au-dessus.

# AGENTS.md ## Attentes concernant le dépôt - Exécutez `npm run lint` avant d'ouvrir une demande de fusion. - Documentez les utilitaires publics dans docs/ lorsque vous modifiez leur comportement.

imbriqué AGENTS.override.md Les fichiers permettent à un sous-répertoire spécifique (par exemple, un service de paiement avec des règles plus strictes) de remplacer complètement les instructions ci-dessus plutôt que de s'y ajouter — utile dans les monorepos où « exécuter les tests » signifie quelque chose de différent dans chaque package.

Mémoire

Le système de mémoire locale de Codex est distinct de la mémoire web de ChatGPT et est désactivé par défaut. Une fois activé, Codex peut convertir le contexte des sessions passées inactives et éligibles en fichiers de mémoire locale. ~/.codex/souvenirs/, en expurgeant les secrets au fur et à mesure et en passant sous silence les conversations éphémères afin de ne pas résumer un travail encore en cours.

[fonctionnalités] souvenirs = vrai

Deux paramètres à connaître : souvenirs.utiliser_souvenirs contrôle si les souvenirs passés sont injectés dans les nouvelles sessions, et memories.disable_on_external_context Cela permet d'éviter complètement la génération de mémoire pour les discussions qui s'appuyaient sur la recherche Web ou les appels à l'outil MCP — pratique si vous ne voulez pas qu'une session de triage Sentry pollue la mémoire avec la trace de pile de quelqu'un d'autre.

Ingénierie des invites, du contexte et des boucles

Trois compétences connexes mais distinctes distinguent les développeurs qui peinent à maîtriser Codex de ceux qui résorbent rapidement un important arriéré de développement grâce à lui.

Ingénierie rapide

Décrivez précisément les changements souhaités et le résultat attendu, et non pas seulement le symptôme. « Corriger le test de paiement instable » est moins pertinent que « le test de paiement échoue de manière intermittente lors de la vérification du code de réduction — reproduisez le problème, identifiez la condition de concurrence et ajoutez un test de régression. »

Ingénierie du contexte

Il s'agit des ressources auxquelles Codex a accès, et non de ce que vous saisissez : le bon périmètre AGENTS.md, les bons serveurs MCP activés, les bons fichiers ouverts. Même une invite parfaitement formulée ne fonctionnera pas si Codex ne trouve pas le fichier de configuration qui contrôle le comportement que vous recherchez.

Ingénierie de boucle

Il s'agit de concevoir des cycles reproductibles de type « proposer → exécuter → vérifier → répéter » plutôt que des invites ponctuelles. Par exemple, on peut configurer Codex pour qu'il exécute la suite de tests après chaque modification et continue d'itérer jusqu'à ce que tout soit validé, au lieu de vérifier chaque tentative manuellement. Le guide de Codex décrit directement ce modèle pour les boucles de réparation itératives.

Flux de travail multi-agents et sous-agents

Codex prend en charge les sous-agents : des instances d'agent limitées auxquelles une session Codex principale peut déléguer des tâches spécifiques. Concrètement, cela permet de paralléliser des tâches indépendantes : un sous-agent exécute la suite de tests et renvoie un rapport pendant que la session principale continue d'éditer, au lieu qu'un seul agent exécute tout séquentiellement. Cette interface, plus récente et plus avancée que les plugins ou MCP, est à considérer comme une optimisation une fois votre flux de travail mono-agent fiable, et non comme un point de départ.

Flux de travail réels, étape par étape

1. Créez une application React avec Codex

Commencez par définir clairement les AGENTS.md (gestionnaire de paquets, commande de test), puis demandez des précisions sur la fonctionnalité attendue. Exigez les tests en même temps que le composant, et non après coup.

2. Corriger les bugs de production à l'aide du plugin Sentry

Délimitez la requête, demandez la cause première avant toute correction et exigez un test de régression sur la même différence.

3. Générer l'interface utilisateur directement depuis Figma

Indiquez à Codex une image spécifique, et non un fichier entier : les fichiers volumineux ralentissent l’inspection MCP et augmentent le risque d’inclure des composants non pertinents.

4. Rédiger la documentation à partir des commits GitHub

5. Refactoriser un code source existant

Demandez un plan avant de coder. Les refactorisations de code existant sont le domaine où l'ingénierie des boucles prend tout son sens : faites refactoriser un module par Codex, exécutez la suite de tests, et ne poursuivez que lorsque tout est validé.

6. Examiner automatiquement les demandes de fusion

L'action GitHub est le point d'entrée idéal ici : déclencher une revue Codex sur chaque demande de tirage plutôt que de compter sur quelqu'un pour penser à la demander manuellement.

7. Générer les migrations SQL

Sans plugin de base de données dédié, cette opération s'effectue généralement via un serveur MCP dédié à votre base de données, la migration étant toujours vérifiée et appliquée manuellement plutôt qu'automatiquement.

8. Déploiement à Vercel

Même lorsque les déploiements en prévisualisation deviennent routiniers, maintenez une étape d'approbation manuelle pour les déploiements en production.

Meilleures pratiques

De la

• Limitez la portée et la spécificité d'AGENTS.md — une règle claire vaut mieux que cinq règles vagues.
• Démarrer de nouveaux plugins dans rapide mode d'approbation avant de passer à auto.
• Désinstallez les plugins que vous n'utilisez pas activement — chaque outil installé représente une surface d'attaque.
• Limitez les informations d'identification du serveur MCP au strict minimum nécessaire à la tâche.

Ce qu'il ne faut pas faire

• Ne vous fiez pas à votre mémoire pour les règles qui doivent toujours s'appliquer — utilisez AGENTS.md.
• N’accordez pas à un plugin un accès en écriture en production « pour gagner du temps » — l’étape qu’il sauve est celle qui permet de détecter les erreurs.
• Ne regroupez pas des serveurs MCP sans lien entre eux dans une même session simplement parce qu'ils sont installés ; chacun ajoute des jetons au contexte et augmente le risque de confusion entre les outils.

Les erreurs des débutants

• Considérer l'installation d'un plugin comme une décision ponctuelle au lieu de réexaminer ses autorisations au fur et à mesure que le projet évolue.
• Des consignes d'écriture qui décrivent le symptôme plutôt que l'état final souhaité.
• Ignorer complètement le fichier AGENTS.md et réexpliquer les conventions du projet dans chaque invite.

Liste de contrôle de l'organisation du dépôt

• Un fichier AGENTS.md à la racine contenant la commande de test, le gestionnaire de paquets et les actions interdites.
• Le fichier AGENTS.override.md imbriqué n'est utilisé que lorsqu'un sous-répertoire diffère réellement.
• périmètre du projet .codex/config.toml pour les serveurs MCP spécifiques à ce dépôt
• Voici une courte liste des plugins approuvés pour ce dépôt et pourquoi.

FAQ

Conclusion

Le système de plugins transforme Codex, d'un excellent outil d'autocomplétion, en un agent intégré à vos outils d'équipe (GitHub, Figma, Sentry, Slack, Notion), sans que vous ayez à développer de code d'interface. Rien ne remplace cependant le bon sens : examinez les différences, définissez les modes d'approbation et veillez à l'exactitude du fichier AGENTS.md. Commencez par un plugin qui résout un problème quotidien agaçant, familiarisez-vous avec ses paramètres d'approbation, puis développez-en d'autres. Le flux de travail le plus efficace est rarement le plus complexe : c'est celui que vous utilisez régulièrement.