Connecter Codex au modèle personnalisé CodingPlanX

Configurer OpenAI Codex CLI avec la clé API CodingPlanX.ai

Guide de configuration de l'intégration Codex

CodingPlanX.ai prend non seulement en charge Claude Code, mais aussi OpenAI Codex CLI. Après l'achat d'un forfait, Claude Code et Codex partagent le quota du forfait, vous permettant de choisir de manière flexible l'outil à utiliser.

Installer Codex CLI

npm install -g @openai/codex

Vérifier l'installation :

codex --version

Dernière version : v0.114.0 (2026-03-11), prend en charge le système Skills, le moteur Hooks et d'autres nouvelles fonctionnalités.

Modèles disponibles

Via CodingPlanX.ai, vous pouvez utiliser les modèles Codex/GPT suivants :

Tous les modèles partagent le quota du forfait CodingPlanX.ai avec Claude Code.

Aperçu de la configuration

Codex CLI nécessite la configuration de deux fichiers :

• ~/.codex/config.toml - Configuration du service
• ~/.codex/auth.json - Configuration de l'authentification

---

Configuration Windows

Étape 1 : Créer le répertoire de configuration

mkdir %HOMEPATH%\.codex

Étape 2 : Créer config.toml

Créez le fichier de configuration dans ~/.codex/config.toml :

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

Étape 3 : Créer auth.json

Créez le fichier d'authentification dans ~/.codex/auth.json :

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai.

Étape 4 : Définir les variables d'environnement (Optionnel)

Si vous préférez fournir la clé via des variables d'environnement :

# Configuration temporaire
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# Configuration permanente
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

Ensuite, définissez OPENAI_API_KEY sur null dans auth.json.

---

Configuration macOS

Étape 1 : Créer le répertoire de configuration

mkdir -p ~/.codex

Étape 2 : Créer config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Étape 3 : Créer auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai.

Étape 4 : Définir les variables d'environnement (Optionnel)

Si vous préférez fournir la clé via des variables d'environnement :

# Configuration temporaire
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuration permanente
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Ensuite, définissez OPENAI_API_KEY sur null dans auth.json.

---

Configuration Linux

Étape 1 : Créer le répertoire de configuration

mkdir -p ~/.codex

Étape 2 : Créer config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Étape 3 : Créer auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai.

Étape 4 : Définir les variables d'environnement (Optionnel)

Si vous préférez fournir la clé via des variables d'environnement :

# Configuration temporaire
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuration permanente (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Configuration permanente (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Ensuite, définissez OPENAI_API_KEY sur null dans auth.json.

---

Vérifier la configuration

Une fois la configuration terminée, exécutez Codex CLI pour vérifier :

codex

Indicateurs de succès

• Codex peut démarrer normalement et se connecter au service
• Peut générer du code normalement et obtenir des réponses de l'IA
• Les requêtes réseau passent par le service proxy CodingPlanX.ai

Problèmes fréquents

Fichier de configuration introuvable

Problème : Codex indique qu'il ne trouve pas le fichier de configuration

Solution :

1. Vérifiez si le chemin du fichier de configuration est correct
2. Confirmez que le répertoire ~/.codex/ existe
3. Confirmez que les fichiers config.toml et auth.json existent

Échec de l'authentification par clé API

Problème : Variable d'environnement invalide ou clé API incorrecte

Solution :

1. Vérifiez si la variable d'environnement CRS_OAI_KEY est correctement définie
2. Vérifiez si le format de la clé API est correct (commence par cr_)
3. Confirmez que la clé n'a pas expiré, visitez la Console pour vérifier

Problèmes de connexion réseau

Problème : Impossible de se connecter au service CodingPlanX.ai

Solution :

1. Vérifiez si la connexion réseau est normale
2. Vérifiez si la configuration base_url est bien https://api.codingplanx.ai