Codex : agent de code OpenAI en local dans le terminal

Codex CLI est un agent de code développé par OpenAI, qui tourne en local sur ton ordinateur, directement dans le terminal. Il s’installe en une commande (curl, PowerShell, npm ou Homebrew) et se connecte avec un compte ChatGPT. Le même projet existe aussi dans l’éditeur de code, en application de bureau et dans le cloud.

En bref

• Codex CLI est l’agent de code d’OpenAI, exécuté en local dans le terminal
• Installation par une ligne curl (Mac, Linux), une ligne PowerShell (Windows), npm ou Homebrew
• Connexion avec un compte ChatGPT (Plus, Pro, Business, Edu, Enterprise) ou avec une clé d’API
• Code écrit à 97 % en Rust, sous licence Apache-2.0
• Versions pour VS Code, Cursor et Windsurf, application de bureau et version cloud

Qu’est-ce que Codex CLI ?

Codex CLI est un agent de code publié par OpenAI. Le README le décrit comme un agent qui s’exécute localement sur ton ordinateur, et le dépôt GitHub le résume en une formule : un agent de code léger qui tourne dans ton terminal.

Le terme « CLI » désigne l’usage en ligne de commande : tu lances le programme depuis une fenêtre de terminal, sans passer par une interface graphique. Le projet est distribué sous licence Apache-2.0.

Comment fonctionne Codex en local

Une fois installé, il suffit de taper codex dans le terminal pour démarrer. La documentation d’installation parle d’une interface en mode texte, appelée TUI, qui s’ouvre dans la fenêtre du terminal. On peut aussi lui passer une demande directement, par exemple « explain this codebase to me », l’exemple utilisé dans la documentation pour essayer une version compilée à la main.

Il existe aussi un mode non interactif, accessible avec codex exec. Dans ce mode, les messages s’affichent directement dans le terminal et le niveau de journalisation par défaut est réglé sur les erreurs.

Pour comprendre ce qui se passe en cas de souci, la documentation indique que Codex respecte la variable d’environnement RUST_LOG. Elle donne aussi la commande codex -c log_dir=./.codex-log, qui active un journal en texte brut pour une session.

codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.log

Installer Codex CLI

Le README propose un installateur par système. Sur Mac et Linux, une ligne curl suffit. Sur Windows, la commande passe par PowerShell.

Ces installateurs téléchargent le programme depuis le site de publication d’OpenAI et se rabattent sur les publications GitHub si le téléchargement échoue. Pour forcer GitHub, il faut définir la variable CODEX_INSTALLER_USE_RELEASES_OPENAI_COM à false. Les valeurs 0 et no sont acceptées aussi.

Deux gestionnaires de paquets sont également prévus, npm et Homebrew. Dans tous les cas, tu lances ensuite codex pour commencer.

curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm install -g @openai/codex
brew install --cask codex
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

Se connecter avec ChatGPT ou une clé d’API

Au premier lancement de codex, il faut choisir Sign in with ChatGPT. OpenAI recommande cette option pour utiliser Codex dans le cadre d’un abonnement Plus, Pro, Business, Edu ou Enterprise. Le README renvoie vers une page d’aide d’OpenAI pour le détail de ce que chaque offre comprend, et n’indique lui-même aucun prix.

Une autre voie existe : utiliser une clé d’API, c’est-à-dire un identifiant secret qui donne accès au service. Le README précise que cette option demande une configuration supplémentaire, décrite dans la documentation d’authentification d’OpenAI.

Codex dans l’éditeur, en application ou dans le cloud

Le terminal n’est pas la seule porte d’entrée. Pour utiliser Codex dans un éditeur de code, le README cite VS Code, Cursor et Windsurf, avec une extension à installer dans l’éditeur.

Si tu préfères une application de bureau, la commande codex app ou la page dédiée de Codex permet d’y accéder. Enfin, l’agent hébergé par OpenAI, appelé Codex Web, est un produit distinct : il fonctionne dans le cloud, sur le site de ChatGPT, et non sur ta machine.

Où en est le projet Codex

Le dépôt a été créé le 13 avril 2025. Au relevé du 4 octobre 2026, il compte 127 785 étoiles, 20 009 copies (forks) et 647 contributeurs. Il affiche aussi 20 471 tickets et demandes de fusion ouverts, et son code a été modifié pour la dernière fois ce même jour. Le code est écrit à 97 % en Rust et à 2 % en Python.

Côté versions, trois préversions de la série 0.162.0 sont parues les 3 et 4 octobre 2026, dont la plus récente est la 0.162.0-alpha.12. Leurs notes de version ne détaillent aucun changement, donc rien ne permet ici de dire ce qu’elles apportent.

Ce qu’il faut savoir avant d’installer Codex

La documentation d’installation indique les systèmes pris en charge : macOS 12 ou plus récent, Ubuntu 20.04 ou plus récent, Debian 10 ou plus récent, et Windows 11 via WSL2. Il faut 4 Go de mémoire vive au minimum, 8 Go recommandés. Git 2.23 ou plus est optionnel, mais conseillé pour les aides intégrées aux demandes de fusion (pull requests). Le README propose par ailleurs une commande PowerShell pour Windows, sans reprendre cette mention de WSL2.

Les publications GitHub proposent des archives pour macOS (Apple Silicon et Intel) et pour Linux (x86_64 et arm64). Le projet fournit aussi un fichier DotSlash, qui permet à toute une équipe de se caler sur la même version de l’exécutable, quelle que soit sa plateforme. Pour compiler à partir des sources, la documentation passe par la chaîne d’outils Rust et la commande cargo build.

Quelques repères

• Terminal : Fenêtre dans laquelle on pilote l’ordinateur en tapant des commandes écrites, au lieu de cliquer sur des boutons. Les développeurs s’en servent pour installer des outils et lancer des programmes.
• Clé d’API : Chaîne de caractères secrète qui identifie un utilisateur auprès d’un service en ligne. Elle permet à un programme d’utiliser ce service sans passer par un compte saisi à la main.

Questions fréquentes

Codex CLI est-il gratuit ?

Le code de Codex CLI est publié sous licence Apache-2.0, mais son usage passe par un compte ChatGPT (offres Plus, Pro, Business, Edu ou Enterprise) ou par une clé d’API. Le README ne donne aucun prix et renvoie vers une page d’aide d’OpenAI.

Comment installer Codex CLI sur Mac, Linux ou Windows ?

Sur Mac et Linux, une ligne curl suffit, et sur Windows une commande PowerShell. Codex est aussi disponible via npm install -g @openai/codex ou brew install --cask codex, puis on lance codex.

Peut-on utiliser Codex dans VS Code, Cursor ou Windsurf ?

Oui. Le README indique que Codex s’installe aussi dans l’éditeur, et cite VS Code, Cursor et Windsurf. Une application de bureau existe via codex app.

Codex CLI fonctionne-t-il sur ma machine ou dans le cloud ?

Codex CLI s’exécute en local sur ton ordinateur. La version cloud s’appelle Codex Web, c’est un produit distinct d’OpenAI qui s’utilise depuis le site de ChatGPT.

À retenir

Codex CLI est l’agent de code d’OpenAI en ligne de commande, sous licence Apache-2.0, qui s’installe en une commande et s’utilise avec un compte ChatGPT ou une clé d’API. Le projet est très actif sur GitHub, mais le README ne donne ni prix ni détail sur les dernières préversions.