88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

Codex CLI


WindowsmacOSLinux

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.

  1. Page d'accueil officielle: https://chatgpt.com/codex
  2. Page d'accueil du projet: https://github.com/openai/codex
  3. Méthode d'installation: voir le tutoriel ci-dessous sur cette page

Démonstration


introduce-01.webp

Caractéristiques

Catégorie de fonctionFonctionnalité
Assistant de codage basé sur un terminalCodex 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 outilsFournit 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 atomiquesUtilise 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 approbationPrend 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 plansupdate_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 interactionsEnvoie 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 formatageIl 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 styleLa 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èlePrend 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

windows_open_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

windows-img-03.webp

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

windows-img-04.webp

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

windows-img-05.webp

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.

windows-img-06.webp

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)

windows-configure

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.toml existant. Le fichier d'origine est sauvegardé automatiquement sous config.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.

windows-img-09.webp

windows-img-10.webp

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).

Choisir un modèle avec /model dans Codex CLI

Choisir le niveau de raisonnement dans Codex CLI

Remarque : après la configuration, tous les modèles de /model passent 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

macos-img-01.webp

Installer Homebrew

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

macos-img-02.webp

macos-img-03.webp

macos-img-04.webp

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 Terminal ou iTerm2

macos-img-05.webp

macos-img-06.webp

Vérifier l'installation

Après l'installation, ouvrez le terminal et saisissez les commandes suivantes :

node --version
npm --version

Si 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/codex

En cas de problème d'autorisation : sudo npm install -g @openai/codex. Vous pouvez aussi l'installer avec Homebrew : brew install --cask codex.

macos-img-07.webp

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)

macos-configure

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.toml existant. Le fichier d'origine est sauvegardé automatiquement sous config.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.

macos-img-09.webp

macos-img-10.webp

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).

Choisir un modèle avec /model dans Codex CLI

Choisir le niveau de raisonnement dans Codex CLI

Remarque : après la configuration, tous les modèles de /model passent 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 npm pour 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

linux-img-01.webp

linux-img-02.webp

Vérifier l'installation

Après l'installation, ouvrez le terminal et saisissez les commandes suivantes :

node --version
npm --version

Si 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/codex

En cas de problème d'autorisation : sudo npm install -g @openai/codex

linux-img-03.webp

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)

macos-configure

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.toml existant. Le fichier d'origine est sauvegardé automatiquement sous config.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

linux-img-05.webp

linux-img-06.webp

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).

Choisir un modèle avec /model dans Codex CLI

Choisir le niveau de raisonnement dans Codex CLI

Remarque : après la configuration, tous les modèles de /model passent 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 npm pour 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"