OpenRouter gebruiken met een AI-coding-agent

Exporteer OPENROUTER_API_KEY en voer oharness -m openrouter/<vendor>/<model> uit. OHarness ontdekt de modellijst van OpenRouter, dus elk model dat het routeert staat onder /models.

Drie commando's

$npm install -g oharness

$export OPENROUTER_API_KEY="..."

$oharness

Gebruik daarna /models om te zien wat OpenRouter aanbiedt en /model openrouter/<vendor>/<model> om er een te kiezen — het model-id is dat van OpenRouter zelf, en dat bevat al een slash.

Wanneer OpenRouter de juiste keuze is

Veel modellen uitproberen zonder bij elke aanbieder een account te openen.
Eén rekening en één sleutel voor een team dat meerdere aanbieders gebruikt.
Fallback: als één upstream plat ligt, kan de volgende beurt via dezelfde sleutel naar een andere gaan.

Goed om te weten

Op het kopen van OpenRouter-credits zit een toeslag, dus de directe API van een aanbieder kan goedkoper zijn als je veel met één model werkt.
OHarness identificeert zich in de request-headers bij OpenRouter als OHarness, dus het gebruik verschijnt op OpenRouter onder die app.
Combineren is geen probleem: DeepSeek via zijn eigen sleutel en Claude via OpenRouter, in één sessie.

Veelgestelde vragen

Kan ik OpenRouter gebruiken met een AI-coding-agent in de stijl van Claude Code?

Ja. OHarness heeft OpenRouter als ingebouwde aanbieder. Stel OPENROUTER_API_KEY in en kies een model met /model openrouter/<vendor>/<model>.

Verlies ik context als ik midden in een sessie van OpenRouter-model wissel?

Niet in OHarness. De geschiedenis wordt aanbiederneutraal opgeslagen, dus wisselen tussen modellen achter OpenRouter — of tussen OpenRouter en een directe aanbieder — zet niets om.

Referentie voor OpenRouter

Aanbieder-id	`openrouter`
Basis-URL	`https://openrouter.ai/api/v1`
Protocol	OpenAI-compatibele chat completions
API-sleutel	`OPENROUTER_API_KEY`
Modeldetectie	Ja — de modellijst wordt bij het endpoint opgevraagd in plaats van meegeleverd.

Verbinden

Het endpoint hierboven is ingebouwd, dus er valt niets in te stellen. Zet de sleutel in de omgeving en de aanbieder verschijnt in de modelkiezer:

$export OPENROUTER_API_KEY="..."

Sleutels worden uitgegeven door OpenRouter — waar je er een krijgt.

Ergens anders naartoe laten wijzen

Een regionale host, een gateway of een eigen server. Overrides in ~/.oharness/config.json werken per veld, dus het endpoint wijzigen betekent niet dat je de rest van de aanbieder opnieuw moet opgeven — dit is het volledige blok, met de standaardwaarde ingevuld zodat de vorm duidelijk is:

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

Wat je hoe dan ook krijgt

Dezelfde agent-lus, dezelfde tools, dezelfde MCP-servers en dezelfde permissieregels, welke aanbieder er ook onder zit — en midden in een sessie tussen ze wisselen zet niets om, omdat de geschiedenis nooit in de vorm van een leverancier wordt opgeslagen. Wat een agent-harness is legt uit waarom dat het lastige deel is, en de referentie voor aanbieders behandelt de catalogus zelf.

Alle 34 aanbieders · OHarness installeren