Codex CLI

Codex CLI est l'agent de codage en ligne de commande officiel d'OpenAI ; il définit les fournisseurs de modèles dans ~/.codex/config.toml. Pointez un provider personnalisé vers aicentos et les modèles intégrés par aicentos deviennent utilisables dans le terminal.

Si vous préférez gérer plusieurs configurations en mode graphique, passez plutôt par CC Switch pour basculer en un clic ; cet article ne traite que la configuration manuelle.

PrérequisCopier le lien d’ancre

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Codex CLI (nommez-la par exemple codex-cli, pour suivre plus facilement sa consommation) :

• Console : https://aicentos.com
• Créer une clé : https://aicentos.com/keys
• Recharger en cas de solde insuffisant : https://aicentos.com/wallet

Vérifiez que Codex CLI est installé :

codex --version

Configuration à renseignerCopier le lien d’ancre

Étapes de configurationCopier le lien d’ancre

1. Définir la variable d'environnement de la clé APICopier le lien d’ancre

export AICENTOS_API_KEY="sk-votre-clé-API"

Pour un effet permanent, écrivez-la dans ~/.zshrc ou ~/.bashrc, faites un source, puis vérifiez avec echo $AICENTOS_API_KEY.

2. Éditer config.tomlCopier le lien d’ancre

Ajoutez dans ~/.codex/config.toml :

model = "votre-nom-de-modèle"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

Remplacez votre-nom-de-modèle par le nom d'un modèle listé dans la « place de marché des modèles » de la console, voir Modèles pris en charge.

3. Lancer CodexCopier le lien d’ancre

codex

Envoyez une requête simple pour vérifier que le provider fonctionne.

TestCopier le lien d’ancre

codex exec "Réponds en une phrase : combien font 1+1 ?"

Si du contenu est renvoyé normalement, la connexion fonctionne ; la réponse consomme un peu de crédit, que vous pouvez vérifier dans les journaux d'usage de la console.

RemarquesCopier le lien d’ancre

• La Base URL s'arrête à /v1, ne la complétez pas en chemin complet /v1/chat/completions.
• Les champs base_url, env_key, etc. ne prennent effet que dans le ~/.codex/config.toml utilisateur. Un .codex/config.toml écrit dans un projet est ignoré, et un avertissement peut apparaître au démarrage.
• wire_api prend la valeur responses, qui correspond à l'interface Responses d'aicentos. La documentation officielle ne prend en charge que cette valeur à ce jour ; si votre version signale unknown variant, la CLI est trop ancienne, mettez-la à jour d'abord.
• openai, ollama et lmstudio sont des identifiants de provider réservés : il est impossible de redéfinir le base_url du openai intégré pour pointer vers une passerelle tierce ; il faut créer un nouveau nom de provider (cet article utilise aicentos).
• Ordre de dépannage : le nom du modèle correspond-il à la console → la Base URL s'arrête-t-elle à /v1 → la variable d'environnement est-elle visible dans le terminal qui lance codex → le solde du compte est-il suffisant ?

Liens utilesCopier le lien d’ancre

• Intégrer Codex (méthode CC Switch)