88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

Client ChatGPT/Codex

Portée

Ce guide s'applique aux clients de bureau Codex, aux extensions Codex pour IDE et aux clients Codex qui lisent le répertoire de configuration local ~/.codex. Après la configuration, Codex appellera les modèles via le relais 88API.

Avant de commencer

  1. Connectez-vous à 88API.
  2. Assurez-vous que votre compte dispose d'un solde.
  3. Créez une clé API dans la console 88API.
  4. Installez le client Codex ou l'extension IDE associée.

Copier la clé API dans la console 88API

Comment ça marche

Les clients Codex lisent la configuration à partir du répertoire Codex local:

FichierObjectif
~/.codex/config.tomlDéfinit le modèle, le fournisseur, le point de terminaison API, la clé API et le protocole
~/.codex/auth.jsonCache de connexion du compte OpenAI ; la configuration 88API standard n'y écrit plus la clé API

Utilisez les valeurs suivantes pour le relais 88API:

OptionsValeur
URL de base de l'APIhttps://api.88api.ai/v1
Clé APILa clé créée dans la console 88API
Modèlegpt-6.1-sol
Protocoleresponses

Configuration en un clic

Windows

Ouvrez PowerShell et exécutez:

Configurer le client Codex dans Windows PowerShell

Les invites du script s'affichent en chinois ; les valeurs sont les mêmes que dans le texte.

Configurer le client Codex

Ce guide utilise un script de configuration simple : il écrit uniquement la configuration du provider 88API pour Codex, n'installe aucun proxy et ne modifie pas le proxy système de Windows.

curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-client-setup.ps1 -o "$env:TEMP\codex-client-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-client-setup.ps1"

Entrez ce qui suit lorsque vous y êtes invité:

  1. URL de base de l'API (invite API 基础地址 [https://api.88api.ai]) : appuyez sur Entrée pour utiliser la valeur par défaut https://api.88api.ai ; le script ajoute /v1 automatiquement.
  2. Clé API : collez la clé créée dans la console 88API (la saisie ne s'affiche pas à l'écran ; appuyez simplement sur Entrée après le collage).

Le script écrit (ou config.toml dans le répertoire CODEX_HOME, si cette variable est définie) :

%USERPROFILE%\.codex\config.toml

À la fin, le terminal affiche API 基础地址: https://api.88api.ai/v1 (URL de base de l'API) et 已写入: …\config.toml (fichier écrit).

Le config.toml existant est remplacé

Le script réécrit entièrement config.toml avec uniquement les paramètres 88API. Les serveurs MCP, les approbations de projets, les autres providers et réglages similaires ne sont pas conservés. Le script sauvegarde d'abord l'ancien fichier sous config.toml.bak.<horodatage> (le terminal affiche 已备份原配置: …) ; pour conserver vos anciens réglages, fusionnez-les manuellement depuis cette sauvegarde.

Le script stocke la clé 88API dans experimental_bearer_token du provider actif au lieu de dépendre de auth.json.OPENAI_API_KEY, afin d'éviter API_KEY_REQUIRED / 401 Unauthorized avec les versions récentes de Codex.

macOS / Linux

Ouvrez Terminal et exécutez:

Configurer le client Codex dans un terminal macOS ou Linux

Les invites du script s'affichent en chinois ; les valeurs sont les mêmes que dans le texte.

bash <(curl -fsSL https://88api.ai/helper/codex-client-setup.sh)

Entrez ce qui suit lorsque vous y êtes invité:

  1. URL de base de l'API (invite API 基础地址 [https://api.88api.ai]) : appuyez sur Entrée pour utiliser la valeur par défaut https://api.88api.ai ; le script ajoute /v1 automatiquement.
  2. Clé API : collez la clé créée dans la console 88API (la saisie ne s'affiche pas à l'écran ; appuyez simplement sur Entrée après le collage).

Le script écrit (ou config.toml dans le répertoire CODEX_HOME, si cette variable est définie) :

~/.codex/config.toml

À la fin, le terminal affiche API 基础地址: https://api.88api.ai/v1 (URL de base de l'API) et 已写入: …/config.toml (fichier écrit).

Le config.toml existant est remplacé

Le script réécrit entièrement config.toml avec uniquement les paramètres 88API. Les serveurs MCP, les approbations de projets, les autres providers et réglages similaires ne sont pas conservés. Le script sauvegarde d'abord l'ancien fichier sous config.toml.bak.<horodatage> (le terminal affiche 已备份原配置: …) ; pour conserver vos anciens réglages, fusionnez-les manuellement depuis cette sauvegarde.

Le script macOS / Linux utilise lui aussi le experimental_bearer_token propre au provider et n'écrit pas la clé 88API dans auth.json.

Configuration manuelle

Vous pouvez également créer les fichiers manuellement.

config.toml

Écrivez ceci 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"

auth.json

Ne placez plus la clé 88API dans auth.json. Conservez auth.json uniquement comme cache de connexion du compte OpenAI ; les requêtes modèle doivent utiliser experimental_bearer_token dans config.toml.

Démarrez le client

Après la configuration, rouvrez le client Codex ou redémarrez votre IDE.

Si le client est déjà en cours d'exécution, quittez-le complètement et redémarrez-le pour qu'il recharge ~/.codex/config.toml et ~/.codex/auth.json.

Vérifier les demandes

  1. Démarrez une tâche simple dans le client Codex.
  2. Ouvrez la console 88API.
  3. Vérifiez les journaux d'utilisation pour la demande correspondante.

Vérifier les requêtes Codex dans les journaux d'utilisation de 88API

Si la demande apparaît dans les journaux d'utilisation, le client Codex utilise le relais 88API.

Dépannage

Le client utilise toujours le compte officiel

Confirmez que le client prend en charge la configuration locale ~/.codex. Certaines entrées Codex officielles dans le cloud utilisent uniquement la connexion au compte ChatGPT et n'acceptent pas de point de terminaison d'API tiers ; elles ne peuvent donc pas être relayées via 88API.

Échec de l'authentification

Vérifiez que experimental_bearer_token sous [model_providers.88api] (ou sous votre provider actif) dans config.toml est complet, sans espaces ni sauts de ligne au début ou à la fin.

Si API_KEY_REQUIRED ou 401 Unauthorized apparaît après une mise à jour de ChatGPT / Codex, relancez le script de configuration ci-dessus afin de réécrire le experimental_bearer_token du provider actif.

Modèle indisponible

Confirmez que votre compte 88API peut utiliser gpt-6.1-sol (le groupe de votre jeton doit l'inclure ; sinon, utilisez gpt-6-astra). Si votre compte utilise un modèle compatible Codex différent, mettez à jour le champ model dans config.toml.

Le sélecteur de modèles de l'app de bureau affiche Custom ou aucun modèle

Il s'agit d'un problème d'affichage connu de l'application de bureau Codex avec les providers personnalisés ; il n'affecte pas les requêtes. Le modèle réellement utilisé est la valeur model de config.toml ; pour changer de modèle, modifiez cette ligne (par exemple en gpt-6-astra), puis quittez complètement et rouvrez le client.

Les modifications ne prennent pas effet

Quittez complètement le client Codex ou l'IDE et rouvrez-le. Si nécessaire, supprimez l'ancien cache de connexion officiel et exécutez à nouveau le script de configuration en un clic.