Installer Codex CLI et exécuter sa première tâche

Codex CLI est un agent de programmation en ligne de commande développé par OpenAI et écrit en Rust. Il s’exécute localement, travaille avec le code de votre dépôt et effectue les tâches dans un environnement isolé. Vous pouvez l’installer avec l’installateur autonome, npm, le cask Homebrew ou un binaire publié dans GitHub Releases.

Après l’installation, gardez les deux modes de connexion bien séparés : l’authentification officielle OpenAI via ChatGPT ou une clé API OpenAI, et un fournisseur personnalisé utilisant votre propre clé API. Les deux emploient la même commande codex ; aucun client supplémentaire n’est nécessaire.

Prérequis

Configuration minimale indiquée dans le guide d’installation officiel :

• macOS : version 12 (Monterey) ou ultérieure.
• Linux : Ubuntu 20.04+ / Debian 10+.
• Windows : Windows 11 via WSL2 ; l’exécution native sous Windows possède sa propre documentation.

Node.js n’est requis que pour une installation avec npm. L’installateur autonome, le cask Homebrew et l’archive GitHub Releases fournissent un exécutable prêt à l’emploi.

La connexion officielle avec ChatGPT nécessite un compte ChatGPT ; l’accès officiel à l’API nécessite une clé obtenue sur platform.openai.com. Pour un fournisseur personnalisé, il vous faut votre propre compte BetterToken, une clé API et un Model ID à jour. Node.js n’est nécessaire que pour installer Codex avec npm ou utiliser le script automatique de configuration du fournisseur.

Installer Codex CLI

macOS et Linux — installateur autonome

C’est la méthode la plus simple, sans Node.js :

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

Une fois l’installation terminée, vérifiez la commande :

codex --version

Si un numéro de version s’affiche, la commande est disponible.

Codex est installé ? Connectez votre clé API en suivant le guide à jour. Consultez d’abord les Docs actuelles, puis créez un compte BetterToken si vous ne possédez pas encore votre propre clé.

macOS — cask Homebrew

brew install --cask codex

npm — macOS, Linux et Windows

Cette méthode nécessite Node.js et un npm fonctionnel. Vérifiez la version minimale de Node.js dans le champ engines du paquet sur npmjs.com/@openai/codex.

npm install -g @openai/codex

Si la commande codex reste introuvable après l’installation, le répertoire global de npm n’est pas dans votre PATH. Identifiez le chemin correct :

npm config get prefix

Comparez ce répertoire au PATH de votre shell, puis redémarrez le terminal. N’ajoutez pas /bin au hasard : l’organisation des exécutables globaux dépend du système et de la méthode d’installation de Node.js.

Linux — binaire depuis GitHub Releases

Des archives Linux prêtes à l’emploi sont disponibles sur github.com/openai/codex/releases :

• codex-x86_64-unknown-linux-musl.tar.gz — pour x86_64
• codex-aarch64-unknown-linux-musl.tar.gz — pour arm64

Extrayez l’archive, renommez l’exécutable en codex et placez-le dans un répertoire accessible en écriture qui figure dans votre PATH.

Windows

Codex CLI fonctionne nativement sous Windows ou dans WSL2. La documentation Windows actuelle recommande Windows 11 pour un usage natif ; une version de Windows 10 entièrement mise à jour est prise en charge au mieux.

Windows natif (PowerShell). Installateur officiel :

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

En mode natif, Codex isole l’exécution des tâches à l’aide de Windows Sandbox. Le mode se règle dans ~/.codex/config.toml :

[windows]
sandbox = "elevated"

• "elevated" : recommandé ; utilise un utilisateur de sandbox dédié et des règles de pare-feu.
• "unelevated" : applique des restrictions ACL à l’utilisateur courant, sans utilisateur de sandbox dédié.

WSL2. Installez la version Linux de Codex CLI dans WSL2 en suivant les instructions Linux. Pour les outils Linux, OpenAI recommande de conserver le projet dans le système de fichiers WSL plutôt que sous /mnt/.

Connecter le même Codex CLI à l’API BetterToken

BetterToken ne remplace pas Codex CLI par une autre application. L’exécutable officiel codex continue de fonctionner, tandis qu’un fournisseur personnalisé est sélectionné dans ~/.codex/config.toml. Les requêtes Codex utilisent OpenAI Responses via la Base URL `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk

Étape 1 — créer son compte et sa clé

Créez votre propre compte BetterToken et une clé API dédiée. N’utilisez ni une clé partagée ni une clé copiée dans un article, une capture d’écran ou une commande.

Étape 2 — relever la configuration actuelle

Ouvrez le guide BetterToken actuel pour Codex, choisissez la surface utilisée et copiez le Model ID et les champs du fournisseur qui y sont affichés. Arrêtez complètement Codex avant de modifier la configuration. Le Model ID et les champs d’authentification sont dynamiques : ne les déduisez pas d’un ancien exemple.

Étape 3 — nettoyer, appliquer, redémarrer et vérifier

Supprimez d’abord les anciennes variables OpenAI susceptibles de remplacer config.toml.

macOS et Linux :

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Windows PowerShell :

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")

Configuration automatique du fournisseur BetterToken

Le script configure uniquement le fournisseur BetterToken ; il n’installe pas Codex CLI. Il nécessite Node.js. Si aucune clé API ni aucun modèle n’est passé en argument, il les demande dans un terminal interactif : ne placez donc pas le secret dans la ligne de commande.

macOS et Linux :

curl -fsSL https://www.bettertoken.ai/install-codex-provider.sh?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk | bash

Windows PowerShell :

iwr https://www.bettertoken.ai/install-codex-provider.ps1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Les champs d’authentification et le stockage des identifiants varient selon la surface Codex et la version du client. Cet article ne fige donc pas de booléens d’authentification précis et ne mélange pas la connexion officielle et un fournisseur personnalisé dans un même exemple de configuration.

Appliquez uniquement les champs indiqués dans les Docs actuelles, transmettez le secret selon la méthode documentée, puis redémarrez complètement Codex. Lancez ensuite une petite tâche en lecture seule et vérifiez dans le Dashboard BetterToken que la nouvelle requête, le modèle et l’utilisation des tokens d’entrée, de sortie et de cache apparaissent dans l’historique.

Authentification officielle OpenAI

Les commandes suivantes concernent la connexion officielle OpenAI. Avec le fournisseur personnalisé BetterToken, codex login status ne vérifie pas l’API BetterToken : lancez plutôt une tâche de test et contrôlez sa réponse.

Connexion via ChatGPT

Exécutez :

codex login

Un navigateur s’ouvre ; terminez la connexion avec votre compte ChatGPT. Codex enregistre la session localement, ce qui évite de vous reconnecter lors des lancements suivants.

Si vous exécutez codex sans argument avant l’authentification, l’interface vous proposera également de vous connecter. La commande principale pour lancer la connexion reste codex login.

Connexion avec une clé API

Ne transmettez pas la clé comme argument et ne l’affichez pas avec echo : sa valeur serait enregistrée dans l’historique du shell.

Définissez OPENAI_API_KEY dans l’environnement courant ou avec un gestionnaire de secrets. Ne placez sa valeur ni dans l’article, ni dans la commande, ni dans la sortie. Une fois la variable définie, transmettez-la via stdin :

printenv OPENAI_API_KEY | codex login --with-api-key

La valeur de la clé ne s’affiche pas et n’entre pas dans l’historique des commandes.

Vérifier l’authentification

Après la connexion, vérifiez l’état :

codex login status

La commande affiche le mode d’authentification actuel ou indique que vous n’êtes pas connecté.

Si aucune authentification n’est active, recommencez avec la méthode appropriée.

Pour vous déconnecter et supprimer les identifiants enregistrés :

codex logout

Le fichier ~/.codex/auth.json contient le jeton d’accès : traitez-le comme un mot de passe. Ne le supprimez pas manuellement ; utilisez toujours codex logout.

Documentation sur l’authentification : developers.openai.com/codex/auth. Référence des sous-commandes et options de connexion : developers.openai.com/codex/cli/reference.

Première tâche dans un dépôt de test

Commencez dans un dépôt de test pour ne pas affecter votre code de travail. Clonez n’importe quel dépôt public, par exemple Codex lui-même :

git clone https://github.com/openai/codex codex-test
cd codex-test

Lancez une tâche en lecture seule :

codex --sandbox read-only "Explain the entry point of this project"

L’option --sandbox read-only limite les commandes générées par le modèle à la lecture. Si Codex décrit correctement la structure sans modifier de fichier, le premier lancement est terminé.

Pour continuer dans la TUI avec la même restriction :

codex --sandbox read-only

Saisissez dans l’interface : What files are in this project and what does each do?

Si vous utilisez la connexion officielle OpenAI, vérifiez que l’authentification est toujours active :

codex login status

Avec le fournisseur BetterToken, une réponse normale confirme la connexion. Vous pouvez aussi ouvrir le Dashboard BetterToken et vérifier que la requête, le modèle et l’utilisation des tokens d’entrée, de sortie et de cache apparaissent dans l’historique.

Dépannage

codex: command not found après une installation npm

Exécutez npm config get prefix, comparez le résultat avec PATH et redémarrez le terminal. Le chemin exact de l’exécutable dépend du système et du mode d’installation de Node.js ; n’ajoutez donc pas /bin au hasard.

Le navigateur ne s’ouvre pas lors de la connexion via ChatGPT

Sur un serveur distant sans interface graphique, essayez d’abord le flux officiel par code d’appareil (bêta) :

codex login --device-auth

Vous devez d’abord l’activer dans les paramètres de sécurité ChatGPT ou dans les autorisations du Workspace. S’il est indisponible, utilisez la connexion par clé API :

printenv OPENAI_API_KEY | codex login --with-api-key

Le guide d’authentification officiel décrit le callback, le code d’appareil et les solutions de repli.

Codex ne répond pas après la connexion à BetterToken

Vérifiez cinq éléments : base_url vaut https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-044&utm_content=ustanovit-codex-cli-pervyy-zapusk wire_apiresteresponses, le Model ID, les champs du fournisseur et l’authentification correspondent au guide actuel de la surface choisie, et d’anciennes variables OPENAI_API_KEYouOPENAI_BASE_URLne remplacent pas la configuration. Après avoir modifiéconfig.toml`, fermez complètement Codex et relancez-le dans un nouveau terminal.

codex login status affiche Not logged in

• Connexion ChatGPT : exécutez de nouveau codex login et terminez la connexion dans le navigateur.
• Connexion par clé API : vérifiez que OPENAI_API_KEY est définie dans l’environnement de travail, puis relancez printenv OPENAI_API_KEY | codex login --with-api-key.
• Ne supprimez pas ~/.codex/auth.json manuellement : utilisez codex logout.

---

Documentation Codex CLI : developers.openai.com/codex/cli. Connecter le même Codex CLI à l’API BetterToken : docs.bettertoken.ai/en/ai-tools/codex.