Qué es OmniRoute (resumen rápido)

Es un gateway/proxy MIT open-source que centraliza 290+ proveedores de IA (90+ con capa gratuita) detrás de un único endpoint compatible con OpenAI (http://localhost:20128/v1). Se conecta con Claude Code, Cursor, Copilot, Cline, etc., y hace fallback automático entre proveedores cuando uno se queda sin cuota. Corre en local (Node.js), con dashboard incluido en el mismo puerto.

Importante antes de empezar: no es un producto de Anthropic, es un proyecto de terceros. Si le vas a dar a un agente acceso de shell para instalar y ejecutar cosas, revisa lo que hace paso a paso la primera vez (instala paquetes globales de npm, abre un puerto local, y opcionalmente puede hacer MITM/TPROXY para interceptar tráfico — funcionalidad avanzada que no necesitas para el uso básico).

1) Prompt para el agente de IA (cópialo tal cual)

Si tienes Claude Code, Cursor u otra CLI agéntica con terminal, pégale esto:

YAML
Quiero que instales y configures OmniRoute (https://github.com/diegosouzapw/OmniRoute) 
en esta máquina y lo dejes funcionando end-to-end. Sigue estos pasos y verifica cada uno 
antes de continuar:

1. Comprueba que tengo Node.js >=22 <23 o >=24 <27 instalado (`node -v`). Si no, avísame.
2. Instala OmniRoute globalmente: `npm install -g omniroute`
3. Arráncalo: `omniroute` (debe levantar el dashboard en http://localhost:20128)
4. Verifica que el proceso responde: `curl http://localhost:20128/v1/models` 
   (puede devolver vacío hasta que conectemos un proveedor, eso es normal)
5. Conecta un proveedor gratuito sin API key desde el dashboard: entra a 
   http://localhost:20128 → Providers → Add Provider, y activa uno de estos 
   (dime cuál prefieres o elige "OpenCode Free"): Kiro AI, OpenCode Free, o Pollinations.
   Si necesitas hacerlo por mí, guíame paso a paso porque requiere clicks en el dashboard.
6. Genera una API key desde Dashboard → API Keys, y guárdala en variable de entorno 
   OMNIROUTE_API_KEY en mi shell (~/.zshrc o ~/.bashrc, según cuál use).
7. Configura Claude Code para que use OmniRoute como backend: usa 
   `omniroute setup-claude` para generar el perfil, y luego `omniroute launch` 
   para lanzar Claude Code apuntando a OmniRoute con modelo "auto".
8. Verifica el enrutamiento: haz una petición de prueba y confírmame en el log del 
   dashboard (http://localhost:20128/dashboard/logs) que la petición pasó por OmniRoute.
9. Al final dame un resumen de: puerto en uso, proveedor(es) conectado(s), dónde quedó 
   guardada la API key, y el comando exacto para volver a lanzar Claude Code vía 
   OmniRoute en el futuro.

Si algo falla, dime en qué paso y qué error salió antes de improvisar soluciones.

Esto cubre instalación, arranque, conexión de proveedor gratuito, generación de key y conexión con Claude Code — que es probablemente lo que más te interesa dado que ya trabajas con harnesses agénticos.

2) Pasos manuales (por si quieres hacerlo tú o supervisar al agente)

Notas útiles

  • Puerto por defecto: 20128 (dashboard y API en el mismo puerto, cambia con PORT).
  • Modelo auto: deja que OmniRoute elija el mejor proveedor disponible según cuota, costo y latencia — es lo que le pones como model en tu herramienta.
  • Otras CLIs: si además usas Codex, Cursor, Cline, etc., el mismo endpoint (http://localhost:20128/v1) sirve para todas — solo cambia el comando de setup (omniroute launch-codex, por ejemplo).
  • Guía completa de comandos: docs/reference/CLI-TOOLS.md del repo cubre las 33 herramientas soportadas si necesitas configurar más de una.