Codex

Codex CLI accepte n'importe quel fournisseur compatible OpenAI. On déclare CloudZIR comme fournisseur dans ~/.codex/config.toml, et les modèles Mina deviennent disponibles comme les autres.

Prérequis#

Codex CLI installé (npm install -g @openai/codex).
Une clé zir_ai_… et un portefeuille crédité.

Déclarer le fournisseur#

Dans ~/.codex/config.toml :

model = "mina-full"
model_provider = "cloudzir"

[model_providers.cloudzir]
name = "CloudZIR AI"
base_url = "https://api.cloudzir.com/v1"
env_key = "CLOUDZIR_API_KEY"
wire_api = "responses"

Puis exportez la clé :

export CLOUDZIR_API_KEY="zir_ai_..."
codex

$env:CLOUDZIR_API_KEY = "zir_ai_..."
codex

Codex n'accepte plus Chat Completions

Depuis février 2026, Codex CLI ne prend plus en charge que l'API Responses : un fournisseur déclaré avec wire_api = "chat" est refusé par les versions récentes (retrait annoncé dans le dépôt openai/codex, discussion n° 7782). CloudZIR expose l'API Responses (POST /v1/responses) : c'est celle qu'il faut déclarer.

Cette API est sans état côté serveur. store: true, previous_response_id, les éléments d'input d'un type inconnu et les outils intégrés sont refusés par un 400 qui nomme le champ en cause : la liste est dans le guide Responses.

Changer de modèle à la volée#

codex --model mina-flash     # rapide et économique
codex --model mina-low       # équilibré
codex --model mina-full      # raisonnement, refactorings complexes

Vérifier l'installation#

codex exec "affiche l'arborescence du projet et explique le rôle de chaque dossier"

Les requêtes doivent apparaître dans Usage sous /v1/responses.

Conseils#

Codex renvoie tout le contexte de la session à chaque tour : préférez des sessions courtes et ciblées pour maîtriser le coût.
Pour un usage en lot (scripts, CI), mina-flash suffit dans la plupart des cas ; réservez mina-full aux tâches de raisonnement.
Prévoyez un timeout d'au moins 120 s côté outillage CI.

Limites connues#

Images, API Responses et reasoning.effort (Mode de pensée) : tous supportés.
Les appels d'outils sont supportés au format OpenAI standard (guide).