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.si/v1

Infos de connexion

Adresse APIhttps://byesu.si/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-6.1-sol

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, disable_response_storage et requires_openai_auth, sans que vous ayez à vous en soucier). Une fois configuré, passez directement à l'étape 3.

Windows

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

macOS / Linux

curl -fsSL https://docs.byesu.si/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-6.1-sol"                  # le niveau Sol le plus récent, bon rapport qualité-prix ; vous pouvez aussi indiquer un autre nom de modèle de la console
model_provider = "byesu"
model_reasoning_effort = "high"    # intensité de réflexion : low / medium / high / xhigh / max
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.si/v1"
wire_api = "responses"             # ★ doit être responses, Codex utilise /v1/responses
requires_openai_auth = true        # ★ obligatoire, sinon Codex n'envoie pas la clé d'auth.json (401)

② ~/.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). Il faut aussi requires_openai_auth = true dans config.toml : sans cette ligne, Codex n'envoie pas du tout la clé et vous obtenez une 401.

É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 :

• low : rapide, économique, adapté aux modifications simples
• medium : valeur par défaut, équilibre entre vitesse et qualité
• high : refactorisations complexes, problèmes difficiles, meilleure qualité mais plus lent et plus coûteux
• xhigh / max : les tâches les plus difficiles ; le plus lent et le plus coûteux

Ce sont les niveaux pris en charge par gpt-6.1-sol. D’après la documentation d’OpenAI, il n’accepte ni minimal ni none ; pour les autres modèles, consultez leur documentation officielle.

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.

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, ou il manque requires_openai_auth = true dans config.toml (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)