Installer et mettre à jour Codex CLI : Mac, Linux, Windows

Installer la CLI OpenAI Codex tient en une commande par plateforme – curl -fsSL https://chatgpt.com/codex/install.sh | sh sur macOS et Linux, powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" sur Windows – avec npm et Homebrew comme alternatives prises en charge, et la mise à jour se fait par codex update, qui reconnaît les installations par script, npm et Homebrew et lance la montée de version propre à ce canal.¹⁴¹¹ Ce que la plupart des pages sautent vient après la première commande : laquelle des cinq voies d’installation choisir, comment épingler une version quand une sortie casse quelque chose, pourquoi le paquet winget accuse sept versions mineures de retard sur npm, et ce qu’une désinstallation laisse dans ~/.codex. Cette page est cette référence, un tableau par tâche, à jour de la v0.153.4 (4 septembre 2026).⁹

TL;DR

• L’installeur autonome est la voie qu’OpenAI met en tête, dans le README comme dans la documentation de la CLI, npm et Homebrew étant présentés comme des alternatives (« you can also install » dans la documentation de la CLI, « can also be installed via » dans le README) : le script install.sh sur macOS et Linux, le script install.ps1 sur Windows. Il télécharge le binaire compilé, donc pas besoin de Node.¹¹¹
• npm et Homebrew sont des alternatives prises en charge. npm install -g @openai/codex épingle avec une spécification de paquet ordinaire (@<version>) ; brew install --cask codex était, au moment d’écrire, sur la même 0.153.4 que npm.¹²¹⁰
• Évitez winget pour installer Codex lui-même. OpenAI publie bien le paquet OpenAI.Codex, mais les pull requests de manifeste pour 0.147.0 à 0.152.0 attendent, non fusionnées, dans microsoft/winget-pkgs depuis le 7 août 2026, si bien que la version la plus récente installable le jour d’écriture est la 0.146.1, contre 0.153.4 sur npm.³¹⁰
• codex update couvre les installations par script, npm et Homebrew (depuis la v0.128.0) : il réutilise la détection du canal d’installation que la TUI possède déjà et lance la montée de version correspondante. Une installation winget n’est pas un canal qu’il reconnaît ; celle-là se met à jour avec winget upgrade OpenAI.Codex. Les équivalents manuels pour le reste sont la relance de l’installeur, npm install -g @openai/codex@latest ou brew upgrade --cask codex.⁴¹¹
• Épinglez avec --release <version> sur install.sh, $env:CODEX_RELEASE avant la ligne install.ps1, ou @<version> sur npm. Le cask Homebrew suit une seule version courante et ne sait pas épingler.²¹²
• Désinstaller le paquet ne supprime pas votre état, mais sur une installation par script, rm -rf ~/.codex supprime aussi la CLI elle-même, parce que l’installeur range ses versions sous ~/.codex/packages/standalone.¹²

Comment installer Codex CLI ?

Quatre voies, dans l’ordre où la documentation d’OpenAI les présente,¹¹¹ plus winget sur Windows, qu’OpenAI ne documente pas :³

# Standalone installer, no Node required (macOS, Linux, WSL) -- the route OpenAI lists first
curl -fsSL https://chatgpt.com/codex/install.sh | sh

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

# npm (needs Node.js 16+; pins with a plain @version spec)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows; lags npm, see the platform section)
winget install OpenAI.Codex

Confirmez ensuite que l’installation a abouti et connectez-vous :

codex --version      # codex-cli 0.153.4
codex login          # ChatGPT account (recommended) or an API key

À la première installation par script, le bloc de profil ne prend effet que dans les nouveaux shells. Si codex est introuvable dans le terminal depuis lequel vous avez installé, lancez-y export PATH="$HOME/.local/bin:$PATH" ou ouvrez-en un nouveau ; l’installeur affiche les deux mêmes lignes en terminant (« Current terminal » et « Future terminals »).¹²

Vous préférez un binaire brut ? Chaque sortie GitHub fournit des archives par plateforme (codex-aarch64-apple-darwin.tar.gz, codex-x86_64-apple-darwin.tar.gz, codex-x86_64-unknown-linux-musl.tar.gz, codex-aarch64-unknown-linux-musl.tar.gz), et depuis la v0.106.0 le même install.sh est joint à chaque sortie comme ressource. Chaque archive contient une seule entrée dont le nom inclut la plateforme ; renommez-la en codex après extraction.¹⁵

L’installeur télécharge depuis l’infrastructure de publication hébergée par OpenAI : chatgpt.com/codex/install.sh redirige vers releases.openai.com, un changement arrivé avec la v0.146.0, GitHub Releases restant l’hôte de repli.⁶ Sur un réseau qui bloque ou bride l’hôte d’artefacts d’OpenAI mais laisse passer GitHub, récupérez le script depuis la ressource de la sortie et dites-lui d’aller chercher le binaire sur GitHub aussi :¹¹²

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

La variable va du côté sh du tube. La forme VAR=value curl ... | sh n’applique la variable qu’à curl, si bien que le script ne la voit jamais et garde silencieusement la valeur par défaut. En PowerShell, définissez $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM = 'false' avant de lancer la ligne d’installation.

Quelle voie choisir ?

Quelles plateformes Codex prend-il en charge ?

Sur Windows, Codex s’exécute nativement dans PowerShell avec un bac à sable Windows, et il existe deux modes de bac à sable. elevated est le mode préféré : il utilise des utilisateurs de bac à sable dédiés à privilèges réduits, des frontières de permissions sur le système de fichiers, des règles de pare-feu et des modifications de stratégie locale, et il exige une configuration approuvée par un administrateur. unelevated est le repli : il exécute les commandes avec un jeton Windows restreint dérivé de votre utilisateur et des frontières de système de fichiers fondées sur les ACL.⁸ Le mode se choisit dans config.toml :

[windows]
sandbox = "elevated"   # or "unelevated"

La recommandation d’OpenAI est d’utiliser le bac à sable natif par défaut et de choisir WSL quand vous avez besoin d’outils natifs Linux, quand votre flux de travail vit déjà dans WSL2, ou quand aucun des modes de bac à sable Windows natifs ne répond à vos exigences.⁸ Une distinction à garder en tête : la configuration Windows suppose que winget est présent sur la machine pour ses propres étapes de configuration ; c’est autre chose qu’installer Codex via winget. OpenAI publie bien ce paquet, le flux de publication comporte un job winget qui ouvre une pull request de manifeste dans microsoft/winget-pkgs pour les sorties stables, mais ces soumissions attendent, non fusionnées, depuis que le manifeste de la 0.146.1 a été fusionné le 7 août 2026 ; les demandes pour 0.147.0 à 0.152.0 étaient toutes encore ouvertes au moment d’écrire, et il n’en existe aucune pour 0.153.0 à 0.153.4. Rien n’est cassé dans la CLI ; c’est l’index du paquet qui est en retard.³⁸

Node.js n’est un prérequis que pour la voie npm. Les scripts d’installation téléchargent le binaire compilé, et le cask Homebrew ne déclare aucune dépendance.¹²

Comment mettre à jour Codex CLI ?

Codex ne se met pas à jour tout seul. La TUI remarque une nouvelle sortie et propose la commande de votre canal d’installation ; l’exécuter vous revient, et la commande intégrée couvre les installations par script, npm et Homebrew.⁴ La vérification au démarrage est elle-même une clé de configuration : check_for_update_on_startup = false dans config.toml, que la référence décrit ainsi : « Check for Codex updates on startup (set to false only when updates are centrally managed) » ; les flottes qui gèrent les mises à jour de façon centralisée définissent features.in_app_updates = false dans requirements.toml.¹⁶

codex --version                      # what you run now
npm view @openai/codex version       # newest published

codex update                         # built-in, v0.128.0+; detects your install channel

codex update est arrivé avec la v0.128.0 le 30 avril 2026 ; la pull request qui l’a ajouté a réutilisé la détection du canal d’installation et l’exécuteur de mise à jour que la TUI avait déjà pour ses invitations de mise à jour. La table des canaux couvre npm (plus les variantes bun, pnpm et Vite+), Homebrew et l’installeur autonome sur Unix et Windows ; une installation winget n’y figure pas, si bien qu’un Codex installé via winget ne se met à jour que par winget upgrade OpenAI.Codex.⁴ Les équivalents manuels, si vous les préférez ou si vous scriptez une image de machine :

curl -fsSL https://chatgpt.com/codex/install.sh | sh   # standalone: re-run the installer
npm install -g @openai/codex@latest                    # npm
brew upgrade --cask codex                              # Homebrew
winget upgrade OpenAI.Codex                            # winget (to whatever winget has)

irm https://chatgpt.com/codex/install.ps1 | iex           # standalone on Windows: re-run the installer

Les sorties se succèdent sur une ligne stable rapide – 0.150.0 à 0.153.4 sont sorties entre le 26 août et le 4 septembre 2026 – si bien que l’écart entre « ce que j’utilise » et « la dernière » est souvent d’une semaine, pas d’un trimestre.⁹

Comment installer une version précise ?

npm et le script d’installation épinglent tous deux par version ; Homebrew non :²¹²

npm install -g @openai/[email protected]                                          # npm: exact version
curl -fsSL https://chatgpt.com/codex/install.sh | sh -s -- --release 0.152.1  # script: --release flag
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_RELEASE=0.152.1 sh    # script: env var, on the sh side
winget install OpenAI.Codex --version 0.146.1                                 # winget: only what it has
codex --version                                                               # verify the rollback took

Attention à la position dans la forme avec variable d’environnement : CODEX_RELEASE=0.152.1 doit précéder sh, après le tube. Écrite devant curl, la variable ne s’applique qu’à curl et le script installe latest alors que vous croyez avoir épinglé.¹² Sur Windows, le script PowerShell déclare $Release = $env:CODEX_RELEASE comme unique paramètre et se rabat sur latest quand il est vide, l’épinglage est donc cette variable, définie dans la même session :¹⁷

$env:CODEX_RELEASE = '0.152.1'; irm https://chatgpt.com/codex/install.ps1 | iex

Épingler est le bon réflexe quand une sortie vous bloque : signalez le problème, épinglez la dernière version saine, avancez. Vérifiez avec codex --version après chaque épinglage, parce qu’une seconde installation ailleurs sur votre PATH continuera silencieusement à servir son propre binaire. Le script d’installation vérifie exactement cela : quand il trouve déjà sur votre PATH un codex géré par Homebrew, npm ou bun, il avertit « Multiple managed Codex installs can be ambiguous because PATH order decides which one runs » et propose de lancer pour vous la désinstallation correspondante.¹² codex doctor signale le même état après coup sous Environment.⁷

Comment désinstaller Codex CLI ?

Retirez-le par la voie qui l’a installé :

npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

Une installation par script n’a pas de gestionnaire de paquets à interroger. L’installeur place un lien symbolique codex dans ~/.local/bin (modifiable avec CODEX_INSTALL_DIR) qui pointe vers le binaire à l’intérieur de ~/.codex/packages/standalone/current (current/bin/codex dans les sorties actuelles) ; current est lui-même un lien symbolique vers ~/.codex/packages/standalone/releases/, où vit chaque version téléchargée. Sur macOS, l’installeur ajoute un second lien symbolique à côté du premier, codex-code-mode-host.¹² Retirez le tout :

rm -f ~/.local/bin/codex ~/.local/bin/codex-code-mode-host   # the second link exists on macOS installs only
rm -rf ~/.codex/packages/standalone

Si ~/.local/bin n’était pas sur votre PATH lors de l’installation, ou si l’installeur a trouvé une installation concurrente Homebrew, npm ou bun et a réécrit l’entrée, le script a aussi ajouté un bloc balisé à votre profil de shell : de # >>> Codex installer >>> à # <<< Codex installer <<< dans ~/.zprofile (zsh sur macOS), ~/.bash_profile, ~/.zshrc, ~/.bashrc ou ~/.profile. Supprimez ces trois lignes pour finir.¹²

Sur Windows, install.ps1 conserve la même disposition sous %USERPROFILE%\.codex\packages\standalone (ou %CODEX_HOME%\packages\standalone si vous avez défini cette variable) : les versions téléchargées dans releases\, une jonction current qui pointe vers celle en service. Il expose codex.exe via %LOCALAPPDATA%\Programs\OpenAI\Codex\bin (modifiable avec CODEX_INSTALL_DIR), qui est lui-même une jonction vers current\bin, et au lieu d’un bloc de profil, il écrit ce chemin bin dans votre PATH utilisateur pour les futures sessions PowerShell. Retirez d’abord le répertoire standalone, puis la jonction bin désormais pendante, puis retirez l’entrée de la variable Path utilisateur dans les Variables d’environnement :¹⁷

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\standalone"   # releases plus the current junction
cmd /c rmdir "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin"                  # the bin junction; rmdir removes the link, not a target

Les désinstallations par gestionnaire de paquets ci-dessus ne touchent pas à ~/.codex/. Le --zap de Homebrew non plus, en pratique : la seule directive zap du cask est rmdir: "~/.codex", et Homebrew n’applique rmdir: qu’aux répertoires déjà vides.² Ce répertoire contient config.toml, vos identifiants enregistrés et chaque session, ce qui explique qu’une réinstallation reprenne la connexion et l’historique là où vous les avez laissés. Ne le supprimez que si vous voulez vraiment repartir de zéro, en sachant ce que cela signifie sur une installation par script :

rm -rf ~/.codex   # discards config.toml, credentials, all sessions -- AND the CLI itself on a script install

Une réinstallation propre qui conserve votre état tient en une ligne sur npm : npm uninstall -g @openai/codex && npm install -g @openai/codex@latest. Sur la voie du script, relancer l’installeur remplace la version sous ~/.codex/packages/standalone et laisse votre configuration tranquille.¹²

Tout le cycle de vie en un tableau

Que vérifie codex doctor ?

codex doctor est la commande à lancer avant de signaler un bogue ou de déboguer une installation qui « marchait hier ». Sur la 0.153.4, il rassemble sept sections dans un seul rapport – Notes, Environment (cohérence du runtime et de l’installation), Configuration (état de chargement de config.toml, authentification, MCP, stratégie de bac à sable), Desktop App (ajoutée en v0.149.0), Updates, Connectivity et Background Server – avec --summary pour une vue compacte, --json pour une forme lisible par machine et expurgée, --all pour déplier les listes tronquées et --no-color pour les journaux ; codex doctor --help liste aussi --ascii sur la 0.153.4.⁷¹³¹⁵ La plupart des signalements « Codex est cassé » se résolvent en quelque chose qu’il nomme dès le premier écran : un mode d’authentification périmé, un config.toml qui n’a pas pu être analysé, ou une seconde installation qui masque celle de votre PATH. La décomposition complète, section par section, est dans le guide.

Ce qui change après l’installation

La première chose sur laquelle une installation fraîche trébuche n’est pas le binaire. Depuis la v0.149.0, la CLI refuse de démarrer avec approval_policy = "untrusted", si bien qu’un config.toml copié depuis une machine plus ancienne a besoin d’une modification.¹³ Vous venez de Claude Code ? Le billet de migration met les deux configurations côte à côte, et le billet sur les hooks explique ce que Codex exécute autour du modèle. Le guide Codex CLI est la référence complète : modes de bac à sable et d’approbation, AGENTS.md, MCP, skills et tâches dans le cloud. Et si vous utilisez les deux outils, la page d’installation de Claude Code est la jumelle de celle-ci.

Questions fréquentes

Comment mettre à jour Codex CLI vers la dernière version ?

Lancez codex update (depuis la v0.128.0) ; il détecte si vous avez installé via le script, npm ou Homebrew et lance la montée de version de ce canal. Les équivalents manuels sont la relance du script d’installation, npm install -g @openai/codex@latest ou brew upgrade --cask codex. Une installation winget n’est pas un canal que codex update reconnaît ; utilisez winget upgrade OpenAI.Codex pour celle-là.

Codex CLI se met-il à jour automatiquement ?

Non. La TUI vérifie s’il existe une sortie plus récente et propose la commande de mise à jour correspondant à votre canal d’installation, et codex update (depuis la v0.128.0) l’exécute ; rien n’est téléchargé ni appliqué tant que vous ne le faites pas.

Comment désinstaller Codex CLI ?

Utilisez la voie qui l’a installé : npm uninstall -g @openai/codex, brew uninstall --cask codex ou winget uninstall OpenAI.Codex. Pour une installation par script, retirez le lien symbolique ~/.local/bin/codex (et ~/.local/bin/codex-code-mode-host sur macOS) ainsi que le répertoire ~/.codex/packages/standalone. Sur Windows, l’installation par script se compose de %USERPROFILE%\.codex\packages\standalone, de la jonction %LOCALAPPDATA%\Programs\OpenAI\Codex\bin et d’une entrée dans votre PATH utilisateur ; retirez les trois. Votre configuration, vos identifiants et vos sessions restent dans ~/.codex/ jusqu’à ce que vous supprimiez vous-même le reste de ce répertoire.

Comment installer Codex CLI sur Windows ?

Lancez powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". La CLI s’exécute nativement dans PowerShell avec un bac à sable Windows (elevated de préférence, unelevated en repli) ; WSL2 est une option si vous avez besoin d’outils Linux ou si aucun des modes de bac à sable ne convient, pas un prérequis. Windows 11 est la base recommandée. winget install OpenAI.Codex fonctionne aussi, mais avec du retard sur la ligne stable.

Faut-il Node.js pour installer Codex ?

Seulement pour la voie npm, et le paquet exige Node 16 ou plus récent. Le script d’installation, le script PowerShell et le cask Homebrew fournissent tous le binaire codex compilé, si bien qu’une machine sans Node peut exécuter Codex.

Comment savoir quelle version de Codex j’ai ?

codex --version l’affiche (par exemple codex-cli 0.153.4). npm view @openai/codex version montre la dernière version publiée, et codex doctor indique le chemin d’installation et si une autre copie sur votre PATH la masque.