Cómo instalar OpenCode en Linux y Termux y usar modelos de IA gratis con OpenRouter
OpenCode es un agente de programación de código abierto que funciona desde la terminal y permite utilizar modelos de inteligencia artificial para trabajar directamente sobre proyectos de software.
A diferencia de un chatbot convencional, un agente de programación puede explorar un proyecto, localizar archivos, analizar código, realizar modificaciones y utilizar herramientas de desarrollo. OpenCode soporta más de 75 proveedores de modelos de IA y también permite utilizar modelos locales.
En este tutorial veremos:
- Cómo instalar OpenCode en Linux.
- Cómo instalar OpenCode en Android mediante Termux.
- Cómo crear una API Key de OpenRouter.
- Cómo conectar OpenRouter con OpenCode.
- Cómo utilizar modelos gratuitos.
- Qué modelos gratuitos son interesantes para programación.
- Cómo trabajar con proyectos grandes sin desperdiciar la ventana de contexto.
1. Instalar OpenCode en Linux
En una distribución Linux convencional, la instalación es bastante sencilla.
El método oficial es:
OpenRouter también documenta este mismo método para utilizar OpenCode con sus modelos.
Una vez terminada la instalación, se puede comprobar la versión:
Para ejecutar OpenCode:
Instalación alternativa mediante npm
Si Node.js y npm ya están instalados, también puede utilizarse:
Este es igualmente uno de los métodos de instalación documentados para OpenCode.
2. Instalar OpenCode en Android mediante Termux
La situación es diferente en Android.
Termux proporciona un entorno Linux sobre Android, pero Android utiliza Bionic como biblioteca C del sistema y existen otras diferencias respecto de una distribución GNU/Linux convencional.
Por este motivo existe el proyecto comunitario
opencode-termux, que construye OpenCode específicamente
para Android/Termux sobre arquitectura ARM64 (aarch64). El
proyecto recompila componentes necesarios para que OpenCode pueda
ejecutarse nativamente en este entorno.
Proyecto:
guysoft/opencode-termux
https://github.com/guysoft/opencode-termux
Comprobar la arquitectura
En Termux:
Para utilizar estos paquetes debe aparecer:
aarch64
Actualizar Termux
Instalar las herramientas necesarias:
Descargar OpenCode
Es recomendable consultar primero las releases del proyecto:
https://github.com/guysoft/opencode-termux/releases
Por ejemplo, una versión comprobada es OpenCode 1.17.9 para
Android/Termux aarch64, publicada como release v0.2.1.
Puede descargarse así:
Comprobar el archivo:
A continuación instalarlo:
Y asegurarse de que ripgrep esté instalado:
Finalmente:
Para iniciarlo:
El proyecto opencode-termux también ofrece otros
formatos de instalación, incluyendo un ejecutable independiente y
paquetes para Pacman.
Nota: OpenCode evoluciona rápidamente. Antes de instalarlo en Termux conviene consultar la página de Releases y utilizar la versión más reciente compatible, en lugar de asumir que el número de versión mostrado en este tutorial continúa siendo el último.
3. ¿Qué es OpenRouter?
OpenCode necesita un modelo de inteligencia artificial para realizar su trabajo.
Puede conectarse directamente con numerosos proveedores, pero una alternativa especialmente interesante es OpenRouter.
OpenRouter funciona como una puerta de acceso a muchos modelos de diferentes desarrolladores utilizando una única API.
Esto permite cambiar de modelo sin tener que configurar un proveedor diferente cada vez.
OpenCode incluye soporte integrado para OpenRouter.
Sitio:
4. Crear una API Key de OpenRouter
Crear una cuenta o iniciar sesión en OpenRouter y acceder a la sección de API Keys.
https://openrouter.ai/settings/keys
Crear una nueva API Key.
Normalmente tendrá un aspecto parecido a:
sk-or-v1-...
La API Key debe tratarse como una contraseña.
Nunca debe publicarse en GitHub, incluirse en capturas de pantalla ni compartirse con otras personas.
5. Conectar OpenRouter con OpenCode
Primero hay que entrar en la carpeta del proyecto que se desea trabajar.
Por ejemplo:
En Termux podría ser:
Ejecutar:
Dentro de OpenCode escribir:
/connect
Buscar:
OpenRouter
Seleccionarlo.
OpenCode solicitará la API Key.
Se pega la clave creada anteriormente y se confirma.
Este procedimiento es el recomendado tanto por la documentación de OpenCode como por la documentación de integración de OpenRouter.
6. Seleccionar un modelo
Dentro de OpenCode ejecutar:
/models
Aparecerá una gran cantidad de modelos.
Es importante comprender que:
Que un modelo aparezca en OpenRouter no significa que sea gratuito.
Pueden aparecer modelos comerciales y gratuitos en la misma lista.
OpenRouter mantiene una colección específica de modelos gratuitos:
https://openrouter.ai/collections/free-models
Los modelos gratuitos suelen identificarse mediante:
(free)
o mediante el identificador:
:free
La disponibilidad de estos modelos puede cambiar con el tiempo. OpenRouter advierte que no puede garantizar permanentemente qué opciones gratuitas estarán disponibles.
7. Modelos gratuitos interesantes para programación
No existe necesariamente un único modelo que sea el mejor para todas las tareas.
Un modelo puede ser mejor escribiendo código mientras que otro puede ser más apropiado para analizar repositorios grandes, utilizar herramientas o mantener conversaciones extensas.
A agosto de 2026, estas son algunas opciones especialmente interesantes disponibles gratuitamente a través de OpenRouter.
North Mini Code (free)
Una de las opciones más interesantes para utilizar específicamente con OpenCode es:
North Mini Code (free)
No se trata simplemente de un modelo conversacional general.
Cohere lo diseñó para:
- generación de código;
- ingeniería de software agentiva;
- utilización de terminal;
- llamadas a herramientas;
- razonamiento intercalado con acciones.
OpenRouter señala específicamente que fue entrenado para generalizar entre entornos de agentes como OpenCode y SWE-Agent.
Dispone de:
256K tokens de contexto
hasta 64K tokens de salida
y la variante gratuita aparece actualmente a:
$0/M input
$0/M output
Por ello es una excelente primera opción para tareas cotidianas de programación con OpenCode.
8. NVIDIA Nemotron 3 Ultra (free)
Otra alternativa muy potente es:
Nemotron 3 Ultra (free)
Es un modelo de razonamiento y orquestación de NVIDIA con arquitectura Mixture-of-Experts.
OpenRouter destaca su rendimiento en benchmarks relacionados con agentes y programación, incluyendo TerminalBench y SWE-Bench Verified.
Actualmente la variante gratuita mostrada por OpenRouter dispone de aproximadamente:
262K tokens de contexto
Es especialmente interesante para:
- comprender repositorios grandes;
- razonamiento complejo;
- arquitectura de software;
- tareas que involucran varios archivos;
- planificación;
- depuración compleja.
9. NVIDIA Nemotron 3 Super (free)
Para proyectos que requieren una ventana de contexto todavía mayor resulta particularmente interesante:
Nemotron 3 Super (free)
OpenRouter muestra actualmente una ventana de:
1.000.000 tokens
Es decir:
1M de contexto
OpenRouter lo describe como apropiado para coherencia agentiva prolongada, razonamiento entre documentos y planificación de múltiples pasos.
Para analizar repositorios excepcionalmente grandes, esta característica puede ser muy valiosa.
10. Laguna XS 2.1 (free)
Otra alternativa específicamente orientada al desarrollo de software es:
Laguna XS 2.1 (free)
OpenRouter lo clasifica dentro de programación y lo describe como un modelo para ingeniería de software y agentic coding, con herramientas y razonamiento.
Actualmente ofrece:
256K tokens de contexto
hasta 32K tokens de salida
Puede utilizarse como alternativa cuando otro modelo gratuito alcance sus límites.
Hay que tener en cuenta una consideración de privacidad: OpenRouter indica que, cuando Laguna XS 2.1 se utiliza gratuitamente, las entradas y salidas pueden emplearse para mejorar o entrenar los modelos.
Esto debe considerarse antes de utilizarlo con código privado o confidencial.
11. Una configuración práctica
En lugar de depender de un único modelo, puede resultar conveniente guardar varios como favoritos.
Por ejemplo:
La lista cambia con frecuencia, por lo que conviene consultar periódicamente:
https://openrouter.ai/collections/free-models
12. Utilizar OpenCode como agente de programación
La mejor manera de utilizar OpenCode es ejecutarlo desde la raíz del proyecto.
Por ejemplo:
En lugar de comenzar pidiéndole que modifique todo el proyecto, puede ser conveniente solicitar primero una inspección.
Por ejemplo:
Inspect the project structure and explain its architecture.
Do not modify any files yet.
Después puede solicitarse una tarea concreta:
Find the cause of this bug.
Explain the cause before modifying anything.
Y posteriormente:
Implement the fix.
Preserve the existing architecture and coding style.
Run the relevant tests after making the changes.
De esta forma OpenCode puede investigar el repositorio y actuar progresivamente.
13. Cómo trabajar con proyectos grandes
Los modelos tienen una ventana de contexto limitada.
Si una sesión acumula demasiado código, conversaciones y resultados de herramientas, OpenCode puede llegar a mostrar mensajes similares a:
Session too large to compact -
context exceeds model limit even
after stripping media
Esto no necesariamente significa que se haya agotado la cuota de la API.
Son conceptos diferentes:
Cuota de API: cuánto uso permite el proveedor.
Ventana de contexto: cuánta información puede procesar el modelo dentro de una petición o sesión.
Por este motivo, un modelo con una ventana de contexto mayor puede ser especialmente útil para repositorios grandes.
Sin embargo, disponer de 256K o incluso 1M de contexto no significa que sea buena idea introducir todo el repositorio indiscriminadamente.
Es preferible solicitar:
Inspect the repository structure first.
Identify the files relevant to this task.
Read only the necessary files and then propose a solution.
en lugar de:
Read every file in this repository.
Esto reduce el consumo, evita llenar innecesariamente el contexto y facilita sesiones más largas.
14. Cambiar de modelo cuando sea necesario
Una de las ventajas de OpenRouter es poder cambiar fácilmente de modelo.
Dentro de OpenCode:
/models
Por ejemplo, puede utilizarse:
North Mini Code (free)
para implementar cambios concretos.
Si posteriormente hay que analizar una gran cantidad de código:
Nemotron 3 Super (free)
puede resultar más apropiado por su gran ventana de contexto.
Si un modelo gratuito alcanza temporalmente su límite, puede seleccionarse otro.
15. Una combinación interesante
Una configuración sin depender de un único modelo podría quedar conceptualmente así:
OpenCode
│
▼
OpenRouter
│
┌─────────────────┼─────────────────┐
│ │ │
▼ ▼ ▼
North Mini Code Nemotron 3 Ultra Nemotron 3 Super
Free Free Free
Coding agent Razonamiento Gran contexto
│
▼
Laguna XS 2.1 Free
Alternativa
De esta manera se puede elegir el modelo en función de la tarea en lugar de intentar utilizar el mismo para absolutamente todo.
16. Enlaces útiles
OpenCode
Documentación de OpenCode
Proveedores compatibles con OpenCode
https://opencode.ai/docs/providers/
OpenCode para Termux
https://github.com/guysoft/opencode-termux
Releases para Termux
https://github.com/guysoft/opencode-termux/releases
OpenRouter
Crear API Keys en OpenRouter
https://openrouter.ai/settings/keys
Integración OpenRouter + OpenCode
https://openrouter.ai/docs/cookbook/coding-agents/opencode-integration
Modelos gratuitos de OpenRouter
https://openrouter.ai/collections/free-models
Entonces
OpenCode permite convertir la terminal en un entorno de programación asistido por agentes de inteligencia artificial.
En Linux puede instalarse directamente mediante el instalador
oficial, mientras que en Android/Termux existen builds comunitarias
adaptadas específicamente a aarch64.
Al combinar OpenCode con OpenRouter se obtiene acceso a numerosos modelos mediante una sola API Key, incluyendo modelos que actualmente ofrecen inferencia gratuita.
Para programación agentiva, North Mini Code resulta especialmente interesante por estar diseñado para tareas de ingeniería de software y agentes como OpenCode. Para razonamiento y repositorios grandes, la familia NVIDIA Nemotron ofrece alternativas con ventanas de contexto considerablemente mayores.
No obstante, los modelos, precios, límites y opciones gratuitas de OpenRouter cambian con el tiempo. Antes de comenzar un trabajo importante conviene comprobar que el modelo seleccionado continúa marcado como Free y revisar sus condiciones de uso.
Con esta configuración es posible utilizar OpenCode como agente de programación tanto desde un ordenador Linux como desde un dispositivo Android con Termux, y cambiar de modelo según las necesidades de cada proyecto.
Comentarios
Publicar un comentario