Guide de déploiement de Codex
Téléchargez CC Switch pour votre système, saisissez votre clé API Guishu AI et vérifiez que Codex CLI répond dans le terminal.
1. Télécharger et ouvrir CC Switch
CC Switch sert à configurer l’accès à l’API. Vous utiliserez ensuite Codex CLI pour dialoguer dans le terminal. Choisissez le programme d’installation de CC Switch 4.0.25 adapté à votre ordinateur.
- Windows x64 · Télécharger le MSI Pour la plupart des PC équipés d’un processeur Intel ou AMD. Double-cliquez sur le fichier
.msi, terminez l’installation et ouvrez CC Switch depuis le menu Démarrer. - Windows ARM64 · Télécharger le MSI Choisissez ce fichier si, dans « Paramètres → Système → Informations système », la ligne « Type du système » indique un processeur ARM.
- macOS · Télécharger le DMG Pour les Mac avec une puce Apple ou un processeur Intel. Double-cliquez sur le fichier
.dmg, faites glisser CC Switch dans le dossier Applications et ouvrez-le depuis ce dossier. - Linux · Choisir un paquet Dépliez la rubrique « Assets » et choisissez l’architecture indiquée par
uname -m(aarch64correspond àarm64). Prenez le paquet.debpour Ubuntu ou Debian, ou le.rpmpour Fedora.
Vous avez téléchargé un autre fichier ? Le fichier v3.12.2-en.md contient les notes de version. Si vous ne voyez que CC-SWITC.14 après l’extraction, utilisez le programme d’installation proposé ci-dessus pour votre système. Laissez l’extension du fichier telle quelle. Les autres versions sont disponibles sur la page officielle des versions.
2. Installer Codex CLI
Sous Windows, ouvrez l’invite de commandes. Sous macOS ou Linux, ouvrez le terminal. Si Codex est déjà installé, exécutez codex --version. Si un numéro de version s’affiche, passez à l’étape 3.
Pour une première installation, installez Node.js LTS, rouvrez le terminal, puis exécutez les deux commandes ci-dessous dans l’ordre. La seconde doit afficher codex-cli et son numéro de version.
npm install -g @openai/codex@latest
codex --version3. Configurer Guishu AI dans CC Switch
Dans la barre latérale, sélectionnez Codex. Ouvrez l’onglet Direct, cliquez sur Add Provider (+), puis sur Custom Configuration dans la catégorie All.
| Champ dans CC Switch | Valeur à saisir |
|---|---|
| Name | Saisissez « Guishu AI » pour retrouver le fournisseur dans la liste. |
| API Request URL | Saisissez https://api.llm-token.cn/v1 en conservant le /v1 final. |
| API Key | Collez la clé API complète fournie par Guishu AI. |
| Default Model | Dans la liste des modèles, copiez l’identifiant d’un modèle accessible avec votre clé et compatible avec Responses, par exemple gpt-6.1-terra. |
Cliquez sur Add en bas de la page. De retour dans l’onglet Direct, cliquez sur Switch sur la fiche « Guishu AI ». Si vous utilisiez le routage ou l’agrégation, le bouton porte le nom Back to direct and use. Dès que la fiche indique In use, vous pouvez ouvrir Codex.
4. Vérifier la première réponse dans le terminal
Si une session Codex est ouverte, quittez-la. Dans le terminal, placez-vous dans le dossier de votre projet et exécutez codex. Si vous n’avez pas encore de projet, vous pouvez créer un dossier vide :
mkdir my-codex-project
cd my-codex-project
codexDans Codex, saisissez « Réponds uniquement par OK ». Une réponse confirme que la requête a abouti. Ce test consomme une partie du crédit associé à votre clé.
Aucune réponse ? En cas d’erreur 401, collez à nouveau votre clé API et vérifiez qu’elle est active. Si le modèle est indisponible, vérifiez son identifiant et les droits d’accès de la clé. Si le point de terminaison est introuvable, vérifiez que l’URL se termine par /v1 et que Upstream Format est réglé sur OpenAI Responses dans les options avancées.
Facultatif : modifier les fichiers de configuration à la main
Si vous avez obtenu une réponse avec CC Switch, la configuration est terminée. Pour une configuration manuelle, modifiez les deux fichiers ci-dessous dans %USERPROFILE%\.codex\ sous Windows ou dans ~/.codex/ sous macOS et Linux. Créez le dossier si nécessaire. Si les fichiers existent déjà, faites-en une copie et conservez vos autres réglages.
config.toml — Indiquez le fournisseur, l’adresse de l’API et un modèle accessible avec votre clé.
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json — Remplacez la valeur d’exemple par votre clé API Guishu AI, enregistrez le fichier et relancez Codex comme à l’étape 4.
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}