# Instrucciones para el agente: 9Router: enruta solicitudes entre proveedores de modelos

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/decolua/9router (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/9router-multi-llm

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba Node.js ≥20.18.1 y npm. Aunque [cli/package.json](https://github.com/decolua/9router/blob/master/cli/package.json) declara ≥18, la CLI distribuye el servidor de la aplicación: su [generador](https://github.com/decolua/9router/blob/master/cli/scripts/build-cli.js) copia la salida independiente de Next.js 16.4.2 (Node ≥20.9) y el manifiesto incorpora undici 7.30.1 (Node ≥20.18.1). Esta receta sigue el requisito más exigente de esas dependencias.

### Paso 1: instala y abre el panel

```bash
npm install -g 9router
9router
```

### Paso 2: conecta un proveedor autorizado

El panel documentado abre en `http://localhost:20128`. Configura una cuenta y un modelo que puedas utilizar. En el cliente usa la dirección de la API que muestra el panel, normalmente `http://localhost:20128/v1`, y la clave generada para esa conexión. Para una prueba concreta, usa Cline instalado: abre sus ajustes → API Provider → OpenAI Compatible. Completa Base URL con esa dirección, API Key con la clave de 9Router y Model con el identificador del modelo conectado que muestra el panel. Es la [configuración oficial de Cline](https://docs.cline.bot/provider-config/openai-compatible) para una API compatible.

## Comprobación

Pide en Cline «¿Cuánto es 2 más 3? Responde solo el resultado», sin solicitar herramientas: debe devolver `5`. Confirma en los registros de 9Router el proveedor y modelo que atendieron la llamada. Prueba un fallo controlado para comprobar qué alternativa se activa y qué datos recibe.

## Si algo falla

Si un cliente no acepta la dirección de la API, revisa su compatibilidad y formato. Si una cuenta llega a su límite, respeta sus condiciones y comprueba la política de respaldo configurada.