Use o OpenRouter com um agente de programação

Exporte OPENROUTER_API_KEY e rode oharness -m openrouter/<vendor>/<model>. O OHarness descobre a lista de modelos do OpenRouter, então todo modelo que ele roteia fica disponível em /models.

Três comandos

$npm install -g oharness

$export OPENROUTER_API_KEY="..."

$oharness

Depois use /models para ver o que o OpenRouter oferece e /model openrouter/<vendor>/<model> para escolher um — o id do modelo é o do próprio OpenRouter, que já contém uma barra.

Quando o OpenRouter é a escolha certa

Testar muitos modelos sem abrir conta em cada fornecedor.
Uma fatura e uma chave para uma equipe que usa vários fornecedores.
Fallback: se um upstream cair, o próximo turno pode ir para outro pela mesma chave.

Bom saber

A compra de créditos do OpenRouter tem uma taxa, então a API direta de um fornecedor pode sair mais barata para uso intenso de um único modelo.
O OHarness se identifica para o OpenRouter como OHarness nos headers da requisição, então o uso aparece sob esse app no OpenRouter.
Misturar não tem problema: DeepSeek pela própria chave e Claude pelo OpenRouter, na mesma sessão.

Perguntas frequentes

Posso usar o OpenRouter com um agente de programação no estilo Claude Code?

Sim. O OHarness tem o OpenRouter como provedor embutido. Defina OPENROUTER_API_KEY e escolha qualquer modelo com /model openrouter/<vendor>/<model>.

Trocar de modelo do OpenRouter no meio da sessão perde o contexto?

Não no OHarness. O histórico é guardado em formato neutro em relação ao fornecedor, então passar de um modelo a outro atrás do OpenRouter — ou entre o OpenRouter e um provedor direto — não converte nada.

Referência de OpenRouter

Id do provedor	`openrouter`
URL base	`https://openrouter.ai/api/v1`
Protocolo	Chat completions compatível com OpenAI
Chave de API	`OPENROUTER_API_KEY`
Descoberta de modelos	Sim — a lista de modelos é pedida ao endpoint em vez de vir embutida.

Como conectar

O endpoint acima já vem embutido, então não há nada a configurar. Coloque a chave no ambiente, e o provedor aparece no seletor de modelos:

$export OPENROUTER_API_KEY="..."

As chaves são emitidas por OpenRouter — onde conseguir uma.

Apontando para outro lugar

Um host regional, um gateway ou um servidor seu. As sobrescritas em ~/.oharness/config.json são por campo, então mudar o endpoint não significa repetir o resto do provedor — este é o bloco inteiro, mostrado com o valor padrão para deixar o formato claro:

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

O que você tem de qualquer forma

O mesmo loop do agente, as mesmas ferramentas, os mesmos servidores MCP e as mesmas regras de permissão, qualquer que seja o provedor por baixo — e trocar entre eles no meio da sessão não converte nada, porque o histórico nunca é guardado no formato de um fornecedor. O que é um harness de agentes explica por que essa é a parte difícil, e a referência de provedores cobre o próprio catálogo.

Todos os 34 provedores · Instalar o OHarness