Utiliser APIMart dans Codex CLI

Introduction

Codex CLI est l’agent de codage en terminal open source d’OpenAI qui peut lire et écrire des fichiers, exécuter des commandes, corriger des bugs et accomplir des tâches de codage complètes directement en ligne de commande. En vous connectant via APIMart, vous pouvez utiliser librement plusieurs modèles — y compris GPT et Claude — dans Codex CLI, avec une tarification plus flexible et compétitive.

Prérequis

Avant de commencer, assurez-vous d’avoir :

Node.js installé Téléchargez et installez depuis le site Node.js (LTS la plus récente, v20 ou plus récent recommandée) pour installer Codex CLI via npm
Obtenu une clé API APIMart Connectez-vous à la console APIMart pour obtenir votre clé API (commence par sk-)

Astuce : si vous n’avez pas encore de compte APIMart, inscrivez-vous d’abord sur APIMart et obtenez votre clé API.

Étape 1 : Installer Codex CLI

Choisissez l’une des méthodes suivantes pour installer :

npm (recommandé)
Homebrew (macOS)

Installer globalement avec npm — fonctionne sur tous les systèmes d’exploitation :

npm install -g @openai/codex

Si vous rencontrez des problèmes de permissions, ajoutez sudo (macOS / Linux).

Les utilisateurs macOS peuvent également installer avec Homebrew :

brew install codex

Vérifier l’installation

Après l’installation, exécutez la commande suivante pour confirmer :

codex --version

Si un numéro de version est affiché, l’installation a réussi.

Étape 2 : Configurer l’API APIMart

Codex CLI gère les fournisseurs de modèles via les fichiers de configuration sous le répertoire ~/.codex/. Tout ce que nous devons faire est d’ajouter un fournisseur personnalisé pointant vers APIMart.

2.1 Localiser le répertoire de configuration

macOS / Linux : ~/.codex/
Windows : C:\Users\<username>\.codex\

Si le répertoire n’existe pas, exécutez codex une fois dans votre terminal puis appuyez sur Ctrl + C pour quitter — il sera créé automatiquement.

2.2 Configurer la clé API

Dans le répertoire de configuration, créez ou modifiez le fichier auth.json et renseignez votre clé APIMart :

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Champ	Description
`OPENAI_API_KEY`	Votre clé API APIMart (commence par `sk-`)

2.3 Configurer le fournisseur de modèle

Dans le répertoire de configuration, créez ou modifiez le fichier config.toml et ajoutez le fournisseur APIMart :

# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

Champ	Description
`model`	ID du modèle par défaut — choisissez-en un dans la liste des modèles ci-dessous
`model_provider`	Fournisseur par défaut — doit correspondre à l’ID dans `[model_providers.xxx]`
`name`	Nom d’affichage du fournisseur — personnalisable
`base_url`	URL compatible OpenAI d’APIMart — fixée à `https://api.apimart.ai/v1`
`wire_api`	Protocole de fil — les versions récentes de Codex requièrent `responses` (Responses API)
`requires_openai_auth`	Définissez à `true` pour s’authentifier avec la clé d’`auth.json`

Après avoir sauvegardé les deux fichiers, redémarrez Codex CLI pour que les changements prennent effet.

Assurez-vous qu’auth.json est du JSON valide et config.toml du TOML valide. N’utilisez pas de guillemets pleine largeur / intelligents, sinon la configuration ne s’appliquera pas.

Étape 3 : Commencer

Vérifier la configuration

Dans n’importe quel répertoire de projet, exécutez la commande suivante pour confirmer que tout est branché :

codex "Introduce yourself in one sentence"

Si vous obtenez une réponse de l’IA, la configuration fonctionne. Si vous voyez un écran de connexion ou des erreurs 401 / 403, consultez la section FAQ ci-dessous.

Mode interactif

Exécutez codex directement pour entrer dans l’interface interactive — idéal pour les tâches de codage complètes :

codex

Une fois à l’intérieur, décrivez ce dont vous avez besoin en langage naturel, par ex. :

Create an Express.js server with a JSON-returning health check endpoint

Codex analysera votre projet, générera du code, exécutera des commandes et demandera confirmation avant d’effectuer des opérations sensibles.

Modes d’approbation

Lors du premier lancement, Codex vous demandera de choisir un niveau d’approbation :

Mode	Description
Read Only	Seules les lectures de fichiers sont autorisées — toute modification ou commande nécessite confirmation
Auto	Peut lire/écrire des fichiers et exécuter des commandes dans le répertoire de travail (recommandé)
Full Access	Effectue toute opération sans confirmation — à utiliser avec prudence

Nous recommandons de commencer avec le mode Auto. Tapez /approvals dans l’interface interactive pour le changer à tout moment.

Changer de modèle

Dans l’interface interactive, tapez /model pour changer rapidement, ou modifiez le champ model dans config.toml et redémarrez.

Modèles pris en charge

Pour Codex CLI, les modèles de la série GPT-5 suivants sont recommandés :

ID du modèle	Points forts	Cas d’utilisation recommandés
`gpt-5.5`	Dernier modèle phare, meilleure capacité de codage	Premier choix pour Codex, ingénierie complexe
`gpt-5.4`	Modèle phare de la génération précédente, très capable	Codage complexe, conception d’architecture
`gpt-5.4-mini`	Léger, rapide, économique	Codage quotidien, itération rapide
`gpt-5.3-codex`	Modèle de codage optimisé pour Codex	Tâches de codage agentiques
`gpt-5.2`	Stable et équilibré	Tâches de codage de routine

Conseils de sélection de modèle : La série GPT-5 ci-dessus s’associe le mieux à Codex CLI. Pour la meilleure expérience, préférez gpt-5.5 ; gpt-5.3-codex est spécifiquement optimisé pour les scénarios de codage agentique de Codex.

Commandes courantes

Commandes et raccourcis fréquemment utilisés dans Codex CLI :

Commande	Description
`codex`	Entrer dans l’interface interactive
`codex "task"`	Démarrer avec une instruction initiale
`codex exec "task"`	Mode non interactif — exécuter et sortir
`codex --model gpt-5.4`	Démarrer avec un modèle spécifié
`codex --version`	Afficher le numéro de version
`/model`	Changer de modèle dans l’interface interactive
`/approvals`	Ajuster le mode d’approbation dans l’interface
`Ctrl + C`	Quitter l’interface interactive

FAQ

Q1 : Un écran de connexion ChatGPT apparaît après le lancement ?

Si vous voyez « Sign in with ChatGPT » ou similaire après le lancement, la configuration n’a pas pris effet. Dépannage :

Assurez-vous que config.toml et auth.json sont tous deux dans ~/.codex/
Vérifiez que model_provider dans config.toml est défini sur apimart
Vérifiez qu’auth.json est du JSON valide et que la clé est remplie complètement

Q2 : Erreurs 401 / 403 ?

Code de statut	Signification	Solution
`401 Unauthorized`	Clé API manquante ou invalide	Vérifiez la clé dans `auth.json` — doit commencer par `sk-`
`403 Forbidden`	Permission insuffisante ou clé expirée	Allez dans la console pour vérifier la clé

Assurez-vous également que base_url est défini sur https://api.apimart.ai/v1, pas l’URL officielle d’OpenAI.

Q3 : Connexion échouée ?

Vérifiez votre connexion réseau
Assurez-vous que base_url dans config.toml est correct
Si vous êtes derrière un proxy, assurez-vous qu’il autorise l’accès à api.apimart.ai

Q4 : `wire_api = "chat"` n’est plus pris en charge ?

Les versions récentes de Codex CLI (0.84.0 et ultérieures) ont supprimé le protocole chat. Mettez à jour wire_api dans config.toml à responses :

wire_api = "responses"

APIMart prend en charge la Responses API — redémarrez simplement Codex après le changement.

Q5 : Les appels d’outils ou les exécutions échouent ?

Assurez-vous que wire_api dans config.toml est défini sur responses. Si vous rencontrez toujours des problèmes de compatibilité, passez à un modèle de la série GPT-5 recommandé (par ex. gpt-5.5, gpt-5.3-codex) — ils s’associent plus fiablement à Codex CLI.

Q6 : Utiliser des variables d’environnement au lieu d’auth.json ?

Vous pouvez également configurer la clé via une variable d’environnement. Changez le bloc fournisseur dans config.toml à :

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"

Définissez ensuite la variable d’environnement APIMART_API_KEY à votre clé APIMart. auth.json n’est plus requis dans cette configuration.

Q7 : Comment changer de modèle ?

Deux façons :

Dans l’interface interactive : tapez /model pour changer
Modifier la configuration : changez le champ model dans config.toml et redémarrez Codex CLI

Q8 : Comment vérifier l’utilisation et la facturation ?

Connectez-vous à la console APIMart pour consulter les statistiques d’appels API, les détails de consommation des tokens et les tendances des coûts.

Support et aide

Si vous rencontrez des problèmes lors de l’utilisation de Codex CLI :

📚 Centre de documentation APIMart
💬 Communauté Discord
🐦 Twitter @APIMart_
📧 Support technique : zhihong@apimart.ai

Commencer avec APIMart

Inscrivez-vous à APIMart maintenant, obtenez votre clé API et découvrez un assistant de programmation multi-modèle dans Codex CLI !

Documentation Index

​Introduction

​Prérequis

​Étape 1 : Installer Codex CLI

​Vérifier l’installation

​Étape 2 : Configurer l’API APIMart

​2.1 Localiser le répertoire de configuration

​2.2 Configurer la clé API

​2.3 Configurer le fournisseur de modèle

​Étape 3 : Commencer

​Vérifier la configuration

​Mode interactif

​Modes d’approbation

​Changer de modèle

​Modèles pris en charge

​Commandes courantes

​FAQ

​Q1 : Un écran de connexion ChatGPT apparaît après le lancement ?

​Q2 : Erreurs 401 / 403 ?

​Q3 : Connexion échouée ?

​Q4 : wire_api = "chat" n’est plus pris en charge ?

​Q5 : Les appels d’outils ou les exécutions échouent ?

​Q6 : Utiliser des variables d’environnement au lieu d’auth.json ?

​Q7 : Comment changer de modèle ?

​Q8 : Comment vérifier l’utilisation et la facturation ?

​Support et aide

Commencer avec APIMart

Introduction

Prérequis

Étape 1 : Installer Codex CLI

Vérifier l’installation

Étape 2 : Configurer l’API APIMart

2.1 Localiser le répertoire de configuration

2.2 Configurer la clé API

2.3 Configurer le fournisseur de modèle

Étape 3 : Commencer

Vérifier la configuration

Mode interactif

Modes d’approbation

Changer de modèle

Modèles pris en charge

Commandes courantes

FAQ

Q1 : Un écran de connexion ChatGPT apparaît après le lancement ?

Q2 : Erreurs 401 / 403 ?

Q3 : Connexion échouée ?

Q4 : `wire_api = "chat"` n’est plus pris en charge ?

Q5 : Les appels d’outils ou les exécutions échouent ?

Q6 : Utiliser des variables d’environnement au lieu d’auth.json ?

Q7 : Comment changer de modèle ?

Q8 : Comment vérifier l’utilisation et la facturation ?

Support et aide