OmniRoute es un gateway de IA gratuito y de código abierto que se ejecuta en tu computadora. Pone cientos de proveedores de IA detrás de una única dirección local, y así Claude Code, Codex y otras herramientas pueden usar esos modelos sin que cambies la configuración cada vez. Si un proveedor falla o llega a su límite, pasa al siguiente.

Antes de empezar

• Una computadora con macOS, Windows o Linux.
• Node.js 24 (LTS). OmniRoute también acepta la línea 22 desde la 22.22.2 y las versiones 25 y 26. Compruébalo con node --version.
• Claude Code o Codex instalados, si quieres usar OmniRoute con ellos.
• Ninguna cuenta de pago: puedes empezar solo con proveedores gratis.

Ejecutarlo en local no significa IA sin conexión. OmniRoute se ejecuta en tu máquina, pero cada solicitud se envía al proveedor elegido. Tus claves e inicios de sesión se guardan en tu computadora, cifrados.

1

Instálalo y abre el panel

Instálalo con npm:

TerminalCopiar

npm install -g omniroute

Después, inícialo:

TerminalCopiar

omniroute

El panel se abre solo en http://localhost:20128. Si no se abre, escribe esa dirección en el navegador. Deja la terminal abierta: OmniRoute tiene que seguir en marcha mientras lo usas.

2

Conecta proveedores gratis

En el panel, abre Providers y haz clic en Add Provider. Tres opciones funcionan sin clave y sin tarjeta:

• Kiro AI: modelos Claude gratis.
• OpenCode Free: varios modelos, sin inicio de sesión.
• Pollinations: acceso a GPT, Claude, Gemini y otros.

Elige uno y haz clic en Connect. Después puedes sumar cuentas de suscripción y claves de API; OmniRoute las usa todas juntas.

Según el proyecto, las cuotas gratis documentadas suman unos 1.510 millones de tokens al mes. El panel muestra cuánto has usado en /dashboard/free-tiers.

curl http://localhost:20128/v1/models -H "Authorization: Bearer TU_CLAVE"

omniroute launch

export OMNIROUTE_API_KEY="TU_CLAVE"

omniroute launch-codex --model auto

Ahorra tokens

Antes de enviar la solicitud, OmniRoute puede recortar el contexto, como registros y salidas de terminal repetidas. Según el proyecto, la combinación predeterminada (RTK seguido de Caveman) ahorra entre un 15% y un 95% de los tokens; en solicitudes con muchos registros, el rango documentado es de 78% a 95%. En el ejemplo del proyecto, una solicitud de 10.000 tokens llega al proveedor con unos 1.080. No cambias nada en tus herramientas.

Sigue todo en el panel

En Analytics ves qué modelos respondieron, cuántos tokens usaste y cuánto habría costado. En Monitoring/Logs ves cada solicitud.

Problemas comunes

• Tu herramienta no se conecta ("Can't connect"): OmniRoute no está en marcha. Abre una terminal y ejecuta omniroute.
• "Rate limit exceeded" o error 429: el proveedor gratis limitó las solicitudes. Espera un minuto, usa auto o conecta más proveedores.
• Cannot find module 'better-sqlite3' con npm 11: ejecuta npm approve-scripts better-sqlite3 e instala de nuevo.
• "Module did not self-register": tu versión de Node está fuera del rango compatible. Instala Node 24, reinstala con npm install -g omniroute y ejecuta omniroute.
• Claude Code ignora OmniRoute: si lo configuraste a mano, ANTHROPIC_BASE_URL no debe terminar en /v1, y hay que reiniciar Claude Code. Con omniroute launch, esto ya viene bien.
• Un proveedor con inicio de sesión dejó de funcionar: en el panel, abre el proveedor y haz clic en Reconnect, o quítalo y añádelo de nuevo.

Para revisar proveedores y puertos, ejecuta omniroute doctor.

OmniRoute es un proyecto de código abierto, con licencia MIT, creado por el desarrollador brasileño Diego Souza. Código y documentación: github.com/diegosouzapw/OmniRoute. Esta guía se escribió para la versión 3.8.50.