Usare OpenRouter con un agente di programmazione

Esporta OPENROUTER_API_KEY ed esegui oharness -m openrouter/<vendor>/<model>. OHarness rileva l'elenco dei modelli di OpenRouter, quindi ogni modello che instrada è disponibile in /models.

Tre comandi

$npm install -g oharness

$export OPENROUTER_API_KEY="..."

$oharness

Poi usa /models per vedere cosa offre OpenRouter e /model openrouter/<vendor>/<model> per sceglierne uno: l'id del modello è quello di OpenRouter, che contiene già una barra.

Quando OpenRouter è la scelta giusta

Provare molti modelli senza aprire un account presso ogni fornitore.
Una sola fattura e una sola chiave per un team che usa più fornitori.
Ripiego: se un fornitore a monte non risponde, il turno successivo può passare a un altro con la stessa chiave.

Da sapere

L'acquisto di crediti OpenRouter prevede una commissione, quindi per un uso intenso di un solo modello l'API diretta del fornitore può costare meno.
OHarness si identifica presso OpenRouter come OHarness nelle intestazioni della richiesta, quindi l'utilizzo compare sotto quell'app su OpenRouter.
Si possono combinare: DeepSeek con la sua chiave e Claude tramite OpenRouter, nella stessa sessione.

Domande frequenti

Posso usare OpenRouter con un agente di programmazione in stile Claude Code?

Sì. In OHarness OpenRouter è un fornitore integrato. Imposta OPENROUTER_API_KEY e scegli un modello con /model openrouter/<vendor>/<model>.

Cambiare modello OpenRouter a metà sessione fa perdere il contesto?

Non in OHarness. La cronologia è salvata in un formato neutro rispetto al fornitore, quindi passare da un modello all'altro dietro OpenRouter, o tra OpenRouter e un fornitore diretto, non richiede alcuna conversione.

Riferimento di OpenRouter

Id del fornitore	`openrouter`
URL di base	`https://openrouter.ai/api/v1`
Protocollo	Chat completions compatibili con OpenAI
Chiave API	`OPENROUTER_API_KEY`
Rilevamento dei modelli	Sì: l'elenco dei modelli viene chiesto all'endpoint invece di essere incluso nel pacchetto.

Come collegarlo

L'endpoint qui sopra è integrato, quindi non c'è nulla da configurare. Metti la chiave nell'ambiente e il fornitore compare nel selettore dei modelli:

$export OPENROUTER_API_KEY="..."

Le chiavi sono rilasciate da OpenRouter: dove ottenerne una.

Puntarlo altrove

Un host regionale, un gateway o un tuo server. Gli override in ~/.oharness/config.json valgono a livello di campo, quindi cambiare l'endpoint non significa riscrivere il resto del fornitore. Questo è il blocco completo, mostrato con il valore predefinito per rendere chiara la struttura:

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

Cosa ottieni in ogni caso

Lo stesso ciclo dell'agente, gli stessi strumenti, gli stessi server MCP e le stesse regole di permesso, qualunque fornitore ci sia sotto; e passare dall'uno all'altro a metà sessione non converte nulla, perché la cronologia non viene mai salvata nel formato di un fornitore. Cos'è un harness per agenti spiega perché questa è la parte difficile, e il riferimento sui fornitori tratta il catalogo stesso.

Tutti i 34 fornitori · Installa OHarness