Utiliser OpenRouter avec un agent de code

Exportez OPENROUTER_API_KEY et lancez oharness -m openrouter/<vendor>/<model>. OHarness découvre la liste des modèles d'OpenRouter : chaque modèle qu'il route est donc disponible dans /models.

Trois commandes

$npm install -g oharness

$export OPENROUTER_API_KEY="..."

$oharness

Puis /models pour voir ce que propose OpenRouter et /model openrouter/<vendor>/<model> pour en choisir un — l'identifiant de modèle est celui d'OpenRouter, qui contient déjà une barre oblique.

Quand OpenRouter est le bon choix

Essayer de nombreux modèles sans ouvrir de compte chez chaque fournisseur.
Une seule facture et une seule clé pour une équipe qui utilise plusieurs fournisseurs.
Repli : si un fournisseur amont est en panne, le tour suivant peut passer par un autre avec la même clé.

Bon à savoir

L'achat de crédits OpenRouter entraîne des frais : l'API directe d'un fournisseur peut donc revenir moins cher pour un usage intensif d'un seul modèle.
OHarness s'identifie auprès d'OpenRouter comme OHarness dans les en-têtes de requête : l'utilisation apparaît donc sous cette application sur OpenRouter.
Le mélange ne pose aucun problème : DeepSeek avec sa propre clé et Claude via OpenRouter, dans une même session.

Questions fréquentes

Puis-je utiliser OpenRouter avec un agent de code à la Claude Code ?

Oui. OHarness intègre OpenRouter comme fournisseur. Définissez OPENROUTER_API_KEY et choisissez n'importe quel modèle avec /model openrouter/<vendor>/<model>.

Changer de modèle OpenRouter en cours de session fait-il perdre le contexte ?

Pas dans OHarness. L'historique est stocké dans un format indépendant des fournisseurs : passer d'un modèle à l'autre derrière OpenRouter — ou entre OpenRouter et un fournisseur direct — ne convertit rien.

Référence OpenRouter

Identifiant du fournisseur	`openrouter`
URL de base	`https://openrouter.ai/api/v1`
Protocole	Chat completions compatible OpenAI
Clé API	`OPENROUTER_API_KEY`
Découverte des modèles	Oui — la liste des modèles est demandée à l'endpoint plutôt que livrée avec le harnais.

Le connecter

L'endpoint ci-dessus est intégré : il n'y a rien à configurer. Placez la clé dans l'environnement et le fournisseur apparaît dans le sélecteur de modèles :

$export OPENROUTER_API_KEY="..."

Les clés sont délivrées par OpenRouter — où en obtenir une.

Le pointer ailleurs

Un hôte régional, une passerelle ou votre propre serveur. Les surcharges dans ~/.oharness/config.json s'appliquent champ par champ : changer d'endpoint n'oblige pas à redéclarer le reste du fournisseur. Voici le bloc complet, avec la valeur par défaut pour que la structure soit claire :

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

Ce que vous obtenez dans tous les cas

La même boucle d'agent, les mêmes outils, les mêmes serveurs MCP et les mêmes règles de permission, quel que soit le fournisseur sous-jacent — et passer de l'un à l'autre en cours de session ne convertit rien, car l'historique n'est jamais stocké au format d'un fournisseur. Ce qu'est un harnais d'agent explique pourquoi c'est la partie difficile, et la référence des fournisseurs décrit le catalogue lui-même.

Les 34 fournisseurs · Installer OHarness