# OmniRoute: un plan B cuando tu IA alcanza el límite

Guía completa: https://www.skoa.online/es/blog/omniroute-chatgpt-claude/

OmniRoute 3.8.50 · Node.js 24 LTS · Revisado el 2026-09-21

## El problema que resolvemos

Tu herramienta pide siempre `work-backup`. OmniRoute intenta un modelo principal y puede pasar a uno de reserva ante un fallo recuperable, como un 429. Necesitas dos conexiones válidas, con acceso y cuota disponible. No amplía suscripciones ni repone saldo.

## 1. Arranque local

macOS / Linux:

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

Windows PowerShell:

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

Abre http://localhost:20128 y mantén la terminal abierta. En una instalación nueva de esta versión, entra con CHANGEME y cambia la contraseña en Settings → Security antes de conectar cuentas. Si ya lo tenías configurado, utiliza tu contraseña existente.

## 2. Dos conexiones que funcionen

Ruta GPT + Claude: Providers → OpenAI → Add Connection, con una clave de OpenAI Platform; Providers → Anthropic → Add Connection, con una clave de Claude Console. Ambas APIs tienen facturación propia. Comprueba precios y límites antes de la prueba.

También existe OpenAI Codex → OAuth para cuentas con acceso a Codex mediante ChatGPT. Es un conector de OmniRoute, sujeto a compatibilidad, cuotas y condiciones; no convierte todo ChatGPT en una API. Una reserva puede ser otro proveedor independiente o un modelo local compatible que ya tengas funcionando.

OmniRoute incluye un conector OAuth de Claude Code, pero su existencia no autoriza cualquier uso. Anthropic no permite a terceros enrutar planes Free/Pro/Max en nombre de sus usuarios. Para integrar una aplicación utiliza la API de Anthropic; no copies cookies ni tokens.

En Playground, prueba cada modelo por separado y revisa Request Logs. Una respuesta de texto no verifica por sí sola la compatibilidad con las herramientas de un agente.

## 3. Crear el combo

1. Combos → Create Combo.
2. Basics: nombre `work-backup` → Next.
3. Steps: elige proveedor, modelo y cuenta; Add step. Principal primero, reserva después.
4. Strategy: Priority (`priority`). Conserva las otras opciones iniciales.
5. Review: revisa y guarda los dos pasos.

El nombre exacto del combo se usa como modelo. `auto` es otro mecanismo; no llama automáticamente a este combo.

## 4. Usarlo desde la misma herramienta

Crea una clave en API Keys de OmniRoute. Es distinta de la clave del proveedor.

- Base URL de una app OpenAI-compatible: http://localhost:20128/v1
- API Key: la clave de OmniRoute
- Model: `work-backup`

Prueba en macOS / Linux:

```sh
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}'
```

Windows PowerShell:

```powershell
$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
```

Comprueba `choices[0].message.content` y el proveedor/modelo en los registros.

Claude Code necesita destinos Claude compatibles; Anthropic no da soporte a modelos ajenos a Claude mediante gateways. Su base URL nativa es http://localhost:20128, sin /v1. Para Codex CLI verifica el protocolo y las herramientas que admite tu proveedor.

## 5. Validar la reserva

Crea una copia llamada `backup-check`, quita el principal solo de esa copia y repite la petición con `model: backup-check`. Debe responder la reserva. Esto prueba la ruta de respaldo, no simula un 429. Conserva ambos pasos en `work-backup`.

SKOA verificó además un fallo controlado con OmniRoute real y dos servicios HTTP simulados: principal 429 → reserva 200 → cliente recibe BACKUP_OK. No se conectaron cuentas ChatGPT/Claude ni se consumieron sus APIs de pago.

## Límites que importan

- Dos claves del mismo proyecto pueden compartir cuota.
- Un contexto demasiado largo o una respuesta truncada no son lo mismo que una cuota agotada.
- La reserva debe admitir contexto, herramientas y formatos; puede tardar más o costar más.
- No presupongas continuidad a mitad de una respuesta ya iniciada.
- Los mensajes pueden llegar a cualquier proveedor que incluyas en el combo.
- `localhost` debe ser accesible desde la herramienta; en Docker apunta al contenedor.
- Ctrl+C detiene el gateway; repite el arranque para volver a usarlo. La configuración persiste.

## ¿Y OpenRouter?

OpenRouter es alojado y también ofrece fallback. OmniRoute lo ejecutas tú y agrupa tus conexiones. Puedes usar OpenRouter como un proveedor de OmniRoute, pero no necesitas ambos si uno ya resuelve tu caso.

## Fuentes

- https://github.com/diegosouzapw/OmniRoute/blob/release/v3.8.50/docs/routing/AUTO-COMBO.md
- https://github.com/diegosouzapw/OmniRoute/blob/release/v3.8.50/docs/guides/USAGE_QUOTA_GUIDE.md
- https://developers.openai.com/codex/auth/
- https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use
- https://code.claude.com/docs/en/llm-gateway
- https://openrouter.ai/docs/guides/routing/model-fallbacks