Tu IA llega al límite.
Prepara un plan B.

Imagina que estás preparando una entrega con un asistente de código. El proveedor responde «límite alcanzado». Tienes otra cuenta o una API disponible, pero toca cambiar la configuración, averiguar qué modelo puedes usar y comprobar que la herramienta sigue funcionando.

El objetivo de esta guía: que tu herramienta pida siempre work-backup. OmniRoute intentará tu modelo principal y, ante un fallo que permita reintentar, podrá usar el de reserva. Cambiarás el orden en un panel, sin reconfigurar cada aplicación.

OmniRoute es un programa de código abierto que ejecutas en tu ordenador o servidor. Recibe las peticiones de herramientas compatibles, elige una conexión y adapta los formatos admitidos. La IA sigue ejecutándose en el proveedor que has elegido, salvo que conectes un modelo local.

Capacidades documentadas: Combos y selección de modelos ↗ · Uso, cuotas y costes ↗.

Sí: pasar a otro modelo cuando se agota una cuota es uno de sus usos principales. La condición es tener otra conexión válida, con capacidad disponible y configurada para recibir esa petición.

Un fallback es un segundo intento con una alternativa. En un combo de prioridad, OmniRoute prueba el primer candidato elegible; si recibe un error recuperable, como un 429, puede avanzar al siguiente. También puede evitar temporalmente una conexión que sabe que está limitada.

No todas las claves tienen cuotas separadas: dos claves del mismo proyecto pueden compartir límite. Y un fallo de Internet afectará a todos tus proveedores remotos. Elige un respaldo que reduzca el problema que realmente tienes.

El router reenvía lo que la herramienta incluye en la petición; no importa por arte de magia tu historial del chat web de ChatGPT o Claude. Al configurar una reserva, también eliges otro posible destinatario de tus mensajes.

Los nombres se parecen, pero son proyectos diferentes. Ambos pueden darte una entrada común a varios modelos. OpenRouter también tiene fallback, tanto entre proveedores de un modelo como entre modelos configurados.

También puedes conectar OpenRouter como proveedor de OmniRoute. Tiene sentido si lo quieres como una de varias alternativas; si cubre por sí solo tu necesidad, quizá no necesites ambos. Esta es una elección de arquitectura, no una competición por tener más funciones.

OpenRouter: fallback entre modelos ↗ · Selección de proveedores ↗ · Claves propias (BYOK) ↗.

OmniRoute incluye conectores para algunas suscripciones. Eso no hace que cualquier plan funcione en cualquier aplicación. Hay que distinguir el conector técnico, el acceso de tu cuenta y los usos que permite el proveedor.

ChatGPT: acceso mediante el conector Codex

OmniRoute ofrece OpenAI Codex con inicio de sesión OAuth. OpenAI documenta el acceso a Codex con ChatGPT y, por separado, el acceso con clave API. El conector de OmniRoute depende de esa integración: requiere que tu cuenta tenga acceso y cuota, y su compatibilidad puede cambiar. No equivale a convertir todos los modelos o funciones del chat web en una API.

Si usas OpenAI → API Key, el consumo se factura en OpenAI Platform; no utiliza los créditos incluidos de tu plan ChatGPT. Autenticación oficial de Codex ↗.

Claude: conector técnico y uso permitido son cosas distintas

OmniRoute también incluye un conector OAuth de Claude Code. Anthropic reserva las credenciales de suscripción para el uso ordinario de sus aplicaciones y no permite que terceros enruten solicitudes con planes Free, Pro o Max en nombre de sus usuarios. Para integrar Claude en una aplicación, esta guía utiliza Anthropic → API Key, con facturación propia.

Usar tu suscripción en Claude Code sin modificar es un caso distinto de convertirla en el backend de un chatbot para visitantes. Revisa las condiciones para tu caso; no copies cookies ni tokens del navegador. Autenticación y credenciales de Anthropic ↗.

Instala Node.js 24 LTS ↗ si aún no lo tienes. Abre Terminal en macOS/Linux o PowerShell en Windows y comprueba que estos comandos muestran una versión:

node --version
npm --version

Usamos OmniRoute 3.8.50 para que los pasos tengan una versión concreta. El paquete admite Node 22.22.2 o posterior de la rama 22, y las ramas 24 a 26; Node 24 LTS es una opción sencilla. Requisitos del paquete ↗.

macOS o Linux

export OMNIROUTE_SERVER_HOST=127.0.0.1
npx omniroute@3.8.50 --no-open --no-tray

$env:OMNIROUTE_SERVER_HOST="127.0.0.1"
npx omniroute@3.8.50 --no-open --no-tray

Si npm pregunta si puede instalar el paquete, responde y. La primera descarga puede tardar varios minutos. Espera al mensaje OmniRoute is running! y abre http://localhost:20128.

La variable de la primera línea limita el acceso a tu ordenador. --no-open deja que abras tú el navegador y --no-tray mantiene el proceso en esta terminal. Para este tutorial, deja desactivados los túneles y el acceso remoto.

En una instalación nueva de esta versión, la contraseña inicial del paquete es CHANGEME. Entra y cámbiala por una propia en Settings → Security antes de conectar una cuenta. Si ya habías configurado OmniRoute, utiliza tu contraseña existente.

Referencia: instalación oficial de OmniRoute ↗.

Abre Providers en el panel. Vamos a preparar un principal y una reserva; no basta con guardar una sola conexión. Para la ruta GPT + Claude:

1. GPT: crea una clave en OpenAI Platform ↗ y comprueba que tu proyecto tiene acceso y facturación. En OmniRoute, abre OpenAI → Add Connection, añade la clave y guarda.
2. Claude: crea una clave en Claude Console ↗. En OmniRoute, abre Anthropic → Add Connection, añade la clave y guarda.
3. Pon nombres reconocibles a las conexiones. En cada ficha, copia el ID completo de un modelo que puedas usar, incluido el prefijo que muestra OmniRoute.
4. Revisa el precio y los límites de ambos en sus consolas. El modelo de reserva también puede generar consumo.

Para un modelo local, añade su conexión compatible y comprueba la URL desde la máquina que ejecuta OmniRoute. Un modelo local puede evitar depender de una cuota remota, pero necesita estar encendido y tener capacidad suficiente para tu tarea.

Conexiones de proveedores ↗.

Abre Playground y selecciona el ID concreto de tu modelo principal. Envía una tarea pequeña y útil:

Redacta un correo de tres frases para avisar a un cliente de que su entrega se retrasa un día.

Repite la prueba seleccionando el modelo de reserva. Ambos deben responder por separado antes de combinarlos. Una tarjeta guardada o un modelo en el catálogo no demuestran que tengas permiso o saldo para usarlo.

En Request Logs, comprueba proveedor, modelo y resultado de cada petición. Si lo vas a usar con un agente de código, después prueba también una tarea pequeña con herramientas: responder texto es solo la primera comprobación.

Un combo es un nombre que representa una lista de alternativas y una regla para elegirlas. Crearemos work-backup; tu aplicación enviará ese nombre en lugar del ID de un modelo.

1. Abre Combos → Create Combo.
2. En Basics, escribe work-backup como nombre y pulsa Next.
3. En Steps, elige proveedor, modelo y cuenta del principal, y pulsa Add step. Repite con la reserva. Deja el principal en primer lugar.
4. En Strategy, elige Priority (priority). Esta política respeta tu orden de preferencia entre los candidatos disponibles. Mantén el resto de opciones en sus valores iniciales para esta prueba.
5. En Review, comprueba los dos pasos y guarda el combo.

Ejemplo de orden: un GPT al que tienes acceso → un Claude que ya has probado. Si prefieres Claude como principal, invierte el orden. Las alternativas deben ser compatibles con tu herramienta.

Nombres de combo y estrategias ↗ · Compresión ↗.

Crea una clave en API Keys de OmniRoute para tu herramienta. Es la clave de acceso al gateway, distinta de las claves de los proveedores que guardaste en Providers.

Para comprobarlo sin configurar un editor, abre otra terminal y ejecuta esta petición. Sustituye el marcador de la clave; mantén abierta la terminal del servidor.

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer TU_CLAVE_DE_OMNIROUTE" \
  -H "Content-Type: application/json" \
  -d '{"model":"work-backup","messages":[{"role":"user","content":"Explica qué es una API en dos frases."}],"stream":false}'

$headers = @{ Authorization = "Bearer TU_CLAVE_DE_OMNIROUTE" }
$body = @{
  model = "work-backup"
  messages = @(@{ role = "user"; content = "Explain an API in two sentences." })
  stream = $false
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "http://localhost:20128/v1/chat/completions" -Method Post -Headers $headers -ContentType "application/json" -Body $body

Una respuesta correcta incluye el texto en choices[0].message.content. Mira los registros para identificar el modelo que la atendió; no hace falta que el contenido sea idéntico en cada intento.

Después configura esos mismos tres campos en tu herramienta compatible. No son ajustes del chat web de ChatGPT o Claude. localhost sirve cuando la herramienta y OmniRoute corren en la misma máquina; dentro de Docker apunta al propio contenedor.

Comprueba lo que importa antes de depender de ello

• El principal y la reserva responden por separado.
• La petición usa work-backup y los registros muestran el destino esperado.
• La reserva admite el contexto y las herramientas que necesita tu aplicación.
• Conoces el coste y la cuota de las alternativas que has autorizado.

Ensayo sin agotar tu cuota: crea un segundo combo, backup-check, con los mismos pasos. Quita el principal solo de esa copia y repite la petición cambiando el campo model a backup-check. Comprueba que responde la reserva. Esto valida la ruta de respaldo; no simula por sí solo un error 429. Conserva work-backup con sus dos pasos.

Solicitud: model = skoa-fallback-lab, strategy = priority
1. primary → HTTP 429
2. backup  → HTTP 200
Cliente    → HTTP 200, contenido: BACKUP_OK

Si algo falla

Para detenerlo, pulsa Ctrl+C. Repite el comando de arranque para volver a usarlo; la configuración persiste. Mientras OmniRoute esté apagado, las herramientas que apuntan a él no tendrán ese gateway disponible.

Qué hemos comprobado

Arranque del paquete npm 3.8.50 en macOS con Node 22.22.3, panel local, creación de un combo y cambio real entre dos servicios simulados ante un 429. No se han conectado cuentas ChatGPT/Claude ni consumido sus APIs de pago durante esta revisión. Debes validar tus conexiones y tu cliente con sus modelos reales.

Revisado el 21 de septiembre de 2026. Las ilustraciones son diagramas explicativos. Los modelos, cuotas y conectores pueden cambiar.

Para seguir aprendiendo

• OmniRoute · GitHub ↗
• OmniRoute · Combos ↗
• OmniRoute · Usage & quotas ↗
• OpenAI · Codex authentication ↗
• Anthropic · Authentication & credentials ↗
• OpenRouter · Model fallbacks ↗

Como referencia de aprendizaje práctico desde cero: midudev · Curso de OpenCode ↗. Trata sobre OpenCode, no es la fuente técnica de este tutorial de OmniRoute.

¿Quieres conectar un chatbot a tus datos? Continúa con Pi y Docker →