Tutoriel de configuration de l'interface de ligne de commande OpenAI Codex

📋 Étapes préparatoires

Avant de commencer, veuillez vous assurer d'avoir :

Créé un compte Koze et vous être connecté(e)
Créé une clé API sur la page de gestion des API
Installé l'interface de ligne de commande Codex (npm install -g @openai/codex)

🚀 Étape 1 : Configurer le fichier de configuration Codex

Ajoutez la configuration suivante au début du fichier ~/.codex/config.toml :

model_provider = "koze"

model = "gpt-4.1"

model_reasoning_effort = "high"

disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.koze]

name = "koze"

base_url = "https://api.kozeai.com/v1"

wire_api = "responses"

requires_openai_auth = true

💡 Conseil : Remplacez `https://api.kozeai.com/v1` par l’adresse de votre proxy Koze. Le champ `model` permet de sélectionner différents modèles selon votre abonnement.
🔑 Étape 2 : Configurer la clé API

Configurez votre clé API dans le fichier ~/.codex/auth.json :
{

'OPENAI_API_KEY': 'Votre clé API Koze'

}
🎯 Étape 3 : Démarrer Codex

Après la configuration, démarrez Codex directement dans le terminal :
codex
L'interface de ligne de commande Codex utilisera automatiquement le proxy Koze pour les requêtes API.

📌 Modèles disponibles

Vous pouvez utiliser les modèles suivants : Champ `model` du fichier de configuration (selon votre abonnement Koze) :

Nom du modèle Description

gpt-5.3-codex gpt-5.3-codex, adapté aux tâches de programmation courantes

gpt-5.4-mini GPT-4.1 Mini, un meilleur rapport qualité-prix

gpt-5.4 GPT-5.4 Multimodal Modèle

⚠️ Foire aux questions

Problème Solution

Conseil : « Échec de l’authentification » Vérifiez si la clé API dans auth.json est correcte
config.toml ne fonctionne pas Assurez-vous que la configuration est écrite au début du fichier et que le nom model_provider correspond à [model_providers.xxx]

Utilisation L'anti-prototype Nginx échoue. Ajoutez `underscores_in_headers on;` au bloc `http` de Nginx ; sinon, Nginx ignorera par défaut les en-têtes de requête contenant des underscores.

Nom du modèle	Description
`gpt-5.3-codex`	`gpt-5.3-codex`, adapté aux tâches de programmation courantes
`gpt-5.4-mini`	GPT-4.1 Mini, un meilleur rapport qualité-prix
`gpt-5.4`	GPT-5.4 Multimodal Modèle

Problème	Solution
Conseil : « Échec de l’authentification »	Vérifiez si la clé API dans `auth.json` est correcte
`config.toml` ne fonctionne pas	Assurez-vous que la configuration est écrite au début du fichier et que le nom `model_provider` correspond à `[model_providers.xxx]`
Utilisation L'anti-prototype Nginx échoue.	Ajoutez `underscores_in_headers on;` au bloc `http` de Nginx ; sinon, Nginx ignorera par défaut les en-têtes de requête contenant des underscores.