Intégration de Codex CLI

Difficulté ⌨️ Intermédiaire (nécessite la ligne de commande / le terminal)　|　Format d'interface OpenAI / Responses　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

Codex est l'assistant de programmation en ligne de commande officiel d'OpenAI. Par défaut, il se connecte à OpenAI ; il nous suffit de le pointer vers Byesu, puis de renseigner votre clé pour l'utiliser.

Avant de commencer

Rendez-vous d'abord sur Console → Jetons pour créer une clé API (voir Démarrage rapide pour plus de détails). Remplacez tous les sk-xxxx qui apparaissent ci-dessous par votre propre clé.

Étape 1 : Installer Codex

Si ce n'est pas encore fait, choisissez l'une des méthodes suivantes :

npm (multiplateforme)

npm install -g @openai/codex

Homebrew (macOS)

brew install codex

Une fois installé, vérifiez :

codex --version

Étape 2 : Configuration (au choix)

Méthode 1 : Script en une commande (le plus rapide, recommandé)

Nous avons déjà inscrit l'adresse de l'interface dans le script — après l'avoir lancé, il vous suffit de coller votre clé API (sk-xxxx) ; il configurera automatiquement ~/.codex/config.toml et auth.json (y compris les champs obligatoires comme wire_api=responses et disable_response_storage, sans que vous ayez à vous en soucier). Une fois configuré, passez directement à l'étape 3.

Windows

iex (irm 'https://docs.byesu.com/setup/codex.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.com/setup/codex.sh | bash

Méthode 2 : Configuration manuelle

La configuration de Codex se trouve dans le répertoire ~/.codex/ et nécessite deux fichiers.

① ~/.codex/config.toml — pour indiquer le modèle et le point d'accès :

model = "gpt-5.5"                  # le plus récent et le plus puissant actuellement ; vous pouvez aussi indiquer un autre nom de modèle de la console
model_provider = "byesu"
model_reasoning_effort = "high"    # intensité de réflexion : minimal / low / medium / high
disable_response_storage = true    # ★ obligatoire pour se connecter à une passerelle tierce, sinon des erreurs peuvent survenir

[model_providers.byesu]
name = "byesu"
base_url = "https://byesu.com/v1"
wire_api = "responses"             # ★ doit être responses, Codex utilise /v1/responses

② ~/.codex/auth.json — pour stocker votre clé :

{
  "OPENAI_API_KEY": "sk-votre-jeton"
}

🤔 Vous ne savez pas comment créer ces deux fichiers ? (Cliquez pour ouvrir)

Windows : dans C:\Users\votre-nom-utilisateur\.codex\, créez séparément config.toml et auth.json avec le « Bloc-notes » (lors de l'enregistrement, choisissez « Tous les fichiers » comme type de fichier ; si le dossier .codex n'existe pas, créez-le manuellement dans la barre d'adresse).

macOS / Linux : dans le terminal, exécutez mkdir -p ~/.codex && open -e ~/.codex/config.toml (sous Linux, remplacez open -e par nano), et procédez de même pour auth.json.

Les quatre erreurs les plus fréquentes

1. wire_api doit être responses (et non chat), sinon vous obtiendrez une erreur 404 / une interface incorrecte.
2. base_url se termine par /v1, n'ajoutez pas /responses en plus.
3. N'oubliez pas disable_response_storage = true, sinon la connexion à la passerelle peut générer une erreur.
4. Le nom du champ dans auth.json est bien OPENAI_API_KEY (même si vous y mettez un jeton Byesu).

Étape 3 : Lancer et vérifier

Entrez dans n'importe quel répertoire de projet et démarrez :

codex

Demandez-lui ensuite de faire une petite chose, par exemple saisissez « liste les fichiers du répertoire courant ». S'il répond normalement, c'est que la connexion fonctionne ✅

Astuces

Ajuster l'intensité de réflexion

model_reasoning_effort contrôle « combien de temps » le modèle réfléchit :

• minimal / low : rapide, économique, adapté aux modifications simples
• medium : équilibre par défaut
• high : refactorisations complexes, problèmes difficiles, qualité maximale mais plus lent et plus coûteux

Changer de modèle

Modifiez simplement la ligne model dans config.toml et remplacez-la par n'importe quel nom de modèle disponible dans la console. Pour la version spécialement optimisée pour Codex, vous pouvez indiquer gpt-5.3-codex-spark.

Bloqué ?

Consultez Erreurs courantes & solutions pour le dépannage ; voici les plus fréquentes :

• Erreur 401 / invalid token → la clé dans auth.json est incorrecte ou mal placée (détails)
• Erreur solde insuffisant → rechargez votre compte dans la console (détails)
• Erreur aucun canal disponible → ce modèle ne fait pas partie de votre groupe, changez de modèle (détails)