Usar OpenRouter con un agente de programación

Exporta OPENROUTER_API_KEY y ejecuta oharness -m openrouter/<vendor>/<model>. OHarness descubre la lista de modelos de OpenRouter, así que todos los modelos que enruta están disponibles en /models.

Tres comandos

$npm install -g oharness

$export OPENROUTER_API_KEY="..."

$oharness

Después, /models para ver lo que ofrece OpenRouter y /model openrouter/<vendor>/<model> para elegir uno: el id del modelo es el propio de OpenRouter, que ya contiene una barra.

Cuándo conviene OpenRouter

Probar muchos modelos sin abrir una cuenta con cada proveedor.
Una sola factura y una sola clave para un equipo que usa varios proveedores.
Respaldo: si un proveedor de origen está caído, el siguiente turno puede ir a otro con la misma clave.

Conviene saber

Comprar créditos de OpenRouter tiene una comisión, así que la API directa de un proveedor puede salir más barata si usas mucho un solo modelo.
OHarness se identifica ante OpenRouter como OHarness en las cabeceras de la petición, así que el uso aparece bajo esa app en OpenRouter.
Mezclar no es problema: DeepSeek con su propia clave y Claude a través de OpenRouter, en una misma sesión.

Preguntas frecuentes

¿Puedo usar OpenRouter con un agente de programación al estilo de Claude Code?

Sí. OHarness incluye OpenRouter como proveedor incorporado. Define OPENROUTER_API_KEY y elige cualquier modelo con /model openrouter/<vendor>/<model>.

¿Se pierde el contexto al cambiar de modelo de OpenRouter a mitad de sesión?

En OHarness, no. El historial se guarda en un formato neutral respecto al proveedor, así que pasar de un modelo a otro dentro de OpenRouter —o entre OpenRouter y un proveedor directo— no convierte nada.

Referencia de OpenRouter

Id del proveedor	`openrouter`
URL base	`https://openrouter.ai/api/v1`
Protocolo	Chat completions compatible con OpenAI
Clave API	`OPENROUTER_API_KEY`
Descubrimiento de modelos	Sí: la lista de modelos se le pide al endpoint en lugar de venir en el paquete.

Cómo conectarlo

El endpoint de arriba viene incorporado, así que no hay nada que configurar. Pon la clave en el entorno y el proveedor aparece en el selector de modelos:

$export OPENROUTER_API_KEY="..."

Las claves las emite OpenRouter: dónde conseguir una.

Apuntarlo a otro sitio

Un host regional, un gateway o un servidor propio. Las sobrescrituras en ~/.oharness/config.json son por campo, así que cambiar el endpoint no obliga a repetir el resto del proveedor. Este es el bloque completo, con el valor predeterminado para que se vea la forma:

{
  "providers": {
    "openrouter": {
      "baseUrl": "https://openrouter.ai/api/v1"
    }
  }
}

Lo que obtienes en cualquier caso

El mismo bucle del agente, las mismas herramientas, los mismos servidores MCP y las mismas reglas de permisos, sea cual sea el proveedor de debajo; y cambiar entre ellos a mitad de sesión no convierte nada, porque el historial nunca se guarda en el formato de un proveedor. Qué es un harness de agentes explica por qué esa es la parte difícil, y la referencia de proveedores cubre el propio catálogo.

Los 34 proveedores · Instalar OHarness