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

> Codex sous toutes ses formes : terminal, extension VS Code, appli de bureau, Codex Cloud et téléphone. Installer, se connecter, mener une tâche, automatiser.

- Niveau : Amateur
- Thème : Code
- Durée : 15 minutes
- Systèmes : Mac, Windows, Linux, Navigateur, iPhone
- Disponible en France : Codex est ouvert en France avec un compte ChatGPT ou une clé d'API ; le pilotage depuis le téléphone passe par l'appli iPhone, et Codex Cloud demande un compte ChatGPT. (https://learn.chatgpt.com/docs/pricing, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/codex/

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.](https://quelleia.com/guides/codex/ou-tourne-codex.svg)

*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, Linux :

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

macOS (Homebrew) :

```bash
brew install --cask codex
```

D'après https://learn.chatgpt.com/docs/codex/cli (lue le 3 octobre 2026).

**Installer Codex**

Windows (PowerShell) :

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

D'après https://learn.chatgpt.com/docs/codex/cli (lue le 3 octobre 2026).

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

```bash
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 :

```text
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.](https://quelleia.com/guides/codex/codex-aide.webp)

*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 :

```bash
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 :

```bash
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](https://quelleia.com/guides/codex-configuration/) 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.](https://quelleia.com/guides/codex/extension-vs-code.webp)

*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](https://quelleia.com/guides/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 :

```text
É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.](https://quelleia.com/guides/codex/codex-cloud.webp)

*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.](https://quelleia.com/guides/codex/codex-mobile.webp)

*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.](https://quelleia.com/guides/codex/depot-github.webp)

*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**

1. [OpenCode](https://quelleia.com/outils/opencode/) : 87 modèles (Anomaly)
2. [Droid (Factory)](https://quelleia.com/outils/factory-droid/) : 56 modèles (Factory)
3. [Cursor](https://quelleia.com/outils/cursor/) : 55 modèles (Anysphere)
4. [Devin Desktop (ex-Windsurf)](https://quelleia.com/outils/devin-desktop/) : 41 modèles (Cognition)
5. [JetBrains AI Assistant](https://quelleia.com/outils/jetbrains-ai-assistant/) : 38 modèles (JetBrains)
6. [Warp](https://quelleia.com/outils/warp/) : 37 modèles
7. [Zed](https://quelleia.com/outils/zed/) : 31 modèles (Zed Industries)
8. [Augment Code](https://quelleia.com/outils/augment/) : 29 modèles (Augment Code)

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](https://quelleia.com/outils/)

## 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

- [Codex](https://quelleia.com/outils/codex/)
- [Classement Code des modèles de langage](https://quelleia.com/classement/code/)
- [ChatGPT](https://quelleia.com/abonnements/chatgpt/)
- [Gpt 6 2 astra](https://quelleia.com/modeles/gpt-6-2-astra/)
- [Gpt 6 2 sol](https://quelleia.com/modeles/gpt-6-2-sol/)
- [Le même modèle selon l'outil](https://quelleia.com/outils/harnais/)
- [Coder avec un agent](https://quelleia.com/logitheque/usages/code/)
- [Configurer Codex : config.toml, effort, bac à sable, approbations](https://quelleia.com/guides/codex-configuration.md) (guide, expert)
- [Installer son premier agent de code : Claude Code, Codex, Vibe](https://quelleia.com/guides/premier-agent-de-code.md) (guide, amateur)
- [Faire travailler plusieurs agents ensemble, sans casse](https://quelleia.com/guides/plusieurs-agents.md) (guide, nerd)
- [MCP : brancher des outils dans Claude, ChatGPT ou un agent](https://quelleia.com/guides/mcp.md) (guide, amateur)

## Sources

- https://learn.chatgpt.com/docs/codex/cli (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/codex/ide (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/cloud (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/mobile (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/quickstart (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/auth (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/non-interactive-mode (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/developer-commands (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/third-party/github (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/models (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/pricing (lue le 17 novembre 2026)
- https://github.com/openai/codex (lue le 17 novembre 2026)
- https://marketplace.visualstudio.com/items?itemName=openai.chatgpt (lue le 17 novembre 2026)
