Tutoriel complet : utiliser Codex en toute simplicité en Chine, testé et approuvé

Bonjour à tous, je suis Cang He.

Après la mise en ligne de CodexGuide avant-hier, le backend a explosé.

La question la plus fréquente est : Comment utiliser Codex en Chine ? Puis-je l'utiliser sans abonnement Plus ?

Pour être honnête, je comprends cette galère.

S'abonner à Plus a ses barrières, et il faut en plus se démerder avec les moyens de paiement ; c'est épuisant.

J'ai donc passé deux jours à tester toutes les solutions que j'ai trouvées en ligne, je suis tombé dans plein de pièges, et j'ai enfin résumé les trois méthodes d'accès les plus fiables.

Je les partage toutes avec vous aujourd'hui — suivez simplement les étapes.

Le tutoriel est aussi disponible sur CodexGuide pour le consulter à tout moment.

Vu le boulot que ça m'a demandé, lâchez une étoile, hahaha.

D'abord, un prérequis : la manière la plus stable d'utiliser Codex reste de se connecter avec un compte GPT officiel.

Se connecter à une API tierce est une opération avancée ; il faut savoir ce que sont config.toml, API Key et Base URL.

Si vous ne savez pas, pas de souci — suivez simplement les étapes ci-dessous.

Comment choisir entre les trois méthodes

Voici un tableau pour vous aider à trouver votre bonheur :

Franchement, si vous êtes débutant, regardez juste la méthode 2 ; c'est la plus tranquille.

Si vous commencez tout juste à apprendre Codex, je vous suggère de jeter un œil à mon précédent tutoriel pour débutants sur Codex avant de toucher aux API tierces.

Méthode 1 : Configuration manuelle

Cette méthode a un inconvénient : vous ne pouvez pas utiliser la fonctionnalité de plugins de l'appli Codex.

Si vous voulez utiliser des plugins, passez directement à la méthode 2.

Le cœur de la configuration manuelle est de modifier un fichier :

Avant de le modifier, faites une sauvegarde — prenez de bonnes habitudes :

Deux approches de connexion

Un conseil : ne changez pas trop de choses à la fois. Ajoutez d'abord un seul fournisseur, et une fois que ça marche, bidouillez les configurations multiples.

Exemple de statut de connexion GPT

Cela signifie que votre Codex doit d'abord être connecté à un compte GPT.

Étape 1 : Modifier le fichier de configuration :

Ouvrez ~/.codex/config.toml et ajoutez la configuration suivante.

Note : remplissez les champs et valeurs selon votre service réel :

Quelques pièges courants :

• model_provider doit être exactement identique à xxx dans [model_providers.xxx] ; pas une seule lettre de différence.
• base_url doit aller seulement jusqu'à /v1 ; n'incluez pas tout le segment /v1/responses.
• wire_api = "responses" signifie effectuer la requête au format Responses API ; ne le modifiez pas.
• requires_openai_auth = false signifie ne pas utiliser le statut de connexion officiel.

Étape 2 : Définir les variables d'environnement

Ouvrez le terminal et entrez :

Étape 3 : Lancer l'appli Codex depuis le terminal

Il y a un piège ici : les utilisateurs Mac doivent lancer depuis le terminal ; cliquer directement sur l'icône ne lira peut-être pas le modèle.

Fermez complètement l'appli Codex avant de lancer, puis entrez dans le terminal :

Étape 4 : Vérifier le résultat

Ouvrez l'appli Codex, et vous verrez que le modèle a bien été changé :

Bon sang, ça décolle.

Exemple de connexion API Key

Si vous utilisez la méthode API Key, souvenez-vous d'un principe : mettez la clé secrète dans les variables d'environnement, ne l'écrivez pas en dur dans le fichier de configuration.

Configuration config.toml correspondante :

Une chose à noter : si votre fournisseur upstream ne supporte que Chat Completions et pas l'API Responses, changer la configuration ne suffira pas ; vous aurez besoin d'une passerelle comme CCX pour la conversion de protocole, ce qui sera abordé dans la méthode 3.

Modifiez le fichier d'authentification

Ouvrez ~/.codex/auth.json et remplacez OPENAI_API_KEY par la clé de votre fournisseur de modèle :

Comment vérifier que la configuration a réussi

Ne vous précipitez pas après avoir configuré ; vérifiez d'abord :

1. Quittez complètement Codex et rouvrez-le.
2. Demandez-lui d'effectuer une tâche en lecture seule, comme résumer la structure du répertoire actuel.
3. S'il y a une erreur, vérifiez d'abord le nom model_provider, base_url et les variables d'environnement.
4. Si une erreur d'authentification survient, revenez d'abord à la configuration de sauvegarde ; ne paniquez pas.

Méthode 2 : Codex++

Si vous trouvez la configuration manuelle trop compliquée, jetez un œil à Codex++.

C'est un outil de gestion graphique qui vous aide à gérer les configurations de relais en un clic, sans avoir à écrire manuellement des fichiers toml.

De plus, il supporte les fonctions de plugins, ce que la méthode 1 ne peut pas faire.

Convient à ces personnes :

• Celles qui utilisent principalement l'appli de bureau Codex.
• Celles qui ne veulent pas écrire de fichiers de configuration manuellement.
• Celles qui veulent revenir au mode officiel à tout moment.

Étapes d'installation

1. Ouvrez Codex++ Releases et téléchargez le package d'installation.

Vous verrez deux packages d'installation : "Codex++ Management Tool" et "Codex++ app" ; installez les deux.

1. Ouvrez le "Codex++ Management Tool" après installation.

Si cette erreur apparaît lors de la première ouverture, ne paniquez pas :

Allez dans "Paramètres système" - "Confidentialité et sécurité", et cliquez sur "Ouvrir quand même" :

Après ouverture, entrez dans l'interface de gestion :

Installez l'appli Codex++ de la même manière ; c'est correct si la détection de l'outil de gestion est tout vert :

Confirmez que le statut de connexion GPT est détecté.

1. Ajoutez une configuration de relais.

Sélectionnez "Configuration du fournisseur" - Ajouter un fournisseur, et remplissez votre Base URL et votre clé.

Note : sélectionnez "API pure" pour la méthode d'accès :

La liste des modèles peut être obtenue automatiquement depuis l'upstream ; si vous configurez un relais, il y aura de nombreux modèles parmi lesquels choisir ici :

Essentiellement, cet outil vous aide à écrire les configurations plus facilement, vous évitant d'éditer manuellement les fichiers :

Testez la connectivité après avoir sauvegardé ; s'il n'y a pas de problème, utilisez-le directement :

1. Lancez Codex depuis le point d'entrée Codex++.

Note : lancez depuis Codex++, pas depuis le Codex original :

Après redémarrage, vous verrez que Codex utilise déjà le fournisseur de modèle personnalisé, et le nombre de modèles disponibles a soudainement augmenté :

Les plugins peuvent également être utilisés directement ; c'est l'expérience complète :

Vous devez admettre que cette méthode est la plus fluide que j'aie utilisée jusqu'à présent ; je la recommande vivement.

Et si je veux revenir en arrière ?

• Effacez le mode API dans l'outil de gestion et revenez à la configuration officielle.
• Si Codex++ cesse de fonctionner après une mise à jour de Codex, attendez simplement qu'il soit adapté ; cela n'affecte pas l'utilisation de la version originale.

Méthode 3 : CCX + CC Switch

Cette méthode convient aux utilisateurs avancés, elle sépare la "passerelle" et l'"outil de commutation" :

• CCX : Passerelle API proxy, responsable de la conversion de protocole et du routage. Supporte divers points d'entrée comme Claude, OpenAI, Codex, Gemini, etc.
• CC Switch : Outil de gestion de bureau, changement en un clic de différentes configurations de fournisseur.

Quand utiliser cette méthode ? Quand vous avez plusieurs API de modèles domestiques, plusieurs services de relais, plusieurs clés, ou quand l'upstream ne supporte que Chat Completions et a besoin d'une conversion vers Responses API.

Étape 1 : Déployer CCX

Utilisez Docker avec une seule commande :

Après démarrage, vous pouvez le voir en ouvrant le navigateur.

Étape 2 : Ajouter des canaux upstream

Ajoutez vos canaux dans l'interface de gestion CCX :

1. Sélectionnez le type de service upstream.
2. Remplissez l'API Key et la Base URL.
3. Configurez le mappage des modèles et les règles de routage.
4. Utilisez la fonction de test intégrée pour confirmer la connectivité.

Il y a un point crucial ici : Codex a besoin d'un point d'entrée Responses API. Si l'upstream n'a que Chat Completions, CCX effectuera la conversion de protocole, ce qui est la raison principale de son utilisation.

Étape 3 : Installer CC Switch

Installation en ligne de commande :

Initialisation :

Pendant l'initialisation, renseignez l'adresse CCX comme point d'entrée du relais.

Étape 4 : Changer de configuration et lancer

Une seule commande pour changer de fournisseur :

Redémarrez ensuite Codex pour que cela prenne effet.

Après le changement, il est recommandé d'ouvrir ~/.codex/config.toml pour vérifier :

• Est-ce que model_provider correspond à ce que vous venez de sélectionner ?
• Est-ce que base_url pointe vers CCX ?
• Avez-vous accidentellement écrit la clé dans un dépôt public (c'est très important) ?

Résumé des pièges courants

Enfin, voici un tableau de dépannage ; consultez-le d'abord si vous rencontrez des problèmes :

Pour être honnête, j'ai testé les trois méthodes avec succès, mais j'utilise le plus souvent la méthode 2, Codex++, au quotidien ; c'est sans souci.

Si vous êtes le genre d'utilisateur avancé avec plusieurs clés et plusieurs fournisseurs, la méthode 3 vous conviendra mieux.

Voilà, c'est tout pour le partage d'aujourd'hui.

Si ce tutoriel vous a aidé, laissez un like pour me le faire savoir, et je continuerai à publier d'autres astuces pratiques pour Codex à l'avenir.

Si vous avez des questions, demandez directement dans les commentaires ; je répondrai à tout ce que je vois.