Use Codex CLI con modelos gratuitos
Codex CLI es el agente de programación de código abierto de OpenAI para la terminal. Puede usar un proveedor de modelos personalizado. Esta guía conecta Codex CLI a modelos gratuitos de otros proveedores mediante FreeLLMAPI. Codex usa la Responses API, y FreeLLMAPI la sirve en /v1/responses.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Cómo funciona
Codex CLI envía solicitudes en el formato Responses de OpenAI. La documentación de Codex indica que responses es el único valor admitido de wire_api. Por eso, un proveedor para Codex debe servir /v1/responses. FreeLLMAPI sirve este endpoint. Traduce cada solicitud y la envía a un modelo gratuito, por ejemplo Gemini, GPT-OSS, Qwen o GLM.
- Obtiene: el agente Codex CLI, sus herramientas y su bucle de edición, con modelos gratuitos.
- No obtiene: los modelos GPT de OpenAI a través de su plan de ChatGPT. Las solicitudes van a los proveedores gratuitos de su conjunto de FreeLLMAPI.
- Límite: la entrada de imágenes en
/v1/responsestodavía no es compatible. Use indicaciones de texto.
Paso 1: Instale FreeLLMAPI y Codex CLI
Instale los dos
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexAbra http://localhost:3001. Añada al menos dos claves de proveedores gratuitos en la página Keys. Copie su clave unificada de la misma página. En macOS, también puede instalar Codex con brew install --cask codex.
Paso 2: Conecte Codex CLI
El comando de configuración añade un proveedor a ~/.codex/config.toml. Primero crea una copia de seguridad y combina el bloque nuevo, así que sus otros ajustes se conservan.
Un solo comando
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexEl comando escribe estos ajustes, con valores de su catálogo en vivo. La clave no está en el archivo. Codex la lee de la variable de entorno FREELLMAPI_API_KEY, así que exporte la variable en cada shell donde ejecute 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| Clave | Qué hace |
|---|---|
model_provider | Selecciona el proveedor de model_providers. El valor predeterminado es openai. |
env_key | La variable de entorno que contiene la clave de API del proveedor |
requires_openai_auth | false indica que Codex no pide un inicio de sesión de OpenAI |
model_context_window | Los tokens de contexto del modelo activo. El comando toma el valor de su catálogo en vivo. |
model_auto_compact_token_limit | El número de tokens que inicia la compactación automática del historial. El comando fija el 90% de la ventana de contexto. |
tool_output_token_limit | El presupuesto de tokens para la salida de cada herramienta que Codex conserva en el historial |
Para no guardar la clave en archivos ni en el perfil de su shell, use el lanzador. Inicia Codex con la clave solo en su entorno:
Lanzador sin persistencia
npx freellmapi launch-codexPara confirmar que las solicitudes llegan al gateway, ejecute npx freellmapi doctor. Comprueba el encabezado Authorization enrutado, el catálogo y una prueba en vivo. Después, el registro de solicitudes del panel de control muestra cada llamada de Codex. El encabezado de respuesta X-Routed-Via indica el proveedor y el modelo que respondieron. Si una solicitud pasó a otro proveedor, X-Fallback-Trail indica cada salto fallido y el motivo.
[profiles.NAME] de config.toml. Ahora los perfiles son archivos separados, por ejemplo ~/.codex/NAME.config.toml. Use la configuración predeterminada de arriba con una versión actual de Codex.Elimine la advertencia de metadatos del modelo
Codex muestra "Model metadata for auto not found" en cada ejecución. Codex no conoce los ids de modelo del gateway. Para darle metadatos reales, como la ventana de contexto y la compatibilidad con imágenes, añada una URL de catálogo de modelos al proveedor:
Añada a [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"El catálogo conserva el prompt de sistema predeterminado y los ajustes de herramientas de Codex. Solo cambian la advertencia y la ventana de contexto.
Elija modelos para Codex CLI
Codex es un agente. Ejecuta comandos de shell y edita archivos mediante llamadas a herramientas. Use modelos con llamadas a herramientas y una ventana de contexto amplia. La tabla muestra los modelos gratuitos que cumplen hoy ambas reglas.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 solicitudes/min 1 req/min per model | Sí | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 solicitudes/min 50 solicitudes/día Shared rate limit | Sí | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 solicitudes/min 250 solicitudes/día 70,000 tokens/min ~6M | Sí | Sí |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sí | Sí |
Se muestran 12 de 109 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
Mantenga model = "auto" para que el enrutador seleccione un modelo en cada solicitud. Para fijar un modelo, ejecute npx freellmapi setup-codex --url http://localhost:3001 --model <id>. También puede poner model = "auto:smart" o model = "auto:fast" en config.toml.
Los niveles gratuitos tienen límites por minuto y por día. Cuando un proveedor envía un error 429, FreeLLMAPI envía la solicitud al siguiente modelo de la cadena. Para sesiones largas de Codex, añada claves de cuatro o más proveedores. Codex compacta su historial cuando llega a model_auto_compact_token_limit. Un valor más bajo envía solicitudes más pequeñas, lo que ayuda en los niveles gratuitos con límites bajos de tokens por minuto.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| Codex le pide que inicie sesión con ChatGPT | model_provider no está definido, así que Codex usa openai | Defina model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY no está definida en este shell | Exporte la variable o use npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex no conoce los ids de modelo del gateway | Añada model_catalog_url |
Errores con wire_api = "chat" | Codex solo admite la Responses API | Defina wire_api = "responses" |
| Los ajustes del perfil se ignoran | Codex 0.134.0 y posteriores ignoran las tablas [profiles.NAME] | Use la configuración de proveedor predeterminada o un archivo de perfil aparte |
| "Todos los modelos alcanzaron el límite tras N intentos" | Todas las claves han alcanzado su límite | Añada claves de más proveedores o espere a que terminen los periodos de enfriamiento |
Preguntas frecuentes
¿Puedo usar Codex CLI gratis?
Sí. Codex CLI es de código abierto. Añada FreeLLMAPI como proveedor de modelos personalizado en config.toml. El gateway envía cada solicitud a niveles gratuitos de proveedores, así que la inferencia cuesta 0 USD.
¿Puede Codex CLI usar modelos de otros proveedores?
Sí. Añada un bloque [model_providers.
¿Admite Codex CLI la API de Chat Completions?
No. La referencia de configuración de Codex indica que responses es el único valor admitido de wire_api. FreeLLMAPI sirve /v1/responses, así que funciona como proveedor de Codex.
¿Cuál es el mejor modelo gratuito para Codex CLI?
Use un modelo con llamadas a herramientas y al menos 128K de contexto. La tabla de esta página muestra los modelos gratuitos más sólidos que cumplen hoy ambas reglas.
¿Cómo soluciono 'Model metadata for auto not found'?
Añada model_catalog_url = "http://localhost:3001/v1/codex/models" al bloque del proveedor en ~/.codex/config.toml. Así Codex lee metadatos reales de los modelos del gateway.
Guías relacionadas
- Cómo usar Claude Code gratis
- Use OpenCode con una API de LLM gratuita
- Use Aider con una API de LLM gratuita
- Mejores API gratuitas de modelos para programar
- ¿Existe una API gratuita de GPT?
Fuentes
- Codex docs: config reference (revisado 20 November 2026)
- Codex docs: advanced config and profiles (revisado 20 November 2026)
- Codex CLI repository (revisado 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (revisado 20 November 2026)
- FreeLLMAPI CLI generators (revisado 20 November 2026)