Utiliser Codex : guide complet pour débuter avec le CLI, l'extension IDE, Codex Cloud et l'app desktop

Quand vous utilisez Codex pour la première fois, ne lui demandez pas de refactorer tout le projet. Ouvrez d’abord le dépôt et confiez-lui une petite tâche que vous pouvez vérifier en 20 minutes environ.

Vue d’ensemble des points d’entrée

OpenAI Codex n’est pas un simple outil de terminal ni un unique plugin d’éditeur. C’est un coding agent utilisable depuis plusieurs points d’entrée. Dans la documentation officielle, vous verrez CLI, IDE extension, Codex app et Codex web/cloud. Ils partagent des bases communes d’authentification et de capacité, mais ils ne servent pas les mêmes situations.

Comparatif des quatre points d’entrée

Point d’entrée	Définition	Cas d’usage adaptés	Utilisateurs typiques	Limite principale
CLI	Coding agent exécuté dans le terminal local	Dépôt local existant, petite modification, workflow en ligne de commande	Utilisateurs intensifs du terminal, CI	Nécessite un dépôt Git local ; les changements sont visibles localement
IDE Extension	Collaboration dans la barre latérale de l’éditeur	Travail en cours dans l’éditeur, contexte court via open files / selected code	Utilisateurs VS Code / Cursor / Windsurf / JetBrains	Dépend de l’environnement IDE ; les tâches complexes peuvent être déléguées à Cloud
Codex App	Command center desktop	Plusieurs threads, worktrees, automations, gestion Git	Utilisateurs locaux qui gèrent plusieurs tâches en parallèle	Disponible sur macOS / Windows ; vérifier Linux sur la page officielle
Codex Cloud/Web	Agent cloud connecté à GitHub	Dépôts distants, PR, tâches asynchrones, travail loin de l’ordinateur	Équipes et workflows de dépôts distants	Un Enterprise workspace peut demander un admin setup

Authentification et différences de fonctions

Codex propose deux modes d’authentification, mais les fonctions disponibles ne sont pas identiques.

Authentification	Points d’entrée disponibles	Disponibilité des fonctions Cloud	Usage adapté
ChatGPT account (Plus/Pro/Business/Edu/Enterprise)	Tous les points d’entrée (CLI/IDE/App/Cloud)	Inclut GitHub code review, Slack et d’autres cloud-based features	Utilisateurs individuels abonnés et équipes
API key	CLI, SDK, IDE Extension	N’inclut pas GitHub code review, Slack ni d’autres cloud-based features	CI, automatisation, usage facturé via API

Les prix, quotas et fonctions activées doivent être vérifiés sur la page officielle de pricing et dans votre account dashboard. Si vous vous connectez avec une API key et que les fonctions Cloud ne sont pas disponibles, ce n’est pas une panne : c’est une différence de surface.

Point d’entrée CLI

Le CLI est un coding agent qui tourne dans votre terminal local. Il peut lire le code du dossier sélectionné, modifier des fichiers, lancer des commandes et inspecter les résultats. Il convient donc bien aux projets qui existent déjà en local.

Définition et cas d’usage du CLI

Le rôle central du CLI est de travailler dans un dépôt local : lire le code, modifier des fichiers, lancer les tests, lancer le lint, analyser les erreurs et produire un diff. Vous n’avez pas besoin d’ouvrir le fichier dans un éditeur. Une description de tâche dans le terminal suffit.

Le CLI convient si :

• vous avez déjà un dépôt Git local ;
• la tâche touche plusieurs fichiers ou nécessite une vérification par commande ;
• vous voulez voir les changements localement pour git diff et commit ;
• vous travaillez en CI ou via des scripts d’automatisation.

Le CLI convient moins si :

• vous n’avez pas encore de dépôt local, il faut d’abord cloner ;
• vous voulez seulement modifier le fichier actuellement ouvert, où l’IDE extension est plus fluide ;
• vous avez besoin d’un workflow de PR distant, mieux adapté à Cloud.

Installation et connexion du CLI

Les étapes d’installation et de connexion peuvent changer. Gardez donc ce flux comme repère général et vérifiez les commandes exactes sur la page officielle du CLI.

1. Choisir la méthode d’installation sur la page officielle du CLI : la page officielle actuelle propose un standalone installer. Certains anciens articles mentionnent npm, mais la page officielle actuelle doit primer.
2. Premier lancement : après l’installation, exécutez codex et suivez le flux de connexion.
3. Choisir la méthode de connexion : vous pouvez utiliser un ChatGPT account ou une API key. Un ChatGPT account couvre toutes les surfaces ; une API key est limitée au CLI, SDK et IDE extension, sans fonctions Cloud.

Le CLI prend en charge macOS, Windows et Linux. Sous Windows, vous pouvez utiliser PowerShell native sandbox ou WSL2, selon les détails de la page officielle du CLI.

Commandes CLI courantes

Le CLI propose deux modes : interactive et non-interactive. Voici les six commandes ou groupes de flags qu’un débutant doit reconnaître en premier ; les noms peuvent évoluer, donc vérifiez la CLI reference pour la syntaxe exacte.

Commande	Usage	Exemple
codex	Mode interactive pour travailler par dialogue dans le terminal	codex
codex exec	Mode non-interactive pour CI ou scripts	codex exec "fix the CI failure"
codex login	Connexion ou changement de compte	codex login
codex update	Mise à jour du CLI	codex update
codex doctor	Vérification de l’environnement et des problèmes courants	codex doctor
Flags courants	Ajuster permissions, modèle, sandbox et approvals	--sandbox read-only, --model, --ask-for-approval

La CLI reference contient d’autres commandes et flags, comme codex apply, codex cloud et codex app. Certaines commandes peuvent avoir des niveaux de maturité différents. Au début, maîtrisez d’abord le mode interactive ; codex exec viendra ensuite pour l’automatisation.

Première tâche avec le CLI

La règle de départ est simple : choisissez un dépôt existant et donnez à Codex une tâche vérifiable en 20 minutes environ.

Les best practices officielles recommandent un prompt de qualité en quatre parties.

Élément du prompt	Rôle	Exemple
Goal	Objectif attendu	”Corriger la commande d’installation obsolète dans le README”
Context	Contexte pertinent	”C’est un projet Node.js. Le README indique npm install, mais le projet utilise maintenant yarn.”
Constraints	Limites de la modification	”Modifier uniquement le README. Ne pas toucher aux autres fichiers. Après la modification, lancer node README-example.js pour vérifier que la commande fonctionne.”
Done when	Condition d’acceptation	”La commande du README est mise à jour et node README-example.js affiche le résultat attendu.”

Bonnes premières tâches :

• corriger une commande ou un lien obsolète dans le README ;
• ajouter un test manquant ou réparer un test en échec ;
• corriger un petit bug avec un message d’erreur clair ;
• nettoyer un commentaire TODO ;
• ajouter une annotation de type simple à un module.

À éviter pour la première tâche :

• secrets ou données de production ;
• gros refactoring ou nouvelle fonctionnalité complète ;
• objectif sans condition de validation, comme “optimiser les performances”.

Checklist de validation CLI

Quand le CLI a terminé, validez le résultat dans cet ordre.

1. Lire le diff : exécutez git diff dans le terminal et vérifiez que la modification correspond à la demande. Ne vous fiez pas seulement au message “terminé”.
2. Lancer les tests : si le projet en a, lancez npm test ou la commande pertinente.
3. Lancer le lint ou le typecheck : si ces checks existent, vérifiez qu’aucune nouvelle erreur n’apparaît.
4. Vérifier la sortie de commande : si la tâche demandait d’exécuter une commande, confirmez que la sortie correspond à l’attendu.
5. Garder les secrets hors de la première tâche : si la tâche touche une configuration sensible, vérifiez d’abord manuellement que l’agent doit vraiment la modifier.

Commitez ou poussez seulement après validation. Si le changement ne convient pas, restaurez-le avec Git, resserrez le prompt et réessayez.

Point d’entrée IDE Extension

L’IDE extension permet d’utiliser Codex dans la barre latérale de l’éditeur. Elle est adaptée quand vous travaillez déjà dans l’IDE. Son avantage est un contexte plus court et plus précis : open files, selected code et références @file, sans décrire tout le projet dans le terminal.

Définition et cas d’usage de l’IDE

L’IDE extension ne remplace pas l’éditeur. Elle intègre Codex comme coding agent dans votre workflow d’éditeur. Son contexte vient des fichiers ouverts, du code sélectionné ou des fichiers explicitement cités avec @file, ce qui la rend efficace pour les changements ciblés.

L’IDE extension convient si :

• vous travaillez dans VS Code, Cursor, Windsurf ou JetBrains ;
• la tâche concerne le fichier courant ou quelques fichiers liés ;
• vous voulez voir les changements dans l’éditeur pendant l’exécution ;
• vous devez référencer un fichier précis comme contexte.

Elle convient moins si :

• vous n’avez pas d’environnement d’éditeur, où le CLI sera plus simple ;
• la tâche doit tourner longtemps en arrière-plan, auquel cas Cloud peut prendre le relais ;
• la tâche touche beaucoup de fichiers ou des flux de commandes complexes, où CLI ou Cloud seront meilleurs.

IDE pris en charge

L’IDE extension prend en charge les éditeurs suivants. Vérifiez la disponibilité actuelle sur la page officielle IDE.

Éditeur	Notes
VS Code	Pris en charge officiellement
Cursor	Fork de VS Code compatible avec la VS Code extension
Windsurf	Fork de VS Code compatible avec la VS Code extension
JetBrains	Prend en charge Rider, IntelliJ, PyCharm, WebStorm et les IDE liés, selon la disponibilité officielle

Si vous travaillez dans Cursor ou Windsurf, Codex extension et les fonctions IA intégrées de l’éditeur peuvent coexister. Codex devient un autre coding agent que vous choisissez selon la tâche.

Installation et connexion IDE

Suivez la page officielle IDE pour les étapes à jour.

1. Installer depuis le marketplace d’extensions : cherchez Codex extension dans VS Code, Cursor, Windsurf ou JetBrains.
2. Se connecter : utilisez un ChatGPT account ou une API key. Un ChatGPT account couvre toutes les surfaces ; une API key n’inclut pas les fonctions Cloud.

Contexte disponible dans l’IDE

La valeur principale de l’IDE extension est le contexte de l’éditeur.

Type de contexte	Signification	Exemple
Open files	Les fichiers actuellement ouverts servent de contexte	Ouvrez example.tsx, et Codex peut l’inspecter directement
Selected code	Le fragment sélectionné devient le contexte	Sélectionnez une fonction et demandez à Codex de l’expliquer ou de la refactorer
Référence @file	Référencer explicitement un autre fichier par son nom	@example.tsx vérifie les types de ce composant
Reasoning effort	Ajuster le niveau de raisonnement de l’agent	low/medium/high ; utilisez un niveau plus élevé pour les tâches difficiles

L’IDE extension prend aussi en charge les modes Chat, Agent et Agent Full Access. Ils diffèrent par les permissions et le niveau d’automatisation. Commencez par le mode Agent par défaut, puis ajustez quand vous comprenez les compromis.

Déléguer de l’IDE à Cloud

L’IDE extension peut déléguer une tâche à Codex Cloud. C’est utile lorsque :

• la tâche risque de tourner longtemps ;
• elle concerne un dépôt distant ;
• vous devez quitter votre machine pendant que le travail continue ;
• vous voulez exécuter une tâche complexe en arrière-plan puis revenir lire le résultat.

Les slash commands courantes peuvent ressembler à ceci ; les noms peuvent changer, vérifiez la page IDE features.

Commande	Usage
/cloud	Déléguer la tâche courante à Cloud
/local	Exécuter la tâche localement
/review	Relire la base branch, les changements non commités ou un commit
/status	Consulter l’état d’une tâche Cloud

Après /cloud, l’IDE affiche l’état de la tâche. Une fois la tâche Cloud terminée, revenez lire le diff et le résultat.

Point d’entrée Codex App

Codex app est un command center desktop pour le travail multi-thread et la gestion Git. Ce n’est pas une fenêtre de chat de plus. Elle peut récupérer l’historique et la configuration du CLI et de l’IDE extension, ce qui facilite la reprise dans un projet existant.

Définition et cas d’usage de l’app

L’app se concentre sur plusieurs threads, les worktrees, les automations et les opérations Git. Elle est utile quand vous devez traiter plusieurs tâches en parallèle, avec un diff pane et une intégration Git dans un même espace local.

L’app convient si :

• vous devez gérer plusieurs task threads en même temps ;
• vous voulez isoler les tâches parallèles avec des worktrees ;
• vous avez besoin d’un diff pane visuel et d’opérations Git ;
• vous voulez un workflow desktop avec terminal intégré.

Elle convient moins si :

• vous voulez seulement modifier le fichier actuellement ouvert, où l’IDE extension est plus fluide ;
• vous n’avez pas de dépôt local, auquel cas utilisez Cloud ou clonez d’abord ;
• vous voulez simplement lancer une tâche rapide, où le CLI sera plus direct.

Plateformes prises en charge

Codex app prend en charge macOS et Windows. Vérifiez la disponibilité Linux sur la page officielle de l’app.

Installation et connexion de l’app

Suivez la page officielle de l’app pour les étapes à jour.

1. Télécharger et installer : récupérez l’installateur macOS ou Windows depuis la page officielle de l’app.
2. Se connecter : utilisez un ChatGPT account ou une API key. Certaines fonctions peuvent être indisponibles avec une API key, selon les indications officielles.
3. Choisir un projet : au premier lancement, l’app vous demande de sélectionner un dossier de projet local.

App Thread Mode

L’app propose trois thread modes : Local, Worktree et Cloud.

Thread Mode	Rôle	Cas d’usage
Local	Travaille directement dans le dossier du projet courant	Petite modification, tâche mono-thread, choix par défaut du premier message
Worktree	Crée un worktree isolé pour le thread	Tâches parallèles, isolation des changements, réduction des conflits
Cloud	Délègue la tâche à Codex Cloud	Dépôts distants, PR, tâches longues

Le workflow Worktree détaillé mérite un guide séparé. Pour débuter, le mode Local suffit.

Fonctions principales de l’app

Les fonctions principales de l’app incluent :

Fonction	Rôle
Diff pane	Inspecter visuellement les changements et stage / revert par chunks
Opérations Git	Commit, push, création de PR et actions liées au workflow Git
Terminal intégré	Cmd+J ouvre le terminal sur macOS ; vérifiez les raccourcis actuels sur la page officielle
Synchronisation IDE	L’IDE extension et l’app peuvent se synchroniser dans le même projet
MCP settings partagés	CLI, IDE et app peuvent partager les MCP settings

L’app intègre aussi un in-app browser, mais il ne convient pas aux pages qui exigent votre profil de navigateur connecté. Ouvrez ces pages dans un navigateur externe.

Point d’entrée Codex Cloud/Web

Codex web/cloud se connecte à un GitHub account et permet à Codex de travailler dans un dépôt distant et de créer des PR. Il convient aux équipes, aux dépôts distants et aux tâches que vous voulez laisser tourner quand vous n’êtes pas devant l’ordinateur.

Définition et cas d’usage de Cloud

Cloud signifie dépôt distant, PR et travail asynchrone. Il crée un conteneur cloud, checkout le repo, lance le setup script, exécute la tâche, puis renvoie un diff et une réponse.

Cloud convient si :

• vous travaillez sur un dépôt distant que vous ne voulez pas modifier localement ;
• vous voulez que Codex crée ou relise une PR ;
• la tâche doit continuer pendant que vous n’êtes pas devant la machine ;
• le workflow implique une équipe et une revue.

Cloud convient moins si :

• il s’agit d’une petite modification locale, où CLI ou IDE sont plus adaptés ;
• c’est votre toute première tâche, mieux vérifiée localement ;
• la tâche nécessite beaucoup d’allers-retours interactifs, car Cloud est asynchrone.

Tâches adaptées à Cloud

Cloud convient aux types de tâches suivants.

Type de tâche	Description
PR review	Relire une PR dans un dépôt distant
Travail complexe ou long	Exécuter des tâches qui prennent du temps
Tâches parallèles	Déléguer plusieurs tâches en même temps
Changement dans un dépôt distant	Modifier sans toucher à votre checkout local

Ne confiez pas à Cloud un gros refactoring ou une fonctionnalité complète dès le premier jour. Utilisez d’abord CLI ou IDE en local, apprenez à lire le résultat, puis envoyez à Cloud les tâches qui s’y prêtent.

Un Enterprise workspace peut demander un admin setup. Vérifiez la page officielle Cloud et la policy de votre workspace.

Déroulé d’une tâche Cloud

Une Cloud task suit en gros cinq étapes :

1. Créer un conteneur : Cloud crée l’environnement d’exécution.
2. Checkout repo : le dépôt GitHub est checkout.
3. Lancer le setup script : s’il existe, le setup script configuré est exécuté.
4. Exécuter la boucle agent : l’agent lance des commandes, vérifie les résultats et continue jusqu’à la fin de la tâche.
5. Retourner le diff et la réponse : une fois terminée, la tâche affiche le diff et une réponse.

Le cache du conteneur peut durer jusqu’à 12 heures. Vérifiez la policy actuelle sur la page officielle Cloud environments.

Notes de sécurité Cloud

Cloud a quelques limites de sécurité importantes.

Point de sécurité	Signification
Les secrets ne sont disponibles que pendant le setup	Les secrets sont disponibles pour les setup scripts et supprimés avant l’agent phase. Ne faites pas dépendre l’agent phase de scripts qui lisent des secrets.
L’agent phase n’a pas d’internet par défaut	L’accès internet est off par défaut pendant l’agent phase, même si limited ou unrestricted access peut être configuré. Ne partez pas du principe que l’agent peut joindre des services externes.
Le cache dure jusqu’à 12 heures	Le cache de conteneur n’est pas un stockage long terme. Ne supposez pas que l’état persiste indéfiniment.

La configuration de sécurité détaillée relève d’un guide séparé sur permissions, sandboxes et secrets.

Étapes suivantes

Après la première tâche, si Codex répète la même erreur au deuxième ou troisième essai, il est temps d’écrire un guide AGENTS.md pour le projet. AGENTS.md donne aux coding agents des consignes propres au projet, afin de ne pas répéter le même contexte dans chaque prompt.

Sujets à lire ensuite :

• Règles de projet AGENTS.md : conserver les consignes du projet et réduire le contexte répété.
• Isolation par worktree : lancer plusieurs tâches en parallèle sans mélanger les changements.
• Workflow Cloud : dépôts distants, PR et configuration d’environnement.
• Permissions, sandboxes et secrets : limites de sécurité et configuration.
• Comparatif de trois outils : Codex vs Claude Code vs Cursor sur de vrais projets.
• Automatisation codex exec : appels CI et scripts.

Articles BetterLink liés :

• Panorama 2026 des AI coding tools
• Guide de productivité Claude Code CLI
• Pratique du workflow Cursor
• Codex gateway et harness