Programar con IA gratis: guía práctica de opencode + OpenRouter
Se puede programar todos los días con un agente de IA potente sin pagar nada. No hablo de una demo de cinco minutos: hablo de montar un flujo de trabajo real, con tu editor, tus proyectos y un agente que lee y escribe código.
La receta tiene dos piezas:
- opencode — el agente de programación (open source, corre en tu terminal).
- OpenRouter — la puerta de acceso a los modelos, incluida una tanda de modelos gratuitos.
Esta guía va de cero a un entorno funcionando, con los límites reales del plan gratis y cuándo merece la pena dar el salto de pago.
1. En una frase
Instalas opencode, le das una clave de OpenRouter y eliges un modelo con sufijo
:free. Ya estás programando con IA sin tarjeta.
El coste del plan gratis no es dinero: es límite de peticiones al día y calidad variable según el modelo. Lo veremos con números más abajo.
2. Las dos piezas
opencode
Es un agente de programación de código abierto. Se instala en tu máquina y trabaja sobre tus archivos: entiende el proyecto, propone cambios, los aplica y ejecuta comandos.
Está disponible en tres formatos:
- Terminal (TUI) — el clásico, y el que usaremos aquí.
- Aplicación de escritorio.
- Extensión de IDE.
No es un autocompletado: es un agente. Tú describes el objetivo, él inspecciona, edita y te enseña lo que ha hecho.
OpenRouter
Es una pasarela única a cientos de modelos de IA. En vez de darte de alta en diez proveedores distintos, usas una sola clave y eliges modelo por petición. Su API es compatible con el formato de OpenAI.
Lo interesante para esta guía: OpenRouter mantiene una familia de modelos gratuitos (los que terminan en :free) y un enrutador de modelos gratis que elige uno por ti.
3. Instalar opencode
El instalador oficial es el camino más rápido (macOS y Linux):
curl -fsSL https://opencode.ai/install | bash
Alternativas, según lo que ya uses:
| Vía | Comando |
|---|---|
| npm | npm install -g opencode-ai |
| Bun | bun install -g opencode-ai |
| pnpm | pnpm install -g opencode-ai |
| Yarn | yarn global add opencode-ai |
| Homebrew (macOS/Linux) | brew install anomalyco/tap/opencode |
| Arch Linux | sudo pacman -S opencode |
| Windows (recomendado) | Usar WSL |
| Windows (Chocolatey) | choco install opencode |
| Windows (Scoop) | scoop install opencode |
| Docker | docker run -it --rm ghcr.io/anomalyco/opencode |
Aviso: existe una versión 2 de opencode. Tanto la 1 como la 2 usan el comando
opencode, así que no conviven por defecto. Decide qué versión quieres antes de instalar.
En Windows, la propia documentación recomienda WSL: mejor rendimiento y compatibilidad completa.
4. Tu clave de OpenRouter
- Entra en el panel de OpenRouter y crea una API key.
- Cópiala (solo se muestra una vez).
- No la pegues en ningún archivo del proyecto. Los secretos se guardan en el gestor de credenciales de opencode, no en tu repo.
La clave es un simple Bearer token contra un único endpoint:
https://openrouter.ai/api/v1/chat/completions
5. Conectar opencode con OpenRouter
Con opencode ya instalado, abre tu terminal y ejecuta:
/connect
Busca OpenRouter en la lista y pega tu clave cuando la pida.
/connect
┌ API key
│ ●●●●●●●●●●●●●●●●●●●●
└ enter
¿Dónde queda la clave? opencode guarda las credenciales en:
~/.local/share/opencode/auth.json
Es un archivo local y personal. No lo subas a git.
Con eso hecho, OpenRouter ya está disponible: opencode trae muchos modelos de OpenRouter precargados, así que no tienes que configurar nada más para empezar.
6. Configurar opencode
opencode se configura con un archivo JSON (o JSONC, con comentarios). Su esquema es:
https://opencode.ai/config.json
Un ejemplo mínimo:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/<modelo>"
}
Dónde vive la configuración
Los archivos se fusionan, no se reemplazan: los ajustes que no chocan se conservan todos. El orden de precedencia (lo último gana) es, resumido:
- Config remota de la organización.
- Config global del usuario (
~/.config/opencode/opencode.json). - Config personalizada (
OPENCODE_CONFIG). - Config del proyecto (
opencode.jsonen el repo). - Directorios
.opencode/y variables en línea. - Config gestionada por el administrador (la que más manda).
Traducción práctica: pones tus preferencias en la global, y cada proyecto puede afinar lo suyo en su propio opencode.json.
Elegir modelo por defecto
La clave model usa el formato proveedor/modelo:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/google/gemma-4-31b-it:free"
}
Añadir o esconder modelos
Si OpenRouter saca un modelo que opencode aún no conoce, lo añades a mano:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openrouter": {
"models": {
"algun-modelo-nuevo": {}
}
}
}
}
Y si un proveedor expone un catálogo enorme y no quieres ruido en el selector:
{
"provider": {
"openrouter": {
"blacklist": ["modelo-que-no-quiero"],
"whitelist": ["modelo-que-si"]
}
}
}
- blacklist quita esos modelos del selector.
- whitelist deja solo esos y oculta el resto.
- Se pueden combinar: primero se filtra con whitelist y luego se quitan con blacklist.
7. Los modelos gratis
Aquí está el truco del plan gratis: OpenRouter publica versiones de coste cero de algunos modelos, marcadas con el sufijo :free.
Ejemplos del catálogo en el momento de escribir esto:
| Modelo | Contexto |
|---|---|
nvidia/nemotron-3.5-lightning:free |
1M |
thinkingmachines/inkling:free |
1M |
thinkingmachines/inkling-small:free |
1M |
nvidia/nemotron-3-ultra-550b-a55b:free |
1M |
nvidia/nemotron-3-super-120b-a12b:free |
262k |
dots-studio/dots-3-note-preview:free |
512k |
poolside/laguna-s-2.1:free |
262k |
poolside/laguna-xs-2.1:free |
262k |
cohere/north-mini-code:free |
256k |
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free |
256k |
google/gemma-4-31b-it:free |
262k |
google/gemma-4-26b-a4b-it:free |
262k |
liquid/lfm-2.5-2.6b:free |
64k |
nvidia/nemotron-3.5-content-safety:free |
128k |
La lista cambia: es un catálogo vivo. Puedes verla siempre actualizada en el navegador de modelos de OpenRouter filtrando por precio 0, o consultarla por API:
GET https://openrouter.ai/api/v1/models
El enrutador de modelos gratis
Si no quieres elegir a mano, existe un modelo especial:
openrouter/free
Es el Free Models Router: OpenRouter decide automáticamente qué modelo gratuito usar para cada petición. Perfecto para empezar sin pensar en cuál escoger.
8. También gratis: los modelos propios de opencode
OpenRouter no es la única puerta. opencode tiene su propio catálogo de modelos (la Console / OpenCode Zen), y ahí también hay una tanda de modelos gratuitos, con una ventaja: vienen probados y verificados por el propio equipo de opencode.
Los que su catálogo marca como gratis:
| Modelo | ID |
|---|---|
| Jev 1.13 Free | jev-1.13-free |
| DeepSeek V4.1 Flash Free | deepseek-v4.1-flash-free |
| Space Bunny Free | space-bunny-free |
| Cat Jam Free | cat-jam-free |
| LongCat 2.5 Preview Free | longcat-2.5-preview-free |
| Step 5 Preview Free | step-5-preview-free |
| Exo Free | exo-free |
| MiMo-V2.6-Flash Free | mimo-v2.6-flash-free |
| MiMo-V2.5 Free | mimo-v2.5-free |
| Nemotron 3 Ultra Free | nemotron-3-ultra-free |
| Nemotron 3.5 Lightning Free | nemotron-3.5-lightning-free |
| Nemotron 3.5 Super VL Free | nemotron-3.5-super-vl-free |
| Muse Spark 1.3 Contributor Free | muse-spark-1.3-contributor-free |
Cómo usarlos:
/connect # elige opencode y ve a opencode.ai/auth
/models # aparecen en la lista, incluidos los Free
Dos avisos honestos:
- Varios son gratis por tiempo limitado (los marcados Preview o limited time). Pueden desaparecer o pasar a pago sin avisar.
- El equipo de opencode tiene además OpenCode Go ($10/mes, Go Plus $40/mes): es su plan pago, cómodo y con acceso global estable, pero no es gratis y no entra en esta guía.
¿OpenRouter, opencode o los dos? No son excluyentes: puedes tener las dos claves conectadas y cambiar de modelo según lo que necesites. La ventaja de opencode es que sus gratis están curados por el equipo; la de OpenRouter es que su catálogo es mucho más amplio.
9. Los límites reales del plan gratis
Aquí está lo que casi nadie te cuenta, con los números que importan:
El límite de los modelos gratis depende de si alguna vez has comprado créditos.
| Situación | Límite de peticiones al día (modelos gratis) |
|---|---|
| Sin créditos comprados | 50 peticiones/día |
| Con ≥ 10 $ en créditos | 1.000 peticiones/día |
Dos ideas clave:
- 50 al día da de sobra para probar, aprender y hacer tareas pequeñas. Para trabajar a jornada completa con un agente, se queda corto enseguida.
- Comprar 10 $ una sola vez multiplica el límite por 20. No los gastas: solo hay que tenerlos ahí. Es, con diferencia, la mejor relación coste/beneficio de todo el sistema.
Además:
- Los límites son globales por cuenta: hacerte varias cuentas o varias claves no aumenta el cupo.
- Cada modelo puede tener su propio límite, así que si te topas con uno, puedes repartir la carga entre varios.
- Las respuestas de error traen cabeceras
X-RateLimit-*para que veas por dónde vas.
Consultar tu cupo desde la terminal
GET https://openrouter.ai/api/v1/key
Con tu clave, esa llamada te devuelve el crédito restante y los límites aplicables. Es la forma limpia de saber si te queda margen antes de lanzar una tarea larga.
10. Flujo de trabajo diario
Un día normal, en la terminal:
# 1. Colócate en tu proyecto
cd mi-proyecto
# 2. Arranca el agente
opencode
Y dentro de la interfaz:
/models # ver y cambiar de modelo
/connect # gestionar proveedores y claves
Trucos que ahorran frustración:
- Abre un proyecto por vez. El agente rinde mejor con un contexto acotado.
- Empieza con el Free Models Router (
openrouter/free) y, cuando veas qué modelo te responde bien, fíjalo como predeterminado. - Tareas pequeñas y verificables. «Añade este test», «arregla este error» rinde mucho más que «hazme la app».
- Revisa los diffs. Es un agente, no un oráculo: tú apruebas lo que entra.
- Si vas a agotar el cupo del día, reserva las tareas pesadas para el modelo que mejor te funcione y deja el resto para modelos menores.
Configuración de partida que funciona:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/free"
}
11. Cuándo el plan gratis NO te sirve
Seamos honestos, porque esto es lo que separa una guía útil de un anuncio:
- Volumen alto. 50 peticiones/día desaparecen en una sesión intensa. Con 1.000/día se trabaja bien, pero un uso profesional continuado pide otra cosa.
- Producción. Los propios modelos gratis avisan de que no están pensados para producción: límites bajos y disponibilidad variable.
- Tool calling. No todos los modelos pequeños ejecutan bien las llamadas a herramientas. Los gratuitos van de notable a flojo, y el agente depende de eso.
- Calidad puntera. Los modelos gratuitos suelen ser versiones menores. Para tareas complejas, un modelo de primera línea marca la diferencia.
El corte sensato: usa gratis para aprender, prototipar y tareas diarias pequeñas. En cuanto el agente sea parte de tu trabajo, compra 10 $ en OpenRouter (subes a 1.000/día sin gastarlos) y, si el volumen aprieta, paga solo el modelo que uses de verdad.
12. Checklist copia-pega
# 1. Instalar opencode
curl -fsSL https://opencode.ai/install | bash
# 2. (Alternativa macOS/Linux con Homebrew)
brew install anomalyco/tap/opencode
# 3. Crear clave en OpenRouter y conectarla
opencode
# dentro: /connect -> OpenRouter -> pegar clave
// ~/.config/opencode/opencode.json (config global)
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/free"
}
# 4. Ver y elegir modelos
# dentro de opencode: /models
# 5. Consultar cupo restante
curl -s https://openrouter.ai/api/v1/key \
-H "Authorization: Bearer TU_CLAVE"
13. Cierre
La barrera de entrada para programar con IA hoy es cero euros: un agente de código abierto y una pasarela con modelos gratuitos. Lo único que se paga es el límite de uso, y ese límite se entiende en cinco minutos: 50 peticiones al día, o 1.000 si tienes 10 $ de saldo parado.
Con eso montas un entorno real. El día que te sepa a poco, ya sabrás exactamente qué comprar y por qué.
Nota: este artículo describe el comportamiento de opencode y OpenRouter en el momento de escribirlo. El catálogo de modelos gratuitos y los límites cambian con frecuencia; comprueba los valores actuales en la documentación oficial de ambos proyectos antes de tomar decisiones.