Aller au contenu
EN 4 QUESTIONSTrouver mon modèle
Code · guide amateur · 15 min de lecture

Codex, l'agent de code d'OpenAI : terminal, éditeur, appli, nuage

Codex lit un projet, modifie des fichiers, lance des commandes et relit des demandes de fusion. Il existe en terminal, dans l'éditeur, dans l'appli ChatGPT et dans le nuage : ce guide dit lequel choisir et comment s'en servir.

Disponible en France

Illustration du dossier OpenAI

Codex est l’agent de code d’OpenAI. On lui décrit une tâche (corriger un bogue, ajouter une fonction, expliquer un projet) et il lit les fichiers, les modifie, lance les commandes et les tests, puis rend des changements à relire. Le même agent existe sous cinq formes qui partagent les modèles, l’enveloppe d’usage et, sur l’ordinateur, le même fichier de réglages.

Les formes de Codex en novembre 2026 : sur votre ordinateur (terminal, éditeur, appli de bureau), dans le nuage d'OpenAI, et le téléphone pour suivre. D'après la documentation de Codex lue le 17 novembre 2026.

Quelle forme choisir

Forme Où Pour quoi
Ligne de commande (codex) terminal, macOS, Linux, Windows travailler dans un dépôt local, scripter, intégration continue
Extension d’éditeur VS Code, Cursor, Windsurf ; Xcode et JetBrains ont leur propre intégration modifier le code ouvert, relire le diff à côté du fichier
Codex dans l’appli ChatGPT appli de bureau Mac, Windows, Linux plusieurs projets en parallèle, navigateur, Computer Use, plugins
Codex Cloud nuage d’OpenAI, depuis le web, l’appli ou le téléphone tâche longue qui continue sans votre ordinateur
Téléphone appli ChatGPT pour iPhone suivre, approuver une commande, relire un diff

Connecté avec un compte ChatGPT, Codex puise dans votre formule ; connecté avec une clé d’API, il est facturé au tarif de l’API et perd les fonctions du nuage (revue de code sur GitHub, Slack, Codex Cloud). Avec Free et Go, Codex se limite à l’appli de bureau et à GPT-6 Luna, selon la page de prix ; Plus ouvre le web, le terminal, l’éditeur et l’iPhone.

Installer la ligne de commande

Installer Codex

macOS et Linux · macOS, Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Homebrew · macOS (Homebrew)

brew install --cask codex

D'après learn.chatgpt.com, lue le 3 octobre 2026.La fiche de Codex →

Installer Codex

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

D'après learn.chatgpt.com, lue le 3 octobre 2026.La fiche de Codex →

Sous Linux, la même commande que sur Mac fonctionne ; npm et Homebrew sont aussi proposés :

curl -fsSL https://chatgpt.com/codex/install.sh | sh
# ou
npm install -g @openai/codex

Pour mettre à jour, relancez la même commande, ou tapez codex update.

  1. Ouvrez un terminal dans le dossier du projet et tapez codex.
  2. La première fois, choisissez Sign in with ChatGPT : le navigateur s’ouvre pour la connexion. Pour une clé d’API, passez-la par l’entrée standard plutôt que de la taper en clair : printenv OPENAI_API_KEY | codex login --with-api-key. La commande codex login status dit quelle méthode est active.
  3. Faites un point Git avant de commencer (git commit ou au moins git stash) : OpenAI conseille un point de retour avant et après chaque tâche.
  4. Écrivez votre première demande, par exemple :
Explique-moi ce projet : à quoi il sert, comment il est organisé et comment on lance ses tests.
Terminal : codex --version répond codex-cli 0.166.0, puis codex --help liste les commandes agents, exec, review, login, logout, mcp, plugin, app-server, completion, update, doctor, sandbox, apply, resume et d'autres.
Sortie réelle de codex --version et codex --help sur le mini-PC Linux de QUELLE IA, le 17 novembre 2026. La version installée, 0.166.0, est plus ancienne que la dernière publiée sur GitHub (0.169.0, le 13 novembre 2026).

Les commandes à connaître

Dans une session, une barre oblique ouvre les commandes. Les plus utiles :

Commande Ce qu’elle fait
/model changer de modèle et d’effort de réflexion
/permissions passer en lecture seule ou rendre la main à l’agent
/plan faire d’abord un plan, sans toucher aux fichiers
/diff voir les changements faits par Codex
/review relire les changements en cours ou les comparer à une branche
/init créer un fichier AGENTS.md de consignes pour le projet
/status voir le modèle, les dossiers accessibles et le réglage actif
/compact résumer la conversation pour libérer du contexte
/new, /resume nouvelle conversation, ou reprise d’une ancienne
/mcp, /plugins serveurs MCP et plugins branchés

Pour choisir le modèle au lancement :

codex --model gpt-6.2-sol
codex -m gpt-6.2-astra "Trouve pourquoi le paiement échoue entre l'API et le service de facturation, corrige et lance les tests concernés."

OpenAI conseille GPT-6.2 Astra pour suivre un bogue à travers plusieurs services, et GPT-6.2 Sol pour relire une demande de fusion ou corriger après une relecture. GPT-6.2 Sol garde par défaut 500 000 jetons de contexte dans Codex, contre 272 000 pour Astra.

Automatiser avec codex exec

codex exec lance une tâche sans conversation, pour un script ou une chaîne d’intégration continue :

codex exec "Résume la structure du dépôt et liste les cinq zones les plus risquées"
codex exec "Rédige les notes de version des dix derniers commits" | tee notes-de-version.md
codex exec --json "Résume la structure du dépôt" | jq

Dans une chaîne d’intégration, la clé passe par une variable d’environnement (CODEX_API_KEY) que la plateforme garde secrète. Le guide Configurer Codex explique comment limiter ce qu’une tâche automatique peut faire.

Dans l’éditeur

  1. Installez l’extension Codex d’OpenAI depuis la boutique de votre éditeur (identifiant openai.chatgpt), dans VS Code, Cursor ou Windsurf.
  2. Cliquez sur l’icône Codex. Si elle n’apparaît pas, ouvrez la palette de commandes et lancez Codex: Open Codex Sidebar.
  3. Connectez-vous, ouvrez un fichier ou sélectionnez du code, puis posez votre demande : le fichier ouvert et la sélection servent de contexte.
  4. Relisez le résumé et le diff à côté du code, gardez ce qui vous convient, et poursuivez dans la même conversation.
Page Visual Studio Marketplace de l'extension Codex, OpenAI's coding agent, éditée par OpenAI, gratuite, avec la commande ext install openai.chatgpt.
L'extension Codex d'OpenAI sur la boutique de Visual Studio Code, le 17 novembre 2026, avec sa commande d'installation (capture marketplace.visualstudio.com).

Dans Xcode, ouvrez l’assistant de code et choisissez Codex comme agent ; dans les IDE de JetBrains, ouvrez AI Chat et choisissez Codex. L’extension partage les réglages de la ligne de commande, mais n’accepte pas les plugins.

Dans l’appli de bureau ChatGPT

Dans l’appli ChatGPT, choisissez Codex dans le menu ChatGPT, puis New chat, et ouvrez le dossier du projet. L’appli ajoute le travail sur plusieurs projets en parallèle, le navigateur intégré pour vérifier une page, Computer Use, les plugins et les tâches programmées. Le guide ChatGPT Work et navigateur détaille ces outils.

Dans le nuage

  1. Sur chatgpt.com ou dans l’appli, lancez une conversation et choisissez Work in > Cloud. Sur téléphone, ouvrez Codex.
  2. Choisissez un environnement. L’environnement par défaut, quand il existe, permet de partir sans dépôt ; un environnement publié reprend des dépôts et des outils déjà préparés.
  3. Envoyez la tâche. Elle tourne dans son propre espace de travail et continue si votre ordinateur s’endort.
  4. Relisez les fichiers modifiés et les résultats des tests, demandez des corrections, puis faites un commit ou ouvrez une demande de fusion.

Pour un premier essai sans dépôt, la documentation propose :

Écris un script Python qui trouve les fichiers en double par leur contenu. Teste-le sur des fichiers d'exemple.
Page Codex Cloud de ChatGPT Learn : Run coding tasks in the cloud, avec une illustration d'un environnement publié à côté d'une zone de saisie.
La page « Codex Cloud » de la documentation, le 17 novembre 2026 : une tâche par espace de travail isolé, qui continue quand l'ordinateur dort (capture learn.chatgpt.com).

Sur GitHub, une fois le dépôt relié, un commentaire @codex review dans une demande de fusion déclenche une relecture ; la relecture automatique s’allume dans les réglages de Codex, dépôt par dépôt (Automatic review sous Review code). La même mention existe pour GitLab.

Depuis le téléphone

  1. Sur l’ordinateur, dans l’appli ChatGPT, ouvrez Settings > Connections > Control this Mac or PC, puis Set up ou Add.
  2. Scannez le code QR avec le téléphone, connectez-vous au même compte et approuvez la connexion. Ne reliez que des appareils qui vous appartiennent.
  3. Dans l’appli ChatGPT pour iPhone, ouvrez Codex, choisissez l’ordinateur relié ou le nuage, et lancez ou reprenez une tâche. Laissez l’ordinateur allumé.
Page Codex on mobile de ChatGPT Learn : Start, guide, and review tasks from your phone, avec une illustration de l'appli ChatGPT sur téléphone montrant le nuage et des ordinateurs reliés.
La page « Codex on mobile », le 17 novembre 2026 : suivre, approuver et relire une tâche depuis le téléphone (capture learn.chatgpt.com).

L’open source

Le code de la ligne de commande est publié sur GitHub sous licence Apache 2.0. On y suit les versions, souvent plusieurs par semaine, et on peut y signaler un problème.

Page GitHub openai/codex : liste des dossiers codex-cli, codex-rs, docs, sdk, encadré About « Lightweight coding agent that runs in your terminal », licence Apache-2.0, dernière version 0.169.0.
Le dépôt open source de Codex sur GitHub, le 17 novembre 2026 : licence Apache 2.0 et version 0.169.0 publiée le 13 novembre (capture github.com).

Codex fait partie des outils suivis par QUELLE IA ; le tableau ci-dessous montre ceux qui proposent le plus de modèles, et la fiche de l’outil liste les siens.

Les outils de code suivis

Nombre de modèles classés sur QUELLE IA que chaque outil propose, d'après sa propre liste, relevée au plus tard le 16 novembre 2026.

Les 25 outils de code et agents →

Précautions

  • Relisez chaque changement avant de le garder : /diff dans le terminal, le diff à côté du code dans l’éditeur.
  • Travaillez dans un dossier suivi par Git. Codex y démarre en mode Auto (il écrit dans le dossier et demande avant de sortir) ; hors Git, il démarre en lecture seule.
  • Méfiez-vous d’un dépôt cloné inconnu. Ses consignes (AGENTS.md), ses réglages de projet et ses serveurs MCP peuvent orienter l’agent. Codex ignore les réglages d’un projet marqué non fiable.
  • Gardez la clé d’API hors du code et des fichiers partagés.

Pour aller plus loin

Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.

Tous les guides →

Sources

  1. learn.chatgpt.com, lue le
  2. learn.chatgpt.com, lue le
  3. learn.chatgpt.com, lue le
  4. learn.chatgpt.com, lue le
  5. learn.chatgpt.com, lue le
  6. learn.chatgpt.com, lue le
  7. learn.chatgpt.com, lue le
  8. learn.chatgpt.com, lue le
  9. learn.chatgpt.com, lue le
  10. learn.chatgpt.com, lue le
  11. learn.chatgpt.com, lue le
  12. github.com, lue le
  13. marketplace.visualstudio.com, lue le