Instalar OmniRoute, OpenCode y Cline en VS Code

¿Cansado de pagar suscripciones caras de AI Assistants o quedarte sin créditos en medio de un refactor crítico? En esta guía aprenderás a integrar omniroute opencode cline para desplegar tu propio router local de Inteligencia Artificial 100% gratuito e ilimitado en Visual Studio Code y tu terminal.

omniroute opencode cline entorno de desarrollo e inteligencia artificial

📐 1. Arquitectura de OmniRoute, OpenCode y Cline

Para aprovechar al máximo el ecosistema de omniroute opencode cline, utilizaremos una arquitectura centralizada donde OmniRoute actúa como proxy y balanceador local, traduciendo peticiones estándar en un único punto de acceso:

[ Proveedores de IA Gratuitos ]
 ├── OpenCode Zen (Nemotron 3)
 ├── Kiro / Claude (OAuth)
 └── Pollinations (Keyless)
            │
            ▼
 [ Servidor Local OmniRoute ] ⚡ http://localhost:20128
 (Enruta, balancea y gestiona la carga)
            │
            ├──────────────────────┐
            ▼                      ▼
  [ Agente OpenCode ]    [ Extensión Cline ]
    (En Terminal)           (En VS Code)

🛠️ 2. Requisitos Previos e Instalación Global

Antes de poner en marcha la suite de omniroute opencode cline, asegúrate de contar con Node.js v22 LTS o superior en el PATH global de tu sistema operativo.

Opción A: Chocolatey Recomendado

Abre PowerShell como Administrador y ejecuta:

choco install nodejs-lts -y

Opción B: Winget Windows

Abre la consola e instala directamente:

winget install OpenJS.NodeJS.LTS

Tras reiniciar la terminal, confirma la disponibilidad global comprobando las versiones instaladas:

node -v
npm -v

🚀 3. Despliegue del Servidor OmniRoute

OmniRoute es el motor central del stack omniroute opencode cline. Es un router ligero basado en Node.js que unifica endpoints y maneja el protocolo OpenAI Compatible de forma local.

# 1. Clona el repositorio oficial
git clone https://github.com/diegosouzapw/OmniRoute.git

# 2. Accede al directorio e instala dependencias
cd OmniRoute
npm install

# 3. Inicia el servidor local en modo desarrollo
npm run dev

🎉 Servidor en Ejecución

El panel de control quedará accesible inmediatamente en http://localhost:20128 (Contraseña por defecto en entorno dev: CHANGEME).

🔌 4. Configuración de Proveedores Gratuitos (Top 3)

Accede al dashboard en tu navegador y navega a la sección Providers para conectar los modelos que alimentarán tu flujo de omniroute opencode cline:

🥇 1. OpenCode Zen Top Código

Acceso a Nemotron 3 Ultra Free (NVIDIA) y MiMo V2.5 Free (Xiaomi).

Configuración: Elige Proveedor de claves API > opencode. Obtén tu clave en opencode.ai/zen con GitHub y valida.

🥈 2. Kiro AI Claude Free

Aprovecha la inteligencia del modelo Claude mediante autenticación transparente.

Configuración: Selecciona Proveedor de OAuth > kiro y autoriza el flujo web.

🥉 3. Pollinations Keyless

Ideal como vía de respaldo infalible sin requerir registro de usuario ni claves.

Configuración: Elige Proveedor de claves API > pollinations e introduce sk-test como clave simbólica.

💻 5. Integración del Agente OpenCode en Terminal

OpenCode es el cliente de terminal dentro del ecosistema omniroute opencode cline. Instala el CLI oficial de forma global:

npm install -g opencode-ai
opencode --version

Para vincular OpenCode a tu instancia local de OmniRoute, ejecuta el script de autoconfiguración:

node bin/omniroute.mjs setup-opencode --base-url http://localhost:20128 --api-key sk-omniroute

🛠️ Fix Técnico Integrado (Zod Schema v1.18.9+)

Para evitar el fallo Missing key limit.output o Missing key limit.context causado por esquemas estrictos en versiones recientes de OpenCode, la herramienta inyecta automáticamente los límites contextuales predeterminados (context: 128000, output: 8192).

Para ejecutar una instrucción directa en tu proyecto:

opencode -m omniroute/auto run "Analiza la arquitectura del proyecto y enumera sus componentes principales"

🧩 6. Configuración de Cline en Visual Studio Code

Por último, configuraremos el componente visual del stack omniroute opencode cline. Instala la extensión Cline en VS Code (Ctrl+Shift+X). Pulsa el icono del engranaje (⚙️) y aplica los siguientes ajustes:

Campo en Ajustes de Cline	Valor Exacto que Debes Escribir	Propósito / Explicación
API Provider	`OpenAI Compatible`	Habilita el protocolo estándar OpenAI.
Base URL	`http://localhost:20128/v1`	Endpoint local de OmniRoute (¡requiere incluir `/v1`!).
API Key	`sk-omniroute`	Acepta cualquier string iniciado por `sk-`.
Model ID	`omniroute/auto`	Aplica enrutamiento y balanceo automático al mejor modelo.

O automatiza este ajuste en un solo paso desde tu consola:

node bin/omniroute.mjs setup-cline

🚨 7. Troubleshooting y Solución a Fallos Comunes

❌ Fallo 1: ECONNREFUSED 127.0.0.1:20128

Causa: El servicio local de OmniRoute está apagado.
Solución: Ejecuta npm run dev en la carpeta de OmniRoute y mantenlo activo mientras programas.

❌ Fallo 2: Puerto Ocupado (PID Active Error)

Causa: Existe un proceso colgado en el puerto 20128.
Solución en PowerShell: Mata el proceso activo especificando su PID:

taskkill /PID 988 /F

❌ Fallo 3: Invalid API Key en Proveedores Gratuitos

Causa: Dejar el campo API Key en blanco en proveedores keyless.
Solución: Rellena siempre el input con cualquier texto genérico (ej. free o sk-test).