--- title: "Codex dans VS Code : installer l'extension et coder sur un vrai projet" description: "Comment installer l'extension Codex d'OpenAI dans VS Code, à quel plan elle donne accès, comment choisir le mode de l'agent, cadrer le travail avec AGENTS.md et se protéger avec le bac à sable." pubDate: 2025-12-31 updatedDate: 2026-09-27 family: 'intelligence-artificielle' tags: ['VS Code'] heroImage: '/images/vs-code-codex-coder-plus-vite-grace-a-lia.webp' videoUrl: 'https://youtu.be/uGkRm8c9lcY' faq: - question: 'Comment installer Codex dans VS Code ?' answer: "Depuis la place de marché de VS Code : Ctrl+Shift+X, tu cherches « Codex », tu installes l'extension publiée par OpenAI, puis tu ouvres son panneau depuis la barre latérale — ou via la palette de commandes avec « Codex: Open Codex Sidebar ». Tu te connectes ensuite avec ton compte ChatGPT ou une clé API, et l'extension utilise le même agent que le Codex CLI, avec la même configuration." - question: 'Codex est-il gratuit dans VS Code ?' answer: "L'extension elle-même ne coûte rien, et Codex est inclus dans tous les plans ChatGPT, y compris l'offre Free — mais pas avec les mêmes limites que les offres payantes. Les messages locaux sont décomptés par tranches de cinq heures, selon le modèle choisi, et ils partagent le même quota que tes conversations cloud ; des plafonds hebdomadaires peuvent s'ajouter. Les fourchettes publiées dépendent du modèle et de la complexité de la tâche, et la grille change souvent : vérifie la page de tarifs le jour où tu montes ton setup." - question: 'Codex extension ou Codex CLI, quelle différence ?' answer: "Ce sont deux surfaces du même agent : l'extension pour VS Code, Cursor, Windsurf et les éditeurs compatibles, le CLI dans le terminal. Les deux partagent la même configuration et les mêmes fichiers d'instructions, donc rien à réapprendre en passant de l'un à l'autre. Attention : les IDE JetBrains et Xcode utilisent une intégration distincte, pas cette extension." - question: 'À quoi sert le fichier AGENTS.md ?' answer: "Codex lit les fichiers AGENTS.md avant de travailler : ils portent les conventions du projet — commandes de tests, style, interdits. La découverte part de la portée globale (~/.codex/AGENTS.md) puis descend de la racine du dépôt vers le répertoire courant, un seul fichier par dossier, et le plus proche l'emporte. La taille est plafonnée à 32 Kio par défaut, et un AGENTS.override.md permet de surcharger un dossier spécialisé." - question: 'Codex peut-il modifier ou supprimer mes fichiers sans me demander ?' answer: "Tout dépend du mode et du bac à sable. En mode Agent, il lit, modifie et exécute des commandes dans le répertoire de travail, mais demande l'approbation pour en sortir ou accéder au réseau : en workspace-write, le réseau est désactivé par défaut. Le mode Agent (Full Access) élargit les droits et la documentation appelle elle-même à la prudence. Le réflexe qui sauve : créer un point de commit Git avant chaque tâche." --- Codex arrive dans VS Code comme une extension, pas comme un IDE : tu gardes ton éditeur, tes raccourcis et tes extensions, et tu ajoutes un agent dans un panneau latéral. La vidéo montre l'intégration et un usage sur un site existant ; voici la partie qu'aucune démo ne prend le temps d'expliquer — les plans, le bac à sable, le fichier d'instructions — et qui détermine si l'outil t'aide ou te fait perdre une matinée. ## Ce que l'extension est, et ce qu'elle n'est pas Le nom exact dans la place de marché est [« Codex – OpenAI's coding agent »](https://marketplace.visualstudio.com/items?itemName=OpenAI.chatgpt), publiée par OpenAI. La documentation parle de **Codex IDE extension** ([doc officielle](https://developers.openai.com/codex/ide/features)). Trois précisions qui évitent les malentendus : - Elle fonctionne dans **VS Code, Cursor, Windsurf** et les autres éditeurs compatibles VS Code — pas dans Visual Studio (l'IDE .NET), qui n'a pas d'intégration officielle OpenAI. - Elle « utilise le même agent que le Codex CLI et partage la même configuration » : ce n'est pas un produit différent, c'est une autre porte d'entrée. - Les IDE **JetBrains et Xcode** ont leur propre intégration, distincte de cette extension. ## Installer et ouvrir le panneau ``` Ctrl+Shift+X # panneau des extensions, chercher « Codex » ``` Tu installes, puis tu ouvres le panneau en cliquant sur l'icône Codex dans la barre latérale ; si elle n'est pas visible, la palette de commandes répond à **« Codex: Open Codex Sidebar »** ([quickstart](https://developers.openai.com/codex/quickstart)). Le panneau se déplace à droite de l'éditeur, et deux réglages rendent l'ensemble plus agréable : `chatgpt.openOnStartup` pour l'ouvrir au démarrage, `chatgpt.localeOverride` pour la langue de l'interface ([réglages](https://developers.openai.com/codex/ide/settings)). Ensuite, la connexion : **compte ChatGPT** ou **clé API OpenAI** ([quickstart](https://developers.openai.com/codex/quickstart)). La différence n'est pas cosmétique — avec une clé API, tu obtiens l'agent dans le CLI, le SDK et l'extension, mais **pas** les fonctionnalités cloud : la revue de code GitHub et les intégrations d'équipe ne suivent pas. Côté plateforme, macOS et Linux sont documentés de longue date ; Windows est passé du statut « expérimental, de préférence via WSL » à un bac à sable natif, avec un réglage pour forcer l'exécution dans WSL (`chatgpt.runCodexInWindowsSubsystemForLinux`). Sur Linux et WSL2, le bac à sable a besoin de `bubblewrap`, à installer via le gestionnaire de paquets de ta distribution ([bac à sable](https://learn.chatgpt.com/docs/sandboxing)). ## Choisir le mode avant de lancer une tâche L'extension expose trois modes dans un sélecteur, sous la zone de saisie : - **Chat** — discuter, planifier, comprendre un dépôt, sans rien modifier. - **Agent** — le mode par défaut : lire les fichiers, les modifier, exécuter des commandes dans le répertoire de travail. Il demande l'approbation pour sortir du répertoire ou accéder au réseau. - **Agent (Full Access)** — droits élargis ; la documentation elle-même invite à la prudence. Ce découpage recouvre deux mécanismes distincts qu'il vaut mieux ne pas confondre : le **bac à sable** (la frontière technique — quels fichiers, quel réseau) et la **politique d'approbation** (le moment où l'agent s'arrête pour demander). Les modes de bac à sable sont `read-only`, `workspace-write` — le défaut pour le travail local, **réseau désactivé** sauf configuration explicite — et `danger-full-access`. Côté approbations : `untrusted`, `on-request`, `never` ([bac à sable](https://learn.chatgpt.com/docs/sandboxing)). Le réflexe qui sauve une journée : la documentation recommande de créer des **points de commit Git avant et après chaque tâche**, pour pouvoir revenir en arrière. Un agent qui touche trente fichiers ne se corrige pas à la main. ## Cadrer le travail avec AGENTS.md « Codex reads AGENTS.md files before doing any work. » Ce fichier est le levier le plus rentable de tout le dispositif : il porte les commandes de test, les conventions de nommage, les dépendances interdites — tout ce que tu répètes sinon à chaque conversation ([guide](https://developers.openai.com/codex/guides/agents-md)). La découverte suit un ordre précis : d'abord la portée globale (`~/.codex/AGENTS.md`, ou `AGENTS.override.md`), puis la portée projet depuis la racine du dépôt jusqu'au répertoire courant — **un seul fichier par dossier**, et le plus proche du code concerné l'emporte. La taille est plafonnée à 32 Kio par défaut, et un monorepo peut donc porter un `AGENTS.md` par paquet. Tu peux aussi référencer un fichier directement dans un prompt en le « taguant » (`@src/Service/…`), et déposer une image dans la zone de saisie en maintenant `Shift`. ## L'utiliser sur un projet existant C'est le cas d'usage de la vidéo, et celui où un agent change réellement les journées : comprendre un code legacy, refactoriser, corriger un bug reproductible. Le déroulé qui fonctionne : 1. Ouvre le projet dans l'éditeur, et commence en mode **Chat** par « explique-moi comment fonctionne ce module » — tu vérifies la compréhension avant de laisser modifier quoi que ce soit. 2. Écris ou complète l'`AGENTS.md` avec les commandes de tests et de lint. 3. Passe en mode **Agent** pour un changement ciblé, avec un point de commit Git avant. 4. Relis le diff dans l'éditeur, garde ou annule, puis enchaîne dans la même conversation. Au passage, l'agent dispose d'un outil de recherche web activé par défaut pour les tâches locales, il peut déléguer une tâche longue dans le cloud depuis l'IDE (« Run in the cloud ») puis récupérer les changements localement, et le sélecteur de modèle permet de régler l'**effort de raisonnement** — plus élevé, il consomme aussi plus vite ton quota ([fonctionnalités](https://developers.openai.com/codex/ide/features)). ## Les limites à connaître avant de s'enthousiasmer - **Le quota est partagé.** Les messages locaux et les conversations cloud puisent dans la même enveloppe, et des plafonds hebdomadaires peuvent s'ajouter. Les fourchettes publiées varient selon le modèle : consulte la [page de tarifs](https://learn.chatgpt.com/docs/pricing) plutôt qu'un chiffre recopié — la grille et les noms de modèles évoluent vite. - **Les fonctionnalités cloud exigent un compte ChatGPT**, pas une clé API. - **La disponibilité n'est pas universelle** : certaines fonctionnalités sont limitées à certaines régions, et les modèles disponibles dépendent du déploiement, du mode de connexion et du client. - **Windows reste le moins confortable** des trois systèmes, et WSL1 n'est plus supporté par les versions récentes de Codex. Reste la question de fond, celle que la démo ne tranche pas : un agent dans l'éditeur ne remplace pas la compréhension du code qu'il touche. Il excelle sur les tâches cadrées — renommer, extraire un service, écrire les tests d'un bug qu'on vient de reproduire — et il se perd sur les décisions d'architecture. Si tu veux d'abord comparer les éditeurs, j'ai détaillé de mon côté [ce que VS Code fait vraiment mieux que ses concurrents](/blog/visual-studio-code-est-il-vraiment-le-meilleur-editeur-ia-open-source/). Dans la vidéo, tu vois Codex à l'œuvre sur un site web existant, du premier prompt jusqu'au diff validé. ## Pour approfondir **[Agents IA pour coder](https://pentiminax.fr/blog/agents-ia-code.md)** Compare Claude Code, Codex, Cursor et Cline selon ton environnement, le contrôle attendu et ton workflow. [Choisir un agent IA de code](https://pentiminax.fr/blog/agents-ia-code.md) ## Questions fréquentes **Comment installer Codex dans VS Code ?** Depuis la place de marché de VS Code : Ctrl+Shift+X, tu cherches « Codex », tu installes l'extension publiée par OpenAI, puis tu ouvres son panneau depuis la barre latérale — ou via la palette de commandes avec « Codex: Open Codex Sidebar ». Tu te connectes ensuite avec ton compte ChatGPT ou une clé API, et l'extension utilise le même agent que le Codex CLI, avec la même configuration. **Codex est-il gratuit dans VS Code ?** L'extension elle-même ne coûte rien, et Codex est inclus dans tous les plans ChatGPT, y compris l'offre Free — mais pas avec les mêmes limites que les offres payantes. Les messages locaux sont décomptés par tranches de cinq heures, selon le modèle choisi, et ils partagent le même quota que tes conversations cloud ; des plafonds hebdomadaires peuvent s'ajouter. Les fourchettes publiées dépendent du modèle et de la complexité de la tâche, et la grille change souvent : vérifie la page de tarifs le jour où tu montes ton setup. **Codex extension ou Codex CLI, quelle différence ?** Ce sont deux surfaces du même agent : l'extension pour VS Code, Cursor, Windsurf et les éditeurs compatibles, le CLI dans le terminal. Les deux partagent la même configuration et les mêmes fichiers d'instructions, donc rien à réapprendre en passant de l'un à l'autre. Attention : les IDE JetBrains et Xcode utilisent une intégration distincte, pas cette extension. **À quoi sert le fichier AGENTS.md ?** Codex lit les fichiers AGENTS.md avant de travailler : ils portent les conventions du projet — commandes de tests, style, interdits. La découverte part de la portée globale (~/.codex/AGENTS.md) puis descend de la racine du dépôt vers le répertoire courant, un seul fichier par dossier, et le plus proche l'emporte. La taille est plafonnée à 32 Kio par défaut, et un AGENTS.override.md permet de surcharger un dossier spécialisé. **Codex peut-il modifier ou supprimer mes fichiers sans me demander ?** Tout dépend du mode et du bac à sable. En mode Agent, il lit, modifie et exécute des commandes dans le répertoire de travail, mais demande l'approbation pour en sortir ou accéder au réseau : en workspace-write, le réseau est désactivé par défaut. Le mode Agent (Full Access) élargit les droits et la documentation appelle elle-même à la prudence. Le réflexe qui sauve : créer un point de commit Git avant chaque tâche.