- Acceso centralizado a cientos de modelos de lenguaje mediante una única API key de OpenRouter.
- Configuración versátil disponible tanto para interfaz de terminal (TUI) como para aplicación de escritorio.
- Gestión avanzada de modelos y costes mediante archivos de configuración JSON y pago por uso.
Conectar OpenCode con OpenRouter es probablemente la jugada más inteligente que puedes hacer para que tu trabajo de programación sea fluido. OpenCode no es el típico editor, sino un agente de codificación de código abierto que se mueve como pez en el agua tanto en la terminal (TUI) como en aplicaciones de escritorio para Windows, macOS y Linux, permitiéndote gestionar sesiones compartibles y aprovechar la integración con LSP para que el código vuele.
Lo mejor de todo es que, al integrarlo con OpenRouter, te olvidas de estar saltando de una API a otra. Tienes acceso unificado a más de 75 proveedores de LLM, desde los pesos pesados como Anthropic, Google o OpenAI, hasta opciones más ligeras o locales, todo gestionado con una única llave API y un sistema de pago por uso que te ahorra suscripciones mensuales engorrosas.
Cómo conseguir tu llave de acceso en OpenRouter
Antes de meterle mano a la configuración e intentar conectar OpenCode con OpenRouter , necesitas tu pase de entrada. Solo tienes que registrarte o entrar en tu cuenta de OpenRouter, ir directo a la sección de API Keys y generar una nueva. Asegúrate de copiarla bien, ya que suelen empezar por sk-or-v1-…, y guárdala en un sitio seguro porque será la que desbloquee cientos de modelos en tu entorno de desarrollo.
Configuración rápida en la Terminal (TUI)
Para los que preferimos la pantalla negra y la rapidez del teclado, el proceso es sencillísimo. Una vez instalado OpenCode (puedes usar el comando curl oficial para dejarlo listo en un momento), sigue estos pasos:
- Lanza OpenCode situándote en la carpeta de tu proyecto.
- Ejecuta el comando /connect y, cuando te lo pida, busca OpenRouter en la lista.
- Pega la API key que copiaste anteriormente.
- Usa el comando /models para elegir el cerebro que quieres que maneje tu código; verás que muchos modelos de OpenRouter ya vienen precargados.
Así de sencillo es conectar OpenCode con OpenRouter. A partir de aquí, todas tus peticiones se rutearán a través de OpenRouter, permitiéndote usar funciones como /plan para esbozar una estrategia o /build para generar el código real.
Puesta a punto en la aplicación de Escritorio
Si prefieres una interfaz más visual con pestañas y menús, la app de escritorio es tu sitio. En lugar de comandos, aquí el trabajo de conectar OpenCode con OpenRouter se gestiona desde la interfaz de usuario:
- Abre la aplicación y selecciona la carpeta de tu proyecto.
- Entra en Settings o usa la paleta de comandos para buscar «Connect provider».
- En el apartado de proveedores populares, haz clic en Connect sobre OpenRouter.
- Introduce tu clave API y confirma la operación.
Un detalle importante: si acabas de añadir la clave y no ves los modelos en el selector, reinicia la aplicación por completo. El catálogo de proveedores se carga al arrancar, por lo que un reinicio rápido suele solucionar el problema. Además, si ya habías configurado la terminal, la app de escritorio detecta las credenciales automáticamente.
Ajustes avanzados y el archivo de configuración
Para los que quieren tener el control total, OpenCode utiliza un archivo llamado opencode.json. Puedes tener uno específico en la raíz de tu proyecto o uno global en ~/.config/opencode/opencode.json. Aquí puedes añadir modelos que no vengan por defecto usando el slug de OpenRouter como clave.
Si quieres evitar que OpenCode te pregunte qué modelo usar cada vez que arrancas, puedes definir un modelo predeterminado en el config. Recuerda que la sintaxis correcta debe llevar el prefijo del proveedor, por ejemplo: openrouter/nombre-del-modelo. También puedes forzar un modelo específico al lanzar la herramienta usando la bandera -m o –model.
Gestión de credenciales y enrutamiento
Es útil saber que las claves que introduces mediante la interfaz o el comando /connect se guardan en un archivo llamado auth.json, ubicado generalmente en ~/.local/share/opencode/auth.json. Esto es lo que permite que la terminal y la app de escritorio compartan la misma sesión sin tener que repetir el proceso.
Además, OpenRouter te permite jugar con el enrutamiento de proveedores. Si necesitas que una petición sea gestionada por un proveedor upstream específico para mejorar la estabilidad o el coste, puedes cambiar automáticamente de modelo cuando una API falla añadiendo opciones de provider directamente en la configuración de cada modelo en tu JSON.
Solución de problemas comunes al conectar OpenCode con OpenRouter
A veces las cosas no salen a la primera cuando vas a conectar OpenCode con OpenRouter . Si te encuentras con errores de autenticación, verifica que la clave esté bien guardada ejecutando opencode auth list. Si un modelo no aparece, comprueba que el slug sea exacto en la web de OpenRouter, incluyendo cualquier símbolo como el ~ (por ejemplo, ~anthropic/claude-sonnet-latest).
En cuanto a los modelos gratuitos, algunos usuarios reportan fallos porque ciertos modelos free no soportan la llamada a funciones (tool use). En estos casos, la clave está en ajustar la baseURL y asegurarse de que el modelo seleccionado sea compatible con las capacidades de agente de OpenCode.
¿Por qué elegir este combo para programar?
La ventaja competitiva de usar OpenRouter con OpenCode es la flexibilidad absoluta. No estás encadenado a una suscripción mensual costosa; puedes operar bajo un modelo de pago por token, lo que es ideal para presupuestos ajustados. Además, cuentas con un sistema de failover automático: si un proveedor se cae o llegas al límite de tasa, OpenRouter redirige la petición a otro disponible para que no pares de programar.
Para quienes trabajan en equipo, esto facilita enormemente el control organizativo, ya que puedes monitorizar el gasto y poner límites presupuestarios desde el panel de actividad de OpenRouter, evitando sorpresas a final de mes mientras el equipo usa OpenCode para acelerar el desarrollo.
En definitiva, conectar OpenCode con OpenRouter transforma tu editor en una herramienta multimodelo capaz de saltar entre GPT, Claude o DeepSeek sin fricciones, gestionando todo desde una configuración centralizada y flexible que prioriza la privacidad y el control del gasto.
Redactor especializado en temas de tecnología e internet con más de diez años de experiencia en diferentes medios digitales. He trabajado como editor y creador de contenidos para empresas de comercio electrónico, comunicación, marketing online y publicidad. También he escrito en webs de economía, finanzas y otros sectores. Mi trabajo es también mi pasión. Ahora, a través de mis artículos en Tecnobits, intento explorar todas las novedades y nuevas oportunidades que el mundo de la tecnología nos ofrece día a día para mejorar nuestras vidas.