Utiliser Codex CLI avec des modèles gratuits
Codex CLI est l'agent de code open source d'OpenAI pour le terminal. Il peut utiliser un fournisseur de modèles personnalisé. Ce guide relie Codex CLI à des modèles gratuits d'autres fournisseurs, via FreeLLMAPI. Codex parle l'API Responses, et FreeLLMAPI la sert sur /v1/responses.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Fonctionnement
Codex CLI envoie des requêtes au format OpenAI Responses. La documentation de Codex indique que responses est la seule valeur de wire_api prise en charge. Un fournisseur pour Codex doit donc servir /v1/responses. FreeLLMAPI sert ce point d'accès. Il traduit chaque requête et l'envoie à un modèle gratuit, par exemple Gemini, GPT-OSS, Qwen ou GLM.
- Vous obtenez : l'agent Codex CLI, ses outils et sa boucle de modification, sur des modèles gratuits.
- Vous n'obtenez pas : les modèles GPT d'OpenAI inclus dans votre offre ChatGPT. Les requêtes vont vers les fournisseurs gratuits de votre réserve FreeLLMAPI.
- Limite : l'entrée d'images sur
/v1/responsesn'est pas encore prise en charge. Utilisez des prompts en texte.
Étape 1 : installer FreeLLMAPI et Codex CLI
Installer les deux
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexOuvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Copiez votre clé unifiée depuis la même page. Sur macOS, vous pouvez aussi installer Codex avec brew install --cask codex.
Étape 2 : connecter Codex CLI
La commande de configuration ajoute un fournisseur dans ~/.codex/config.toml. Elle crée d'abord une sauvegarde et fusionne le nouveau bloc, vos autres réglages sont donc conservés.
Une seule commande
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexLa commande écrit ces réglages, avec les valeurs de votre catalogue en direct. La clé n'est pas dans le fichier. Codex la lit dans la variable d'environnement FREELLMAPI_API_KEY. Exportez donc cette variable dans chaque shell où vous lancez Codex.
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| Clé | Ce qu'elle fait |
|---|---|
model_provider | Sélectionne le fournisseur dans model_providers. La valeur par défaut est openai. |
env_key | La variable d'environnement qui contient la clé API du fournisseur |
requires_openai_auth | false signifie que Codex ne demande pas de connexion OpenAI |
model_context_window | Les tokens de contexte du modèle actif. La commande prend la valeur dans votre catalogue en direct. |
model_auto_compact_token_limit | Le nombre de tokens qui déclenche le compactage automatique de l'historique. La commande fixe 90 % de la fenêtre de contexte. |
tool_output_token_limit | Le budget de tokens pour chaque sortie d'outil que Codex conserve dans l'historique |
Pour garder la clé hors des fichiers et hors de votre profil de shell, utilisez le lanceur. Il démarre Codex avec la clé dans son seul environnement :
Lanceur sans persistance
npx freellmapi launch-codexPour vérifier que les requêtes vont vers la passerelle, lancez npx freellmapi doctor. Il contrôle l'en-tête Authorization routé, le catalogue et un test en direct. Le journal des requêtes du tableau de bord affiche ensuite chaque appel de Codex. L'en-tête de réponse X-Routed-Via indique le fournisseur et le modèle qui ont répondu. Si une requête a basculé, X-Fallback-Trail indique chaque étape échouée et la raison.
[profiles.NAME] dans config.toml. Les profils sont maintenant des fichiers séparés, par exemple ~/.codex/NAME.config.toml. Utilisez la configuration par défaut ci-dessus avec une version récente de Codex.Supprimer l'avertissement sur les métadonnées du modèle
Codex affiche "Model metadata for auto not found" à chaque exécution. Codex ne connaît pas les identifiants de modèles de la passerelle. Pour lui donner de vraies métadonnées, comme la fenêtre de contexte et la prise en charge des images, ajoutez une URL de catalogue de modèles au fournisseur :
Ajouter sous [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Le catalogue conserve le prompt système par défaut et les réglages d'outils de Codex. Seuls l'avertissement et la fenêtre de contexte changent.
Choisir les modèles pour Codex CLI
Codex est un agent. Il exécute des commandes shell et modifie des fichiers par des appels d'outils. Utilisez des modèles à appels d'outils et à grande fenêtre de contexte. Le tableau montre les modèles gratuits qui respectent ces deux règles aujourd'hui.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Oui | Oui |
Affichage de 12 modèles gratuits sur 109 correspondants. Voir tous les modèles.
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
Gardez model = "auto" pour laisser le routeur choisir un modèle pour chaque requête. Pour fixer un modèle, lancez npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Vous pouvez aussi écrire model = "auto:smart" ou model = "auto:fast" dans config.toml.
Les offres gratuites ont des limites par minute et par jour. Quand un fournisseur renvoie une erreur 429, FreeLLMAPI envoie la requête au modèle suivant de la chaîne. Ajoutez des clés de quatre fournisseurs ou plus pour les longues sessions Codex. Codex compacte son historique quand il atteint model_auto_compact_token_limit. Une valeur plus basse envoie des requêtes plus petites, ce qui aide sur les offres gratuites aux limites de tokens par minute basses.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
| Codex vous demande de vous connecter avec ChatGPT | model_provider n'est pas défini, donc Codex utilise openai | Définissez model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY n'est pas défini dans ce shell | Exportez la variable, ou utilisez npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex ne connaît pas les identifiants de modèles de la passerelle | Ajoutez model_catalog_url |
Erreurs avec wire_api = "chat" | Codex ne prend en charge que l'API Responses | Définissez wire_api = "responses" |
| Les réglages de profil sont ignorés | Codex 0.134.0 et les versions suivantes ignorent les tables [profiles.NAME] | Utilisez la configuration de fournisseur par défaut, ou un fichier de profil séparé |
| Erreur indiquant que tous les modèles sont limités après N tentatives | Toutes les clés ont atteint leur limite | Ajoutez des clés de plusieurs fournisseurs, ou attendez la fin des pauses |
Questions fréquentes
Puis-je utiliser Codex CLI gratuitement ?
Oui. Codex CLI est open source. Ajoutez FreeLLMAPI comme fournisseur de modèles personnalisé dans config.toml. La passerelle envoie chaque requête vers les offres gratuites des fournisseurs, donc le coût d'inférence est de $0.
Codex CLI peut-il utiliser des modèles d'autres fournisseurs ?
Oui. Ajoutez un bloc [model_providers.
Codex CLI prend-il en charge l'API Chat Completions ?
Non. La référence de configuration de Codex indique que responses est la seule valeur de wire_api prise en charge. FreeLLMAPI sert /v1/responses, il fonctionne donc comme fournisseur de Codex.
Quel modèle gratuit est le meilleur pour Codex CLI ?
Utilisez un modèle à appels d'outils et avec au moins 128K de contexte. Le tableau de cette page montre les modèles gratuits les plus performants qui respectent ces deux règles aujourd'hui.
Comment corriger 'Model metadata for auto not found' ?
Ajoutez model_catalog_url = "http://localhost:3001/v1/codex/models" dans le bloc du fournisseur, dans ~/.codex/config.toml. Codex lit alors les vraies métadonnées des modèles de la passerelle.
Guides associés
- Utiliser Claude Code gratuitement
- Utiliser OpenCode avec une API LLM gratuite
- Utiliser Aider avec une API LLM gratuite
- Meilleures API gratuites de modèles de code
- Existe-t-il une API GPT gratuite ?
Sources
- Codex docs: config reference (vérifié le 20 November 2026)
- Codex docs: advanced config and profiles (vérifié le 20 November 2026)
- Codex CLI repository (vérifié le 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (vérifié le 20 November 2026)
- FreeLLMAPI CLI generators (vérifié le 20 November 2026)