Codex CLI
Présentation du projet
Codex CLI est un agent de codage d'OpenAI qui s'exécute localement sur votre ordinateur.
Codex CLI est un agent de codage d'OpenAI qui s'exécute localement sur votre ordinateur.
- Page d'accueil officielle: https://chatgpt.com/codex
- Page d'accueil du projet: https://github.com/openai/codex
- Méthode d'installation: voir le tutoriel ci-dessous sur cette page
Démonstration

Caractéristiques
| Catégorie de fonction | Fonctionnalité |
|---|---|
| Assistant de codage basé sur un terminal | Codex CLI est un assistant de codage interactif basé sur un terminal utilisé pour éditer du code, générer des correctifs et exécuter des commandes dans la ligne de commande. |
| Architecture pilotée par outils | Fournit des outils tels que apply_patch, shell, update_plan et multi_tool_use pour des modifications contrôlées des fichiers et des opérations du référentiel. |
| Édition de correctifs atomiques | Utilise un format de correctif spécialisé pour ajouter/mettre à jour/supprimer des fichiers de manière atomique via apply_patch, facilitant ainsi l'audit et la restauration. |
| Sandboxing et approbation | Prend en charge les politiques de sandboxing (par exemple, workspace-write, read-only) et les modes d'approbation (untrusted, on-request, never) pour contrôler les autorisations d'écriture et d'accès au réseau. |
| Suivi des plans | update_plan est utilisé pour répertorier les étapes et suivre l'état, ne nécessitant qu'une seule étape in_progress à tout moment pour maintenir une progression claire. |
| Lignes directrices sur les interactions | Envoie de brèves explications introductives avant les opérations importantes, en gardant un ton amical et concis et en fournissant des mises à jour sur les progrès. |
| Contraintes de sécurité | Adhère à des règles strictes (pas de modifications arbitraires de fichiers non liés, pas d'ajout d'en-têtes de droits d'auteur, pas d'exécution de commandes destructrices), exigeant l'approbation de l'utilisateur pour les opérations sensibles. |
| Test et formatage | Il est recommandé d'exécuter des tests et des outils de formatage pertinents après modification, mais n'est pas responsable de la résolution des problèmes sans rapport avec la tâche en cours. |
| Sortie et style | La sortie finale adhère aux spécifications de rendu CLI (par exemple, ** en-têtes, backticks pour les chemins/commandes), en conservant une structure numérisable et concise. |
| Exécution parallèle | Prend en charge l'exécution de plusieurs outils en parallèle via multi_tool_use.parallel pour améliorer l'efficacité. |
Méthode de configuration du modèle IA
Guide graphique Windows
1. Ouvrez le terminal

2. Installer WSL
Codex fonctionne désormais nativement sous Windows : vous pouvez l'installer directement dans PowerShell avec powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" (ou npm i -g @openai/codex si Node.js est déjà installé), le configurer avec la version PowerShell du script de l'étape 4, puis lancer codex directement dans PowerShell. Si vous avez besoin d'outils Linux, utilisez WSL2 comme décrit ci-dessous (dans ce cas, Codex et le script de configuration doivent tous deux s'exécuter dans WSL ; voir l'étape 4).
Installer WSL2, redémarrer l'ordinateur Windows
wsl --install Redémarrez l'ordinateur Windows après l'installation
Remarques Windows
- Il est recommandé d'utiliser PowerShell plutôt que CMD
- Si vous rencontrez des problèmes d'autorisation, essayez de l'exécuter en tant qu'administrateur
- Certains antivirus peuvent signaler un faux positif ; vous devrez peut-être l'ajouter à une liste blanche

Télécharger Node Version Manager (NVM)
Après le redémarrage, ouvrez PowerShell, tapez wsl pour entrer dans Ubuntu, puis exécutez :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
Installer Node.js 22 avec NVM
Ouvrez une nouvelle fenêtre PowerShell dans la barre d'onglets et démarrez WSL wsl
Installez Node.js (le paquet npm de Codex nécessite Node.js 16 ou une version ultérieure ; la version 22 LTS est recommandée) :
nvm install 22
3. Installer Codex CLI
Installer Codex CLI
npm i -g @openai/codex Cette commande télécharge et installe la dernière
version de Codex CLI à partir du référentiel officiel npm.

4. Modifier le fichier de configuration (dans WSL)
Codex est installé dans WSL : sa configuration doit donc aussi être écrite dans WSL. Dans PowerShell, tapez wsl pour entrer dans Ubuntu, puis exécutez :
Modification en un clic du fichier de configuration Codex CLI (dans WSL)
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Les invites du script s'affichent en chinois ; les valeurs sont les mêmes que dans le texte.
À l'invite API 基础地址 (adresse de base de l'API), appuyez simplement sur Entrée (la valeur par défaut est https://api.88api.ai ; le script ajoute lui-même /v1, ce qui donne https://api.88api.ai/v1), puis collez votre jeton 88API (la saisie est masquée). Le script écrit ~/.codex/config.toml dans WSL (et non %USERPROFILE%\.codex sous Windows ; si CODEX_HOME est défini, il écrit dans ce répertoire) et utilise par défaut
model_provider = "88api", wire_api = "responses" et un
experimental_bearer_token propre au fournisseur ; à la fin, il affiche API 基础地址: https://api.88api.ai/v1 et 已写入: …/config.toml. Le nouveau script n'écrit plus la clé 88API dans
auth.json.OPENAI_API_KEY, ce qui évite les erreurs API_KEY_REQUIRED /
401 Unauthorized dans les versions récentes de Codex.
Remarque : le script écrase le
config.tomlexistant. Le fichier d'origine est sauvegardé automatiquement sousconfig.toml.bak.<horodatage>(le script affiche已备份原配置: …). Si vous aviez configuré des serveurs MCP, des projets approuvés ou d'autres fournisseurs, réintégrez-les depuis la sauvegarde.
Sans WSL (PowerShell natif de Windows)
N'utilisez la version PowerShell du script que si vous installez et exécutez Codex dans le PowerShell natif de Windows (sans WSL). Elle écrit %USERPROFILE%\.codex\config.toml :
curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-cli-setup.ps1 -o "$env:TEMP\codex-cli-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-cli-setup.ps1"Les invites et les paramètres écrits sont les mêmes que ci-dessus ; ensuite, lancez codex directement dans PowerShell.
Configuration manuelle de config.toml (facultatif)
Pour configurer manuellement, écrivez ce qui suit dans ~/.codex/config.toml (sous Windows natif : %USERPROFILE%\.codex\config.toml) :
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"Remarque : base_url doit se terminer par /v1 (Codex ajoute seulement /responses et n'ajoute jamais /v1 lui-même ; sans /v1, la requête est redirigée vers le site web et échoue). wire_api doit valoir responses (les versions récentes de Codex ont supprimé chat).
5. Commencer à utiliser Codex CLI
Vous pouvez maintenant commencer à utiliser Codex CLI !
Lancer Codex CLI
Tapez d'abord wsl pour entrer dans Ubuntu. Lancer directement : codex. Dans un projet spécifique : cd ~/code/your-project (il est recommandé de garder les projets dans le système de fichiers Linux de WSL ; un dossier Windows s'écrit cd /mnt/c/Users/<nom_utilisateur>/path/to/project), puis exécutez codex.


Définissez les autorisations Codex CLI: 1. Autorisez Codex à modifier les fichiers directement ; 2. Codex nécessite une autorisation manuelle pour modifier les fichiers
Sélectionner le modèle
/model
Dans Select Model and Effort, choisissez un modèle avec les flèches (celui en cours d'utilisation est marqué (current)) et appuyez sur Entrée, puis choisissez le niveau de raisonnement dans Select Reasoning Level : Entrée pour en faire la valeur par défaut, ou s pour l'utiliser seulement dans cette session. Le niveau marqué (default) correspond à la valeur model_reasoning_effort de votre fichier de configuration (high avec la configuration de ce guide).


Remarque : après la configuration, tous les modèles de
/modelpassent par le point d'accès 88API et ne consomment pas le quota du compte officiel. Modèles 88API actuellement utilisables dans Codex : gpt-6.1-sol (par défaut dans le script, recommandé), gpt-6-astra (modèle phare), gpt-6-sol, gpt-5.6-sol (par défaut dans les anciennes versions du script), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (le groupe de votre jeton doit inclure le modèle ; si votre groupe ne propose pas gpt-6.1-sol, utilisez gpt-6-astra). gpt-6-luna et gpt-5.6-luna, qui figurent aussi dans la liste, ne sont pas encore proposés par 88API ; les sélectionner renvoie une erreur de modèle introuvable.
Guide graphique macOS
1. Installez Homebrew (Ignorer si déjà installé)
Homebrew est le gestionnaire de packages pour macOS qui installe les logiciels manquants.
Site officiel : https://brew.sh

Installer Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"



2. Installer l'environnement Node.js
Étapes d'installation de l'environnement Node.js
Mettre à jour Homebrew brew update Installer Node.js brew install node
Remarques macOS
- Si vous rencontrez des problèmes d'autorisation, vous devrez peut-être utiliser
sudo - La première exécution peut nécessiter une autorisation dans les Réglages Système
- Il est recommandé d'utiliser
TerminalouiTerm2


Vérifier l'installation
Après l'installation, ouvrez le terminal et saisissez les commandes suivantes :
node --version
npm --versionSi les numéros de version s'affichent, l'installation a réussi.
3. Installer Codex CLI
Installer Codex CLI
Ouvrez le terminal et exécutez :
npm install -g @openai/codexEn cas de problème d'autorisation : sudo npm install -g @openai/codex. Vous pouvez aussi l'installer avec Homebrew : brew install --cask codex.

Vérifier l'installation de Codex CLI
Après l'installation, entrez la commande suivante pour vérifier si l'installation
a réussi: codex --version Si le numéro de version est affiché,
félicitations ! Codex CLI a été installé avec succès.
4. Modifier le fichier de configuration
Modification en un clic du fichier de configuration Codex CLI
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Les invites du script s'affichent en chinois ; les valeurs sont les mêmes que dans le texte.
À l'invite API 基础地址 (adresse de base de l'API), appuyez simplement sur Entrée (la valeur par défaut est https://api.88api.ai ; le script ajoute lui-même /v1, ce qui donne https://api.88api.ai/v1), puis collez votre jeton 88API (la saisie est masquée). Le script écrit ~/.codex/config.toml (si CODEX_HOME est défini, il écrit dans ce répertoire) et utilise par défaut
model_provider = "88api", wire_api = "responses" et un
experimental_bearer_token propre au fournisseur ; à la fin, il affiche API 基础地址: https://api.88api.ai/v1 et 已写入: …/config.toml. Le nouveau script n'écrit plus la clé 88API dans
auth.json.OPENAI_API_KEY.
Remarque : le script écrase le
config.tomlexistant. Le fichier d'origine est sauvegardé automatiquement sousconfig.toml.bak.<horodatage>(le script affiche已备份原配置: …). Si vous aviez configuré des serveurs MCP, des projets approuvés ou d'autres fournisseurs, réintégrez-les depuis la sauvegarde.
Configuration manuelle de config.toml (facultatif)
Pour configurer manuellement, écrivez ce qui suit dans ~/.codex/config.toml :
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"Remarque : base_url doit se terminer par /v1 (Codex ajoute seulement /responses et n'ajoute jamais /v1 lui-même ; sans /v1, la requête est redirigée vers le site web et échoue). wire_api doit valoir responses (les versions récentes de Codex ont supprimé chat).
5. Commencer à utiliser Codex CLI
Vous pouvez maintenant commencer à utiliser Codex CLI !
Lancer Codex CLI
Lancer directement Codex CLI : codex. Dans un projet spécifique : faites d'abord cd ~/path/to/your/project, puis exécutez codex.


Définissez les autorisations Codex CLI: 1. Autorisez Codex à modifier les fichiers directement ; 2. Codex nécessite une autorisation manuelle pour modifier les fichiers
Dans Select Model and Effort, choisissez un modèle avec les flèches (celui en cours d'utilisation est marqué (current)) et appuyez sur Entrée, puis choisissez le niveau de raisonnement dans Select Reasoning Level : Entrée pour en faire la valeur par défaut, ou s pour l'utiliser seulement dans cette session. Le niveau marqué (default) correspond à la valeur model_reasoning_effort de votre fichier de configuration (high avec la configuration de ce guide).


Remarque : après la configuration, tous les modèles de
/modelpassent par le point d'accès 88API et ne consomment pas le quota du compte officiel. Modèles 88API actuellement utilisables dans Codex : gpt-6.1-sol (par défaut dans le script, recommandé), gpt-6-astra (modèle phare), gpt-6-sol, gpt-5.6-sol (par défaut dans les anciennes versions du script), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (le groupe de votre jeton doit inclure le modèle ; si votre groupe ne propose pas gpt-6.1-sol, utilisez gpt-6-astra). gpt-6-luna et gpt-5.6-luna, qui figurent aussi dans la liste, ne sont pas encore proposés par 88API ; les sélectionner renvoie une erreur de modèle introuvable.
6. Résolution des problèmes courants de macOS
Erreur d'autorisation lors de l'installation
Essayez les solutions suivantes:
- Installer en utilisant
sudo:sudo npm install -g @openai/codex - Ou configurer
npmpour utiliser le répertoire utilisateur :npm config set prefix ~/.npm-global
Les paramètres de sécurité macOS bloquent l'exécution
Si le système bloque l'exécution de Codex CLI:
- Ouvrez « Réglages Système » → « Confidentialité et sécurité », trouvez codex bloqué dans la section « Sécurité » et cliquez sur « Ouvrir quand même »
- Il est déconseillé de désactiver Gatekeeper globalement avec
sudo spctl --master-disable(Codex installé via npm n'est normalement pas bloqué, et les versions récentes de macOS ne permettent plus de le désactiver directement avec cette commande)
Guide graphique Linux
1. Installer l'environnement Node.js
Codex CLI nécessite l'environnement Node.js pour s'exécuter.
Étapes d'installation de l'environnement Node.js
Ajouter le référentiel NodeSource sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - Installer Node.js sudo apt-get install -y nodejs
Remarques Linux
- Certaines distributions peuvent nécessiter l'installation de dépendances supplémentaires
- Utilisez sudo si vous rencontrez des problèmes d'autorisation
- Assurez-vous que votre utilisateur dispose des autorisations d'écriture dans le répertoire global npm


Vérifier l'installation
Après l'installation, ouvrez le terminal et saisissez les commandes suivantes :
node --version
npm --versionSi les numéros de version s'affichent, l'installation a réussi.
2. Installer Codex CLI
Installer Codex CLI
Ouvrez le terminal et exécutez :
npm install -g @openai/codexEn cas de problème d'autorisation : sudo npm install -g @openai/codex

Vérifier l'installation de Codex CLI
Après l'installation, entrez la commande suivante pour vérifier si l'installation
a réussi: codex --version Si le numéro de version est affiché,
félicitations ! Codex CLI a été installé avec succès.
3. Modifier le fichier de configuration
Modification en un clic du fichier de configuration Codex CLI
bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)
Les invites du script s'affichent en chinois ; les valeurs sont les mêmes que dans le texte.
À l'invite API 基础地址 (adresse de base de l'API), appuyez simplement sur Entrée (la valeur par défaut est https://api.88api.ai ; le script ajoute lui-même /v1, ce qui donne https://api.88api.ai/v1), puis collez votre jeton 88API (la saisie est masquée). Le script écrit ~/.codex/config.toml (si CODEX_HOME est défini, il écrit dans ce répertoire) et utilise par défaut
model_provider = "88api", wire_api = "responses" et un
experimental_bearer_token propre au fournisseur ; à la fin, il affiche API 基础地址: https://api.88api.ai/v1 et 已写入: …/config.toml. Le nouveau script n'écrit plus la clé 88API dans
auth.json.OPENAI_API_KEY.
Remarque : le script écrase le
config.tomlexistant. Le fichier d'origine est sauvegardé automatiquement sousconfig.toml.bak.<horodatage>(le script affiche已备份原配置: …). Si vous aviez configuré des serveurs MCP, des projets approuvés ou d'autres fournisseurs, réintégrez-les depuis la sauvegarde.
Configuration manuelle de config.toml (facultatif)
Pour configurer manuellement, écrivez ce qui suit dans ~/.codex/config.toml :
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"Remarque : base_url doit se terminer par /v1 (Codex ajoute seulement /responses et n'ajoute jamais /v1 lui-même ; sans /v1, la requête est redirigée vers le site web et échoue). wire_api doit valoir responses (les versions récentes de Codex ont supprimé chat).
4. Commencer à utiliser Codex CLI
Vous pouvez maintenant commencer à utiliser Codex CLI !
Lancer Codex CLI
# Accédez au répertoire de votre projet
cd /path/to/your/project
# Lancer Codex CLI
codex

Définissez les autorisations Codex CLI: 1. Autorisez Codex à modifier les fichiers directement ; 2. Codex nécessite une autorisation manuelle pour modifier les fichiers
Dans Select Model and Effort, choisissez un modèle avec les flèches (celui en cours d'utilisation est marqué (current)) et appuyez sur Entrée, puis choisissez le niveau de raisonnement dans Select Reasoning Level : Entrée pour en faire la valeur par défaut, ou s pour l'utiliser seulement dans cette session. Le niveau marqué (default) correspond à la valeur model_reasoning_effort de votre fichier de configuration (high avec la configuration de ce guide).


Remarque : après la configuration, tous les modèles de
/modelpassent par le point d'accès 88API et ne consomment pas le quota du compte officiel. Modèles 88API actuellement utilisables dans Codex : gpt-6.1-sol (par défaut dans le script, recommandé), gpt-6-astra (modèle phare), gpt-6-sol, gpt-5.6-sol (par défaut dans les anciennes versions du script), gpt-5.6-terra, gpt-6.1-terra, gpt-5.5 (le groupe de votre jeton doit inclure le modèle ; si votre groupe ne propose pas gpt-6.1-sol, utilisez gpt-6-astra). gpt-6-luna et gpt-5.6-luna, qui figurent aussi dans la liste, ne sont pas encore proposés par 88API ; les sélectionner renvoie une erreur de modèle introuvable.
5. Résolution des problèmes courants sous Linux
Erreur d'autorisation lors de l'installation
Essayez les solutions suivantes:
-
Installer en utilisant
sudo:sudo npm install -g @openai/codex -
Ou configurer
npmpour utiliser le répertoire utilisateur :npm config set prefix ~/.npm-global -
Puis ajoutez à
PATH:export PATH=~/.npm-global/bin:$PATH
Bibliothèques de dépendances manquantes
Certaines distributions Linux nécessitent l'installation de dépendances supplémentaires :
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"