Cline, Roo Code y Kilo Code con una API gratuita
Cline, Roo Code y Kilo Code son agentes de programación para VS Code. Cada uno puede usar una API compatible con OpenAI. Esta guía los conecta con modelos gratuitos a través de FreeLLMAPI. También muestra qué modelos gratuitos manejan los prompts largos y con muchas herramientas que envían estos agentes.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Antes de empezar
FreeLLMAPI es una pasarela de código abierto que se ejecuta en su computadora. Reúne los niveles gratuitos de 45 proveedores detrás de una sola clave. Instálela con Docker y luego añada al menos dos claves de proveedores gratuitos en la página Keys.
Instale en macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopie su clave unificada de la página Keys. Los tres agentes usan los mismos valores:
| Campo | Valor |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto, o un ID del catálogo de GET /v1/models |
Cline
El método más rápido es el comando de configuración. Lee su catálogo actual, hace una copia de seguridad de la configuración existente de Cline y añade un proveedor OpenAI Compatible.
Un comando
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>La primera línea muestra las diferencias y no escribe nada. La segunda línea escribe el cambio. Para configurar Cline manualmente, siga estos pasos:
- Abra el panel de Cline en VS Code. Haga clic en el icono de configuración (engranaje).
- Defina API Provider como OpenAI Compatible.
- Defina Base URL como
http://localhost:3001/v1. - Defina API Key con su clave unificada.
- Defina Model ID como
autoo con un modelo de la tabla siguiente. - Abra Model Configuration. Defina Context Window con el contexto de su modelo. Active Image Support solo para un modelo de visión.
Cline muestra esta nota para los proveedores OpenAI Compatible: « Cline uses complex prompts, so behavior can vary across models. » Para modelos más pequeños, la documentación de Cline recomienda Use Compact Prompt en Cline Settings, Features.
Kilo Code
Ejecute el comando de configuración. Escribe una configuración global de Kilo con un proveedor openai-compatible y lo define como modelo predeterminado.
Un comando
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"La configuración hace referencia a la clave como {env:FREELLMAPI_API_KEY}, así que exporte la variable antes de iniciar Kilo. Kilo expande {env:...} solo en configuraciones de confianza, por ejemplo en la carpeta global ~/.config/kilo. En una configuración de proyecto, Kilo lo ignora y registra una advertencia. La configuración generada tiene esta forma:
Configuración global de Kilo (forma)
{
"$schema": "https://app.kilo.ai/config.json",
"model": "openai-compatible/auto",
"provider": {
"openai-compatible": {
"options": {
"apiKey": "{env:FREELLMAPI_API_KEY}",
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"tool_call": true,
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}En la extensión de VS Code, también puede añadir el proveedor manualmente. Abra Settings, luego la pestaña Providers y haga clic en Custom provider. Defina Provider API como OpenAI Compatible. Introduzca la base URL y la clave, y luego haga clic en Fetch models para leer la lista de modelos.
Roo Code (instalaciones existentes)
El comando de configuración escribe un archivo de importación para la extensión de VS Code. También escribe un perfil para la CLI de Roo.
Un comando
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>Después indique a Roo Code que cargue el archivo de importación. Añada esta línea a su settings.json de VS Code y recargue la ventana. El perfil freellmapi pasa a ser el perfil actual.
settings.json de VS Code
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"Para configurarlo manualmente, abra la configuración de Roo Code y defina API Provider como OpenAI Compatible. Introduzca la base URL, la clave y el modelo. Roo Code usa solo llamadas a herramientas nativas. Su documentación indica que un modelo sin llamadas a herramientas nativas no se puede usar con Roo Code.
Elija modelos para trabajo con agentes
Estos agentes envían en cada solicitud un prompt de sistema grande, definiciones de herramientas y contenido de archivos. Use modelos con llamadas a herramientas y una ventana de contexto amplia. La tabla muestra los modelos gratuitos con llamadas a herramientas y al menos 128K de contexto hoy, ordenados por inteligencia.
| 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.
- Use
autopara que el enrutador seleccione un modelo para cada solicitud. Cuando un proveedor envía un error 429, el enrutador prueba el siguiente modelo. - Use
auto:smartpara planificar y para errores difíciles. - Defina en el agente la ventana de contexto con el contexto real del modelo. Si el valor es demasiado alto, el agente envía prompts que el modelo rechaza.
- Inicie una tarea nueva cuando el contexto sea grande. Un contexto más pequeño usa menos tokens por solicitud.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| "Invalid API Key" | La clave no es su clave unificada de FreeLLMAPI | Copie de nuevo la clave unificada de la página Keys |
| "Model Not Found" | El ID del modelo no está en su catálogo | Use auto o un ID de GET /v1/models |
| El agente se detiene tras un paso, o fallan las llamadas a herramientas | El modelo tiene llamadas a herramientas débiles o no las tiene | Seleccione un modelo de la tabla anterior |
| Errores de ventana de contexto en tareas largas | El valor de contexto es mayor que el contexto real del modelo | Defina la ventana de contexto correcta, o inicie una tarea nueva |
| « Todos los modelos con límite de uso después de N intentos » | Todas las claves de la cadena han alcanzado su límite | Añada claves de más proveedores, o espere a que terminen los periodos de enfriamiento |
Kilo: Model not found: openai-compatible/auto | El modelo predeterminado no está en el mapa de modelos del proveedor | Ejecute setup-kilo otra vez, lo que pone el modelo predeterminado primero |
Preguntas frecuentes
¿Puedo usar Cline gratis?
Sí. Cline es gratuito y de código abierto. Defina su proveedor de API como OpenAI Compatible y apúntelo a FreeLLMAPI. La pasarela envía cada solicitud a niveles gratuitos de proveedores, así que la inferencia cuesta $0.
¿Qué modelo gratuito es el mejor para Cline?
Use un modelo con llamadas a herramientas y al menos 128K de contexto. Cline envía prompts complejos con definiciones de herramientas. La tabla de esta página muestra los modelos gratuitos más sólidos que cumplen hoy ambas reglas.
¿Sigue manteniéndose Roo Code?
No. El README de Roo Code indica que la extensión se cerró el 15 de mayo de 2026, y el repositorio está archivado. Las instalaciones existentes siguen funcionando con un proveedor OpenAI Compatible.
¿Cómo uso Kilo Code con una API personalizada compatible con OpenAI?
Añada un proveedor openai-compatible con un baseURL y un apiKey en la configuración global de Kilo, o ejecute npx freellmapi setup-kilo. En la extensión de VS Code, use Settings, Providers, Custom provider.
¿Por qué falla Cline con modelos gratuitos?
La mayoría de los fallos vienen de modelos con llamadas a herramientas débiles o de una ventana de contexto pequeña. Seleccione un modelo con llamadas a herramientas y 128K de contexto, y active Use Compact Prompt para modelos más pequeños.
Guías relacionadas
- Modelos de IA gratuitos en VS Code
- Continue con una API gratuita de LLM
- Mejores API gratuitas de modelos para programar
- LLM API gratuita con llamadas a funciones
- Cómo usar Claude Code gratis
Fuentes
- Cline docs: OpenAI Compatible provider (revisado 20 November 2026)
- Cline docs: running models locally (revisado 20 November 2026)
- Kilo docs: custom models (revisado 20 November 2026)
- Kilo docs: OpenAI Compatible provider (revisado 20 November 2026)
- Roo Code repository (archived) (revisado 20 November 2026)
- Roo Code docs: settings management (revisado 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (revisado 20 November 2026)