Use OpenCode con una API de LLM gratuita
OpenCode es un agente de programación de código abierto para la terminal y el escritorio. Acepta cualquier proveedor compatible con OpenAI. Esta guía conecta OpenCode con modelos gratuitos a través de FreeLLMAPI. Un comando escribe la configuración y guarda la clave.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Paso 1: Instale FreeLLMAPI
FreeLLMAPI es una pasarela de código abierto. Se ejecuta en su computadora con Docker y reúne los niveles gratuitos de 45 proveedores detrás de una sola clave.
Instale en macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashAbra http://localhost:3001. Añada al menos dos claves de proveedores gratuitos en la página Keys. Google AI Studio y Groq dan cada uno una clave gratuita en pocos minutos. Copie su clave unificada de la misma página.
Paso 2: Conecte OpenCode con un comando
Un comando
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeEl comando hace tres cosas:
- Añade un proveedor
freellmapia~/.config/opencode/opencode.json. El proveedor enumera los modelos de su catálogo actual con sus límites de contexto. - Define
freellmapi/autocomo modelo predeterminado. - Guarda la clave en el archivo de credenciales de OpenCode,
~/.local/share/opencode/auth.json. No necesita una variable de entorno, ni en la CLI ni en la aplicación de escritorio.
El comando hace una copia de seguridad antes de escribir. Combina el proveedor nuevo, así que sus otros proveedores se mantienen. Si XDG_CONFIG_HOME o XDG_DATA_HOME están definidas, el comando usa esas carpetas.
Antes de iniciar una tarea larga, compruebe que la pasarela puede atender una solicitud ahora. Esta llamada enumera solo los modelos que tienen una clave utilizable en este momento:
Compruebe qué modelos están listos
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Un modelo con el estado exhausted tiene claves, pero todas están en su límite en este momento. Este estado se borra cuando terminan los periodos de enfriamiento. Ejecute npx freellmapi doctor para asegurarse de que las solicitudes de un cliente llegan a la pasarela. El registro de solicitudes del panel muestra cada llamada desde OpenCode. El encabezado de respuesta X-Routed-Via indica el proveedor y el modelo que respondieron a cada solicitud. Si una solicitud cambió de proveedor, el encabezado X-Fallback-Trail indica cada salto fallido y el motivo.
Configuración manual: el bloque de proveedor en opencode.json
Para configurarlo manualmente, añada este bloque a ~/.config/opencode/opencode.json, o a opencode.json de su proyecto. OpenCode usa @ai-sdk/openai-compatible para los endpoints /v1/chat/completions.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Después añada la clave. Inicie OpenCode, ejecute /connect, seleccione el proveedor freellmapi y pegue su clave unificada. El ID del proveedor en /connect debe coincidir con el ID de la configuración. Ejecute /models para seleccionar un modelo.
limit.contextes el número máximo de tokens de entrada del modelo.limit.outputes el número máximo de tokens que puede generar.- El
modelde nivel superior usa el formatoprovider/model. Sin él, OpenCode mantiene el modelo que usaba antes. - Cada ID de modelo que quiera usar debe estar en el mapa
models. Añada más IDs desdeGET /v1/models.
providers. La documentación indica que el formato V1 anterior sigue siendo compatible. El comando de configuración de FreeLLMAPI escribe el formato V1.Elija modelos para OpenCode
OpenCode es un agente. Lee archivos, los edita y ejecuta comandos mediante llamadas a herramientas. Cada solicitud lleva un prompt de sistema, definiciones de herramientas y contenido de archivos. Use modelos con llamadas a herramientas y una ventana de contexto amplia.
| 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 freellmapi/auto para que el enrutador seleccione un modelo para cada solicitud. Añada auto:smart o auto:fast al mapa models para dirigir las solicitudes por inteligencia o por velocidad. También puede añadir un perfil con nombre, por ejemplo auto:coding, después de crearlo en el panel.
Límites de uso y sesiones largas
Una tarea de agente puede enviar decenas de solicitudes. Un solo nivel gratuito agota una tarea larga con rapidez. FreeLLMAPI cuenta las solicitudes y los tokens de cada clave. Cuando un proveedor envía un error 429, el enrutador envía la solicitud al siguiente modelo de la cadena, y la sesión continúa.
- Añada claves de cuatro o más proveedores. Más proveedores dan más solicitudes por día.
- Active el traspaso de contexto con
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchen el.envde FreeLLMAPI. Cuando cambia el modelo, el modelo siguiente recibe una nota breve que indica que continúa una tarea. - Las sesiones fijas mantienen una conversación en un mismo modelo durante 30 minutos. Así el agente se mantiene coherente.
- Inicie una sesión nueva para cada tarea. Un contexto más pequeño usa menos tokens por solicitud.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| "Invalid API key" con una clave válida | Un apiKey vacío en la configuración reemplaza la clave de /connect | Elimine apiKey de options, o ejecute setup-opencode otra vez |
| OpenCode no usa el proveedor nuevo | El model de nivel superior no está definido | Defina "model": "freellmapi/auto" |
| Modelo no encontrado | El ID del modelo no está en el mapa models del proveedor | Añada el ID al mapa, o ejecute setup-opencode otra vez |
La clave {env:VAR} está vacía | OpenCode reemplaza una variable sin definir por una cadena vacía | Exporte la variable en la misma shell, o guarde la clave con /connect |
| Fallan las llamadas a herramientas | El modelo tiene llamadas a herramientas débiles | Seleccione un modelo de la tabla anterior |
| « Todos los modelos con límite de uso después de 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 OpenCode gratis?
Sí. OpenCode es de código abierto. Conéctelo a FreeLLMAPI como proveedor compatible con OpenAI. La pasarela envía cada solicitud a niveles gratuitos de proveedores, así que la inferencia cuesta $0.
¿Cómo añado un proveedor personalizado compatible con OpenAI a OpenCode?
Añada un proveedor en opencode.json con npm definido como @ai-sdk/openai-compatible, options.baseURL y un mapa models. Después ejecute /connect para guardar la clave y /models para seleccionar un modelo.
¿Qué modelo gratuito es el mejor para OpenCode?
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. Use freellmapi/auto para que el enrutador seleccione uno.
¿Dónde guarda OpenCode las claves de API?
Las claves añadidas con /connect van a ~/.local/share/opencode/auth.json. El comando de configuración de FreeLLMAPI escribe la clave allí, así que tanto la CLI como la aplicación de escritorio la encuentran.
Guías relacionadas
- Use Aider con una API de LLM gratuita
- Use Codex CLI con modelos gratuitos
- Cómo usar Claude Code gratis
- Mejores API gratuitas de modelos para programar
- URL base gratuitas compatibles con OpenAI
Fuentes
- OpenCode docs: providers (V1 config) (revisado 20 November 2026)
- OpenCode docs: config (revisado 20 November 2026)
- OpenCode docs: migrate from V1 (revisado 20 November 2026)
- FreeLLMAPI CLI generators (revisado 20 November 2026)
- FreeLLMAPI docs: context handoff (revisado 20 November 2026)