Inicio / Guías / Use Codex CLI con modelos gratuitos

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/responses todaví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/codex

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

El 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
ClaveQué hace
model_providerSelecciona el proveedor de model_providers. El valor predeterminado es openai.
env_keyLa variable de entorno que contiene la clave de API del proveedor
requires_openai_authfalse indica que Codex no pide un inicio de sesión de OpenAI
model_context_windowLos tokens de contexto del modelo activo. El comando toma el valor de su catálogo en vivo.
model_auto_compact_token_limitEl 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_limitEl 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-codex

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

Perfiles: la documentación de Codex indica que Codex 0.134.0 y las versiones posteriores ya no leen las tablas [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.

Modelos gratuitos para Codex CLI: llamadas a herramientas y contexto de 128K o más
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3UnoRouter1M1 solicitudes/min
1 req/min per model
SíNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSíSí
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 solicitudes/min
50 solicitudes/día
Shared rate limit
SíNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí
Gemini 3.6 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySí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

ProblemaCausaSolución
Codex le pide que inicie sesión con ChatGPTmodel_provider no está definido, así que Codex usa openaiDefina model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY no está definida en este shellExporte la variable o use npx freellmapi launch-codex
"Model metadata for auto not found"Codex no conoce los ids de modelo del gatewayAñada model_catalog_url
Errores con wire_api = "chat"Codex solo admite la Responses APIDefina wire_api = "responses"
Los ajustes del perfil se ignoranCodex 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ímiteAñada claves de más proveedores o espere a que terminen los periodos de enfriamiento
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

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.] con base_url, env_key y wire_api = "responses", y después defina model_provider. El proveedor debe servir la Responses API.

¿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

Fuentes

Todas las guías · Ver todos los modelos gratuitos