Accueil / Guides / Utiliser Codex CLI avec des modèles gratuits

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/responses n'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/codex

Ouvrez 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
codex

La 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_providerSélectionne le fournisseur dans model_providers. La valeur par défaut est openai.
env_keyLa variable d'environnement qui contient la clé API du fournisseur
requires_openai_authfalse signifie que Codex ne demande pas de connexion OpenAI
model_context_windowLes tokens de contexte du modèle actif. La commande prend la valeur dans votre catalogue en direct.
model_auto_compact_token_limitLe 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_limitLe 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-codex

Pour 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.

Profils : la documentation de Codex indique que Codex 0.134.0 et les versions suivantes ne lisent plus les tables [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èles gratuits pour Codex CLI : appels d'outils et 128K+ de contexte
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayOuiOui

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èmeCauseSolution
Codex vous demande de vous connecter avec ChatGPTmodel_provider n'est pas défini, donc Codex utilise openaiDéfinissez model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY n'est pas défini dans ce shellExportez 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 passerelleAjoutez model_catalog_url
Erreurs avec wire_api = "chat"Codex ne prend en charge que l'API ResponsesDéfinissez wire_api = "responses"
Les réglages de profil sont ignorésCodex 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 tentativesToutes les clés ont atteint leur limiteAjoutez des clés de plusieurs fournisseurs, ou attendez la fin des pauses
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

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.] avec base_url, env_key et wire_api = "responses", puis définissez model_provider. Le fournisseur doit servir l'API Responses.

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

Sources

Tous les guides · Parcourir tous les modèles gratuits