Documentation francaise

OpenAI Codex

Manuel de reference et guide utilisateur, presentes dans un esprit DEC/VSI avec la charte graphique NetDTL.

ProduitOpenAI Codex

StyleDEC/VSI, NetDTL

Date12/06/2026

Aucun resultat dans le document actif.

OpenAI Codex - Manuel de reference

Version de travail francaise, d'apres la documentation officielle OpenAI Codex et la presentation documentaire DEC/VSI.

Preface

Ce manuel de reference decrit les fonctions d'OpenAI Codex. Il ne constitue pas un guide d'utilisation pas a pas. Les commandes, menus et fichiers sont mentionnes uniquement pour identifier les fonctions qu'ils exposent.

Codex est l'agent de developpement logiciel d'OpenAI. Il assiste les activites de programmation, d'analyse de code, de revue, de correction d'anomalies, de migration, de documentation, de tests et d'automatisation de travaux de developpement.

Public vise

Ce manuel s'adresse aux developpeurs, mainteneurs, responsables techniques, equipes de revue et administrateurs qui doivent connaitre les fonctions disponibles dans Codex et les limites de chaque surface d'execution.

Structure du document

Ce manuel contient les chapitres suivants :

Chapitre 1 : presentation fonctionnelle de Codex.
Chapitre 2 : surfaces d'execution.
Chapitre 3 : modeles, raisonnement et contexte.
Chapitre 4 : outils et operations sur le code.
Chapitre 5 : personnalisation.
Chapitre 6 : securite, bac a sable et approbations.
Chapitre 7 : automatisation et integrations.
Chapitre 8 : objets de reference.
Chapitre 9 : entrees de commande et de configuration.
Chapitre 10 : matrice fonctionnelle.

Documents associes

Les sources officielles principales sont les pages OpenAI Developers suivantes : Codex Overview, Codex Quickstart, Codex app features, Codex CLI features, Codex customization, ainsi que les pages relatives a la configuration, aux permissions, au bac a sable, a MCP, aux skills, aux hooks, aux plugins, aux subagents et aux automations.

Conventions

Les noms de fichiers, options, commandes, variables et identifiants sont indiques en chasse fixe. Les termes App, CLI, IDE Extension, Web, Local, Worktree et Cloud designent les surfaces et modes Codex officiels.

1. Vue d'ensemble fonctionnelle

Codex fournit un agent interactif capable de lire un espace de travail, raisonner sur son contenu, proposer un plan, modifier des fichiers, executer des commandes, vérifier des resultats et rendre compte de son travail.

Les fonctions principales comprennent :

generation et modification de code ;
comprehension et explication de bases de code ;
revue de changements ;
diagnostic et correction d'erreurs ;
execution de commandes locales ou distantes selon la surface ;
production et verification d'artefacts ;
gestion de tâches paralleles ;
interaction avec des outils externes ;
automatisation de tâches recurrentes.

Codex applique les instructions du fil de discussion, les consignes de projet, les regles de configuration et les contraintes de securite disponibles dans l'environnement actif.

2. Surfaces d'execution

2.1 Codex App

La Codex App est une application de bureau pour macOS et Windows. Elle fournit une experience centree sur les fils Codex, les projets, les worktrees, les automatisations et les fonctions Git integrees.

Elle comprend notamment une liste de projets, des fils de discussion par projet, des modes Local, Worktree et Cloud, un terminal integre par fil, un panneau de differences Git, des fonctions Git courantes, un navigateur integre, la prise en charge des artefacts et la prise en charge des skills, MCP, notifications, memoires et automatisations.

2.2 Codex CLI

Le client CLI fournit une interface terminale plein ecran et des sous-commandes non interactives. Il permet de travailler depuis un repertoire local, de reprendre des sessions et d'executer Codex dans des workflows automatises.

Les fonctions CLI comprennent le mode interactif conversationnel, le lancement avec prompt initial, la reprise de sessions precedentes, la selection de modele, l'affichage et la copie de sorties, l'historique de prompts, l'execution non interactive, le serveur d'application et le mode distant.

2.3 Extension IDE

L'extension IDE place Codex dans l'éditeur. Elle fournit un contexte issu des fichiers ouverts et permet d'executer des tâches directement depuis le projet de l'éditeur.

Elle prend en charge le mode agent par defaut, la lecture et la modification dans le repertoire du projet, la synchronisation avec la Codex App lorsque les deux surfaces sont ouvertes sur le meme projet, les commandes IDE, les commandes slash et le contexte automatique des fichiers consultes.

2.4 Codex Web et Cloud

La surface Web permet d'executer des tâches Codex dans des environnements cloud configures. Les environnements cloud decouplent l'execution de la machine locale et permettent des tâches paralleles ou deleguees.

Les fonctions cloud dependent de la configuration d'environnement, de l'acces au depot, des politiques reseau et des integrations actives.

2.5 Modes Local, Worktree et Cloud

Le mode Local travaille dans le repertoire courant du projet. Le mode Worktree isole les modifications dans un worktree Git separe. Le mode Cloud execute le travail dans un environnement distant configure.

Les modes Local et Worktree s'executent sur l'ordinateur de l'utilisateur. Le mode Worktree fournit une isolation Git entre le travail courant et les changements produits par Codex.

3. Modeles, raisonnement et contexte

3.1 Modeles

Codex utilise des modeles OpenAI adaptes aux tâches de developpement. La documentation officielle indique gpt-5.5 comme modele recommande pour la plupart des tâches Codex, avec un accent sur le codage complexe, l'utilisation d'outils, la planification et les travaux multi-etapes.

La disponibilite des modeles depend du plan, de la surface et des droits du compte.

3.2 Raisonnement

Codex peut decomposer une demande, etablir un plan, lire les fichiers pertinents, effectuer des modifications, lancer des verifications et ajuster son travail selon les resultats obtenus.

Le raisonnement est contraint par le contexte accessible, les instructions systeme et utilisateur, les regles du projet, les outils disponibles, les permissions, le bac a sable et la politique d'approbation.

3.3 Contexte de conversation

Un fil Codex conserve les messages, decisions, plans et resultats pertinents pour le travail en cours. Les sessions peuvent etre reprises lorsque la surface le permet.

Le contexte peut comprendre le prompt courant, les messages precedents, le contenu de fichiers lus, les sorties de commandes, les images ou documents fournis, les consignes de projet et les donnees d'outils connectes.

3.4 Memoires

Lorsque la fonction est disponible, les memoires transportent des informations stables entre fils, telles que preferences, conventions de projet ou habitudes recurrentes. Elles completent les consignes de projet mais ne remplacent pas les instructions explicites du fil.

4. Outils et operations sur le code

4.1 Lecture et modification de fichiers

Codex peut lire les fichiers accessibles, analyser leur structure et produire des changements. Les modifications sont limitees par l'espace de travail, le bac a sable et les permissions accordees.

4.2 Execution de commandes

Codex peut executer des commandes via la surface active, notamment pour inspecter un projet, lancer des tests, demarrer un serveur local, formater du code ou vérifier un resultat. L'execution est soumise aux approbations et aux restrictions du bac a sable.

4.3 Revue de code

Codex fournit une fonction de revue qui recherche anomalies, regressions, risques de comportement et lacunes de test. Dans la Codex App, le panneau de diff permet d'examiner les changements, de commenter des lignes et de demander des corrections.

4.4 Git

Codex integre ou utilise des fonctions Git selon la surface : affichage de diff, staging, commit, push, creation de pull request, travail en worktree et inspection de l'etat du depot.

4.5 Terminal integre

Dans la Codex App, chaque fil dispose d'un terminal associe au projet ou au worktree. Ce terminal fournit un canal local pour les commandes de verification et d'exploitation du projet.

4.6 Navigateur integre et Browser Use

La Codex App fournit un navigateur integre pour previsualiser, commenter et vérifier des pages locales, des previews de fichiers ou des pages publiques ne necessitant pas de connexion.

Browser Use permet a Codex d'operer certaines pages, notamment des serveurs de developpement locaux et des previews de fichiers, lorsque les permissions et plugins requis sont presents.

4.7 Computer Use

Computer Use permet a Codex d'interagir avec des applications macOS ou Windows en voyant, cliquant et tapant. Cette fonction vise les tests d'applications de bureau, la reproduction d'anomalies GUI et les flux non accessibles par API ou plugin.

4.8 Entrees image et generation d'images

Codex accepte des images comme contexte. Il peut aussi generer ou modifier des images dans un fil lorsque la fonction est disponible, notamment pour des assets d'interface, illustrations, placeholders ou sprites.

4.9 Artefacts non-code

Codex peut produire et vérifier des artefacts tels que PDF, documents, feuilles de calcul et présentations. La Codex App peut afficher ces artefacts dans la barre latérale de tâche.

5. Personnalisation

5.1 AGENTS.md

AGENTS.md fournit des consignes durables pour un depot ou une partie de depot. Les fichiers les plus proches du repertoire de travail ont priorite sur les fichiers plus generaux.

AGENTS.md sert a decrire les commandes de build et de test, conventions de code, attentes de revue, chemins ou fichiers a privilegier et instructions propres a une arborescence.

5.2 Configuration

Codex peut etre configure par fichiers de configuration, variables d'environnement et reglages de surface. La configuration couvre notamment modeles, approbations, bac a sable, outils, MCP, hooks et preferences d'execution.

5.3 Skills

Les skills sont des capacites reutilisables, definies par un dossier contenant un fichier SKILL.md et, eventuellement, des scripts, references et assets.

Elles permettent d'encapsuler des workflows repetables, une expertise de domaine, des modeles et ressources, des procedures avec validations et des integrations indirectes via MCP.

5.4 Plugins

Les plugins sont des unites distribuables qui peuvent inclure skills, outils, serveurs MCP, hooks, assets ou applications. Ils servent a empaqueter des capacites partageables.

5.5 MCP

Le Model Context Protocol relie Codex a des outils et systemes externes. Les configurations MCP sont partagees entre la Codex App, le CLI et l'extension IDE lorsque la surface les prend en charge.

5.6 Hooks

Les hooks permettent d'associer des traitements a des evenements du cycle de vie Codex. Ils servent a appliquer ou vérifier des politiques techniques autour des operations de l'agent.

5.7 Subagents

Les subagents representent des agents specialises auxquels Codex peut deleguer des parties de travail. Ils sont destines aux tâches qui beneficient d'une expertise ou d'un contexte specialise.

6. Securite, bac a sable et approbations

6.1 Bac a sable

Le bac a sable definit les ressources accessibles a Codex : fichiers lisibles, emplacements modifiables, acces reseau et autres capacites d'execution. Par defaut, Codex limite son travail au projet actif lorsque la surface le permet.

6.2 Approbations

Les approbations determinent les operations qui exigent une confirmation de l'utilisateur ou une revue automatique. Elles peuvent etre accordees pour une action unique ou pour une portee plus large selon la surface et la politique.

6.3 Permissions

Les permissions controlent l'acces aux fichiers, commandes, reseaux, applications locales et outils externes. Les permissions peuvent provenir de la configuration locale, de la politique admin ou d'une approbation utilisateur.

6.4 Reseau

L'acces reseau peut etre desactive, limite, mis en cache ou accorde selon le mode. La recherche web de premiere partie est disponible dans certaines surfaces et peut fonctionner via cache ou resultats en direct selon la configuration.

7. Automatisation et integrations

7.1 Automations

Les automations executent des tâches recurrentes ou planifiees. Elles peuvent produire rapports, vérifier erreurs, surveiller changements ou continuer un suivi.

Les automations de fil conservent le contexte d'une conversation particuliere. Les automations de projet ou autonomes lancent des travaux recurrents avec un contexte de depart defini.

7.2 Mode non interactif

Le mode non interactif permet d'executer Codex dans des scripts ou chaines d'integration. Il convient aux tâches definies par un prompt et une configuration.

7.3 Codex SDK

Le SDK Codex fournit une interface de programmation pour integrer Codex dans des workflows applicatifs ou outils internes.

7.4 App Server et mode distant

L'app server permet a un client Codex de se connecter a un serveur distant par WebSocket ou socket local, avec mecanismes d'authentification appropries.

7.5 Integrations GitHub, Slack et Linear

Les integrations relient Codex a des systemes de collaboration et de suivi. Leur disponibilite depend de l'installation, des autorisations de compte et de la configuration d'organisation.

8. Objets de reference

8.1 Projet

Un projet associe Codex a un repertoire ou depot. Il definit le perimetre de travail principal.

8.2 Fil

Un fil est une conversation operationnelle avec Codex. Il contient les demandes, reponses, plans, sorties et modifications associees a une tâche ou serie de tâches.

8.3 Worktree

Un worktree est une copie de travail Git separee, utilisee pour isoler les modifications d'un fil par rapport au repertoire principal.

8.4 Chat

Un chat est un fil qui ne depend pas necessairement d'un dossier projet ou depot. Il convient a la recherche, la planification et les workflows d'outils connectes.

8.5 Skill

Une skill est un module d'instructions et de ressources reutilisables selectionne par Codex lorsqu'une tâche correspond a sa description.

8.6 Plugin

Un plugin est un paquet installable qui regroupe des capacites Codex.

8.7 MCP server

Un serveur MCP expose des outils, ressources ou actions externes a Codex.

8.8 Hook

Un hook est un traitement associe a un evenement Codex.

8.9 Automation

Une automation est une execution planifiee ou recurrente d'une instruction Codex.

8.10 Bac a sable

Le bac a sable est l'ensemble des limites d'acces appliquees aux actions de Codex.

9. Entrees de commande et de configuration

Ce chapitre decrit les principales entrees fonctionnelles. Il ne constitue pas une procedure d'utilisation.

9.1 Commande `codex`

La commande codex represente le point d'entree principal du client terminal. Elle ouvre une session interactive lorsque lancee sans sous-commande et accepte un prompt initial lorsque du texte lui est fourni.

Fonctions associees :

initialisation d'une conversation dans le repertoire courant ;
selection d'un modele ou d'options de session ;
interaction avec le bac a sable et les approbations ;
affichage de plans, diffs et sorties ;
reprise ou delegation a des sous-commandes.

9.2 Sous-commande `resume`

resume represente la fonction de reprise de session. Elle rattache une nouvelle execution a un transcript existant et conserve les elements de contexte pertinents de la conversation precedente.

Les variantes de reprise distinguent la derniere session, une session choisie dans une liste, une session specifique par identifiant et, selon l'option, les sessions hors du repertoire courant.

9.3 Sous-commande `exec`

exec represente l'execution non interactive. Elle traite une instruction fournie au lancement et produit une sortie destinee aux scripts, chaines d'integration ou tâches reproductibles.

Cette fonction conserve les contraintes de securite de Codex : bac a sable, approbations, configuration, instructions de projet et limites d'outils.

9.4 Sous-commandes serveur

Les fonctions serveur, notamment l'app server et les modes distants, exposent une session Codex a un client se connectant par canal local ou WebSocket. Elles fournissent une separation entre le processus de service et le client d'interaction.

Les fonctions serveur comprennent :

ecoute sur une adresse locale ou distante ;
authentification par jeton ou mecanisme configure ;
connexion de clients distants ;
controle d'une session depuis une autre surface.

9.5 Commandes slash

Les commandes slash representent des actions de session disponibles dans les interfaces interactives. Elles exposent des fonctions telles que l'affichage d'etat, le changement de modele, la gestion de contexte, la sortie de session ou l'acces a l'aide.

La disponibilite exacte varie selon CLI, IDE et App.

9.6 Fichier `AGENTS.md`

AGENTS.md est un fichier d'instructions durables. Il est lu comme guidance de projet et peut exister a plusieurs niveaux : global utilisateur, racine du depot et sous-repertoires. Les fichiers plus proches du repertoire de travail definissent les consignes les plus specifiques.

Attributs fonctionnels :

portee durable ;
versionnable avec le depot lorsqu'il est place dans le projet ;
priorite par proximite ;
adaptation du comportement de Codex avant le travail ;
support des conventions, commandes et attentes de revue.

9.7 Fichier de configuration

Le fichier de configuration Codex represente les reglages persistants du client et de l'agent. Il peut definir les valeurs par defaut relatives au modele, aux permissions, au bac a sable, aux serveurs MCP, aux hooks et aux preferences d'execution.

Les reglages effectifs resultent de la combinaison entre configuration globale, configuration projet, options de lancement, politiques gerees et choix d'interface.

9.8 Variables d'environnement

Les variables d'environnement fournissent un canal de configuration externe au fichier de configuration. Elles conviennent aux secrets, aux chemins propres a l'environnement et aux reglages injectes par une chaine d'execution.

Une variable d'environnement peut etre ignoree ou surclassee si la surface, la politique d'organisation ou la configuration active impose une autre valeur.

9.9 Regles et hooks

Les regles definissent des politiques d'autorisation ou de refus autour des commandes et actions. Les hooks fournissent des points d'execution autour d'evenements Codex.

Les regles sont declaratives. Les hooks sont proceduraux. Les deux mecanismes completent les approbations utilisateur et les limites du bac a sable.

9.10 Profils de permissions

Les profils de permissions representent des ensembles de capacites accordees ou refusees : lecture, ecriture, execution, acces reseau, acces a des repertoires supplementaires ou utilisation d'outils externes.

Les profils peuvent etre definis localement, geres par une organisation ou demandes pendant une session.

10. Matrice fonctionnelle

10.1 Fonctions par surface

La Codex App couvre les fils paralleles, worktrees, terminal integre, diffs Git, artefacts, navigateur integre, automations, notifications et synchronisation IDE.

Le CLI couvre l'interaction terminale, les sessions scriptables, la reprise de conversation, les modes non interactifs, les options de lancement et les modes serveur ou distant.

L'extension IDE couvre le contexte de l'éditeur, les fichiers ouverts, les selections, les commandes IDE et l'iteration directement dans l'environnement de developpement.

Codex Web et Cloud couvrent l'execution distante, les environnements configures, les tâches deleguees et les integrations cloud.

10.2 Fonctions par type de tâche

Pour comprehension de code, Codex utilise lecture de fichiers, analyse de structure, synthese et explication.

Pour modification de code, Codex utilise planification, edition, execution de commandes, verification et resume.

Pour revue, Codex utilise inspection de diff, recherche de bugs, risques, regressions et tests manquants.

Pour automatisation, Codex utilise prompts recurrents, contexte de projet, worktrees ou environnement local, skills et notifications.

Pour integration externe, Codex utilise MCP, plugins, connecteurs, API ou surfaces cloud selon la configuration.

10.3 Relations entre mecanismes

AGENTS.md decrit les regles durables du depot. Les skills decrivent des workflows reutilisables. Les plugins empaquetent des capacites. MCP connecte Codex a des systemes externes. Les hooks imposent des traitements autour d'evenements. Les automations planifient l'execution.

Ces mecanismes sont complementaires : AGENTS.md oriente le comportement, les skills decrivent comment realiser des workflows, MCP donne acces a des donnees ou actions, les hooks encadrent l'execution et les automations declenchent le travail dans le temps.

Sources

OpenAI Developers, Codex Overview, consulte le 12 juin 2026.
OpenAI Developers, Codex Quickstart, consulte le 12 juin 2026.
OpenAI Developers, Codex app features, consulte le 12 juin 2026.
OpenAI Developers, Codex CLI features, consulte le 12 juin 2026.
OpenAI Developers, Codex customization, consulte le 12 juin 2026.
OpenAI Developers, documentation Codex liee a sandboxing, configuration, MCP, skills et automatisation, consultee le 12 juin 2026.

OpenAI Codex - Guide utilisateur

Version de travail francaise, d'apres la documentation officielle OpenAI Codex et la presentation documentaire DEC/VSI.

Preface

Ce guide explique comment se servir d'OpenAI Codex pour travailler sur du code, reviser des changements, automatiser des tâches et exploiter les surfaces App, CLI, IDE et Web.

Il suppose que l'utilisateur dispose d'un compte ou d'une cle API autorisee et que Codex est disponible dans son plan ou son organisation.

Public vise

Ce guide s'adresse aux utilisateurs qui veulent lancer Codex, choisir une surface, confier une tâche, examiner les changements et regler les principaux mecanismes de personnalisation et de securite.

Structure du document

Ce guide contient les chapitres suivants :

Chapitre 1 : demarrage et choix de surface.
Chapitre 2 : utilisation de la Codex App.
Chapitre 3 : utilisation du CLI.
Chapitre 4 : utilisation de l'extension IDE.
Chapitre 5 : utilisation de Codex Web et Cloud.
Chapitre 6 : guider Codex.
Chapitre 7 : vérifier et finaliser le travail.
Chapitre 8 : personnaliser Codex.
Chapitre 9 : permissions, bac a sable et depannage courant.
Chapitre 10 : scenarios courants.

Conventions

Les commandes sont donnees en chasse fixe. Les exemples doivent etre adaptes au projet, au shell et aux regles locales. Les operations qui modifient des fichiers, executent des commandes ou accedent au reseau peuvent demander une approbation.

1. Demarrer

1.1 Choisir la surface a utiliser

Utilisez la Codex App lorsque vous voulez piloter plusieurs projets, gerer des fils en parallele, travailler avec des worktrees, examiner des diffs et utiliser les fonctions integrees de bureau.

Utilisez le CLI lorsque vous travaillez principalement dans un terminal ou que vous voulez automatiser des tâches.

Utilisez l'extension IDE lorsque vous voulez que Codex voie naturellement le contexte de l'éditeur et travaille au plus pres des fichiers ouverts.

Utilisez Codex Web ou Cloud lorsque vous voulez deleguer un travail a un environnement distant configure.

1.2 Preparer un projet

Avant de lancer une tâche :

Ouvrez le dossier du projet.
Verifiez l'etat Git.
Notez les commandes de test ou de verification importantes.
Decrivez clairement le resultat attendu.
Precisez les limites : fichiers a ne pas toucher, style a conserver, tests a executer.

Il est prudent de creer un point de controle Git avant une tâche qui peut modifier le code.

1.3 Rediger une bonne demande

Une demande efficace contient l'objectif, le contexte utile, les contraintes, les fichiers ou zones concernees, le niveau de risque accepte et la verification attendue.

Exemple :

Trouve pourquoi le test de paiement echoue et corrige uniquement la cause probable.
Lis d'abord les fichiers de test et de service de paiement.
Garde les changements minimaux et lance le test concerne.

2. Utiliser la Codex App

2.1 Installer et ouvrir

Installez l'application Codex pour macOS ou Windows depuis la page officielle. Ouvrez l'application, puis connectez-vous avec un compte ChatGPT ou une cle API OpenAI.

Certaines fonctions peuvent varier selon le mode d'authentification, le plan et les politiques d'organisation.

2.2 Selectionner un projet

Dans l'application, ajoutez ou selectionnez le dossier du projet. Un projet correspond a un codebase ou a une partie coherentement bornee d'un codebase.

Si un depot contient plusieurs applications independantes, creez des projets distincts afin de garder un perimetre de travail clair.

2.3 Choisir le mode du fil

Au lancement d'un fil, choisissez un mode :

Local : Codex travaille dans le dossier courant.
Worktree : Codex cree un worktree Git pour isoler les changements.
Cloud : Codex travaille dans un environnement distant configure.

Choisissez Worktree pour essayer une idee, executer plusieurs tâches en parallele ou proteger votre repertoire courant.

2.4 Envoyer une premiere demande

Dans le compositeur, decrivez la tâche. Pour un premier contact avec un projet, demandez une analyse :

Explique l'organisation de ce projet et indique les commandes utiles pour le tester.

Pour une modification ciblee :

Ajoute la validation manquante dans le formulaire d'inscription.
Respecte le style existant et lance les tests pertinents.

2.5 Suivre le travail

Pendant l'execution, surveillez le plan propose, les fichiers lus, les commandes demandees, les changements produits, les messages d'erreur et les demandes d'approbation. Reorientez Codex si le travail sort du perimetre voulu.

2.6 Utiliser le terminal integre

Chaque fil dispose d'un terminal associe au projet ou au worktree. Utilisez-le pour lancer des commandes de verification :

git status
npm test
pnpm run lint

Codex peut lire la sortie du terminal lorsque la surface le permet. Vous pouvez donc lui demander d'analyser un echec de test deja visible.

2.7 Examiner les differences Git

Ouvrez le panneau de diff pour voir les fichiers modifies. Verifiez que les bons fichiers ont change, que les modifications sont minimales, que les tests ou preuves sont presents et qu'aucune donnee sensible n'a ete ajoutee.

Ajoutez des commentaires inline si vous voulez que Codex corrige une ligne ou une section precise.

2.8 Commit, push et pull request

Lorsque les changements sont corrects, utilisez les fonctions Git integrees ou le terminal pour preparer le commit.

Avant de pousser :

Relisez le diff.
Lancez les tests requis.
Verifiez le message de commit.
Creez la pull request si le workflow du projet le demande.

2.9 Utiliser le navigateur integre

Pour vérifier une application web locale :

Demarrez le serveur de developpement.
Ouvrez la page dans le navigateur integre.
Inspectez le rendu.
Ajoutez des commentaires sur les elements visuels a corriger.
Demandez a Codex d'appliquer les corrections.

Le navigateur integre ne remplace pas un navigateur connecte a votre profil. Il n'est pas destine aux flux d'authentification complexes.

2.10 Utiliser des images et artefacts

Glissez une image dans le prompt pour la fournir comme contexte. Pour des documents, feuilles de calcul, présentations ou PDF, indiquez le type de fichier attendu, la structure, les criteres de verification et le chemin de sortie souhaite si necessaire.

3. Utiliser le CLI

3.1 Lancer une session interactive

Depuis le repertoire du projet :

codex

Vous pouvez aussi fournir une demande initiale :

codex "Explique cette base de code"

Codex ouvre une interface terminale interactive qui peut lire le depot, proposer un plan, modifier des fichiers et executer des commandes selon les autorisations.

3.2 Interagir pendant une session

Pendant une session CLI, envoyez des prompts et extraits de code, examinez les plans et diffs, acceptez ou refusez les operations controlees, utilisez les commandes slash disponibles et quittez la session lorsque le travail est termine.

3.3 Reprendre une session

Pour rouvrir une session recente :

codex resume

Pour reprendre la derniere session du repertoire courant :

codex resume --last

Pour afficher aussi les sessions d'autres repertoires :

codex resume --all

La reprise conserve le transcript, l'historique de plan et le contexte utile de la session.

3.4 Lancer avec un modele particulier

Lorsque vous devez choisir explicitement un modele :

codex --model gpt-5.5

Dans une session, utilisez la commande de changement de modele fournie par l'interface.

3.5 Executer en mode non interactif

Pour des workflows automatises, utilisez le mode non interactif lorsque disponible :

codex exec "Execute les tests et resume les echecs"

Le mode non interactif convient aux tâches bornees. Fournissez un prompt precis et configurez les permissions avant de l'integrer a une chaine automatique.

3.6 Utiliser le mode distant

Un serveur d'application peut exposer une connexion WebSocket. Le client CLI peut s'y connecter avec une URL distante et une authentification configuree.

N'utilisez une connexion non chiffree que pour localhost ou un tunnel de confiance. Pour une machine distante, prevoyez authentification et TLS selon les regles officielles.

4. Utiliser l'extension IDE

4.1 Installer l'extension

Installez l'extension Codex dans l'éditeur pris en charge. Ouvrez ensuite le panneau Codex depuis la barre latérale.

4.2 Se connecter

Connectez-vous avec votre compte ChatGPT ou une cle API OpenAI. L'extension demarre en mode agent par defaut lorsque la configuration l'autorise.

4.3 Travailler avec le contexte de l'éditeur

Ouvrez les fichiers pertinents avant de poser une question. Vous pouvez demander :

Explique le fichier ouvert et indique les fonctions a risque.

Ou :

Corrige le probleme dans la fonction selectionnee sans modifier l'API publique.

4.4 Synchroniser avec la Codex App

Lorsque la Codex App et l'extension IDE sont ouvertes sur le meme projet, elles peuvent synchroniser le contexte et les fils. Utilisez cette synchronisation pour alterner entre travail dans l'éditeur et revue plus large dans l'application.

5. Utiliser Codex Web et Cloud

5.1 Choisir une tâche cloud

Utilisez Cloud pour les tâches qui peuvent s'executer dans un environnement distant : analyse de depot, correction isolee, migration, generation de tests, revue ou tâche parallele longue.

Evitez d'envoyer une tâche cloud lorsque le resultat depend d'un fichier local non pousse, d'un secret local ou d'un outil indisponible dans l'environnement.

5.2 Configurer l'environnement

Avant de confier une tâche cloud, verifiez l'acces au depot, les dependances, les commandes de test, l'acces reseau, les variables et secrets autorises, ainsi que les politiques d'organisation.

5.3 Recuperer les resultats

Examinez le resume, les fichiers modifies, les logs et les tests executes. Ramenez les changements dans votre workflow Git selon les procedures du projet.

6. Guider Codex

6.1 Donner des instructions courtes et verifiables

Preferez :

Ajoute un test pour le cas ou le montant est nul, puis corrige la validation si le test echoue.

Evitez les demandes trop larges sans critere :

Ameliore tout le module.

6.2 Encadrer les changements

Indiquez clairement les fichiers autorises, les fichiers interdits, le niveau de refactorisation accepte, les tests obligatoires et le format de reponse attendu.

6.3 Demander une revue

Pour une revue de code :

Fais une revue de ce diff. Priorise les bugs, regressions, risques de securite et tests manquants.
Ne modifie pas les fichiers.

6.4 Demander une correction prudente

Pour une correction :

Trouve la cause la plus probable de l'echec et corrige-la avec le plus petit changement raisonnable.
Explique les fichiers modifies et les tests lances.

6.5 Fournir des preuves attendues

Ajoutez la verification desiree :

Lance le test unitaire concerne et indique le resultat exact.
Si le test ne peut pas etre lance, explique pourquoi.

7. Verifier et finaliser

7.1 Lire le resume

A la fin d'une tâche, verifiez que le resume repond a la demande initiale : objectif atteint, fichiers modifies, tests lances, limitations et suites possibles.

7.2 Controler le diff

Avant de valider :

git status
git diff

Assurez-vous qu'aucun fichier non lie n'est modifie.

7.3 Lancer les tests

Lancez les tests recommandes par Codex ou ceux du projet :

npm test
pnpm test
pytest
cargo test

Adaptez ces commandes a votre stack.

7.4 Demander une deuxieme passe

Si un detail manque :

Le changement est bon, mais ajoute un test pour le cas limite X et relance uniquement ce test.

Si le resultat est trop large :

Reviens a une correction plus minimale. Garde uniquement les changements necessaires au bug signale.

8. Personnaliser Codex

8.1 Ajouter un fichier AGENTS.md

Dans le depot, creez un fichier AGENTS.md pour les regles durables :

# Instructions pour Codex

- Utiliser pnpm, pas npm.
- Lancer `pnpm test` avant de proposer un commit.
- Ne pas modifier les fichiers generes dans `dist/`.
- Pour les composants React, suivre les patterns de `src/components`.

Placez un AGENTS.md plus specifique dans un sous-repertoire si des regles differentes s'appliquent a cette zone.

8.2 Mettre a jour AGENTS.md apres une erreur recurrente

Si Codex repete une mauvaise hypothese, demandez-lui de formaliser la correction :

Ajoute dans AGENTS.md que les migrations de base de donnees doivent etre creees avec l'outil interne, pas a la main.

8.3 Utiliser une skill

Utilisez une skill lorsqu'un workflow revient souvent : release, revue, generation de documentation, verification de donnees ou creation d'artefact.

Vous pouvez invoquer explicitement une skill si son nom est connu :

$nom_de_skill Prepare la note de version a partir du diff courant.

8.4 Configurer MCP

Utilisez MCP lorsque Codex doit accéder a des outils ou donnees externes : tickets, docs internes, bases de connaissances, depots, services de design ou autres systemes d'equipe.

Dans la Codex App, ouvrez la section MCP des reglages pour activer un serveur recommande ou ajouter une configuration.

8.5 Utiliser les hooks

Employez les hooks pour automatiser des controles autour des actions Codex, par exemple vérifier une politique avant une commande ou journaliser certains evenements.

8.6 Utiliser les automations

Pour creer une tâche recurrente, decrivez la frequence, le projet concerne, la demande, le resultat attendu et le canal de notification ou de resume.

Exemple :

Cree une automation quotidienne qui verifie les echecs de tests recents et produit un court rapport.

Utilisez une automation de fil lorsque la recurrence doit conserver le contexte de la conversation courante.

9. Permissions, bac a sable et depannage

9.1 Comprendre les approbations

Lorsque Codex demande une approbation, lisez l'action demandee, les fichiers ou ressources concernes, la duree de l'autorisation et le niveau de risque.

Si vous hesitez, accordez la portee la plus etroite ou refusez et demandez une autre approche.

9.2 Comprendre le bac a sable

Le bac a sable limite l'acces de Codex. Si une commande echoue par manque d'acces, choisissez entre accorder une permission ciblee, deplacer les fichiers necessaires dans le projet, demander une solution qui n'a pas besoin de cet acces ou ouvrir un projet plus adapte.

9.3 Gerer l'acces reseau

Si Codex doit vérifier une information recente ou installer une dependance, il peut avoir besoin du reseau. Accordez l'acces seulement si la tâche le justifie et si la politique du projet l'autorise.

9.4 Quand Codex ne trouve pas les bons fichiers

Donnez une indication de routage :

Lis d'abord `src/payments/` et `tests/payments/`. Ignore `legacy/` sauf si necessaire.

Si cette indication sera utile a long terme, ajoutez-la dans AGENTS.md.

9.5 Quand Codex propose trop de changements

Reformulez avec une contrainte explicite :

Reduis le changement au minimum necessaire. Pas de refactorisation hors du fichier concerne.

9.6 Quand les tests echouent

Demandez une analyse bornee :

Analyse cet echec de test. Ne modifie rien avant d'avoir identifie la cause probable.

Puis, si la cause est claire :

Applique la correction minimale et relance ce test uniquement.

9.7 Quand utiliser une autre surface

Passez a l'IDE si le contexte principal est un fichier ouvert ou une selection. Passez a la Codex App si vous devez gerer des fils, worktrees, diffs et artefacts. Passez au CLI si le travail est terminal-first ou scriptable. Passez au Cloud si la tâche doit etre deleguee a distance.

10. Scenarios courants

10.1 Comprendre une base de code inconnue

Demandez d'abord une cartographie avant toute modification :

Explique l'organisation de ce projet. Identifie les modules principaux, les commandes de verification et les fichiers a lire avant de modifier le code.
Ne modifie rien.

Si le projet est volumineux, bornez la recherche :

Concentre-toi sur le parcours d'authentification. Lis les fichiers pertinents et resume le flux de bout en bout.

Lorsque la synthese est correcte, demandez a Codex de proposer une consigne durable :

Propose une section AGENTS.md courte pour aider les prochaines sessions a trouver les bons fichiers d'authentification.

10.2 Corriger un bug avec risque faible

Commencez par la reproduction :

Reproduis ou localise l'echec signale. Ne corrige rien avant d'avoir indique la cause probable et les fichiers concernes.

Puis demandez la correction :

Applique la correction minimale pour cette cause probable. Evite toute refactorisation non necessaire. Lance le test le plus cible.

Terminez par une verification :

Resume le changement, le test lance et les risques restants.

10.3 Ajouter une petite fonctionnalite

Fournissez la definition de fini :

Ajoute le filtre "archives" a la liste des dossiers.
Le filtre doit etre visible dans l'interface, persiste dans l'URL et couvert par un test.
Respecte les patterns existants.

Si Codex propose une architecture trop large :

Garde l'implementation locale a ce module. Ne cree pas de nouvelle abstraction sauf si elle existe deja dans le projet.

10.4 Faire une revue de pull request

Dans une surface qui voit le diff, demandez :

Fais une revue de ce diff comme reviewer senior.
Liste d'abord les bugs ou regressions probables, avec fichier et ligne.
Mentionne ensuite les tests manquants.
Ne commente pas le style sauf s'il cache un risque.

Pour transformer la revue en corrections :

Corrige uniquement les points P1 et P2 de la revue. Laisse le reste intact.

10.5 Travailler sur une interface web

Demarrez le serveur local, puis demandez a Codex de vérifier :

Ouvre l'application locale dans le navigateur integre, verifie la page de connexion et corrige les problemes visibles de mise en page.
Teste desktop et mobile si possible.

Ajoutez des commentaires dans le navigateur integre si un element visuel precis doit etre corrige, puis demandez :

Traite les commentaires du navigateur et verifie a nouveau le rendu.

10.6 Produire un document ou artefact

Donnez la forme attendue :

Cree un document Markdown de reference pour ce module.
Structure : preface, public vise, concepts, API, erreurs, exemples.
Ne documente que le comportement present dans le code.

Pour un artefact bureautique :

Cree une presentation de 8 diapositives a partir de ces notes.
Ajoute une diapositive de synthese, une diapositive risques et une diapositive prochaines etapes.
Verifie le rendu avant de me donner le fichier.

10.7 Mettre en place une automation

Decrivez la recurrence et le resultat attendu :

Cree une automation hebdomadaire pour ce projet.
Chaque lundi matin, elle doit vérifier les dependances obsoletes, resumer les mises a jour importantes et ne modifier aucun fichier.

Pour un suivi dans le meme fil :

Ajoute une automation de fil qui me relance toutes les 30 minutes tant que le deploiement n'est pas termine.

10.8 Ajouter une integration externe

Lorsque l'information vit hors du depot, preferez MCP ou un plugin :

Configure ou utilise le connecteur approprie pour lire le ticket Linear lie a cette branche, puis resume les criteres d'acceptation.

Si l'outil n'est pas disponible :

Indique quelle integration manque, quelles permissions seraient necessaires et quelle information je peux te fournir manuellement.

10.9 Nettoyer apres une tâche

Avant de clore :

Verifie l'etat Git, liste les fichiers modifies et indique les commandes de test executees.
Signale tout fichier non lie a la tâche.

Si les changements doivent etre separes :

Propose un decoupage en commits logiques. Ne stage rien sans confirmation.

10.10 Ecrire une instruction durable

Apres plusieurs corrections de trajectoire, demandez :

Transforme mes corrections recurrentes en instructions AGENTS.md courtes, sans dupliquer ce qui existe deja.

Relisez la proposition avant de l'accepter. Les instructions durables doivent rester petites, specifiques et utiles aux prochaines sessions.

Sources

OpenAI Developers, Codex Overview, consulte le 12 juin 2026.
OpenAI Developers, Codex Quickstart, consulte le 12 juin 2026.
OpenAI Developers, Codex app features, consulte le 12 juin 2026.
OpenAI Developers, Codex CLI features, consulte le 12 juin 2026.
OpenAI Developers, Codex customization, consulte le 12 juin 2026.
OpenAI Developers, documentation Codex liee a sandboxing, configuration, MCP, skills et automatisation, consultee le 12 juin 2026.