Guia de configuração do OpenCode

Visão geral

O OpenCode lê os provedores de uma configuração JSON. Adicione o Routerah com o adaptador compatível com a OpenAI para usar qualquer modelo do Routerah.

Configuração rápida

Cole isto no cliente. Sua chave é preenchida automaticamente quando você está conectado.

URL base: https://api.routerah.app/v1
Chave da API: YOUR_API_KEY

Compatibilidade

Configuração passo a passo

1. 1
   Abrir o arquivo de configuração do OpenCode

   Abra sua configuração do OpenCode em um editor de texto. Crie o arquivo caso ele ainda não exista.

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   Entre para preencher automaticamente sua chave API

2. 2
   Substituir o conteúdo do arquivo

   Adicione o bloco de provedor da Routerah à sua configuração. Combine-o com o arquivo existente, mantendo os blocos mcp ou agent que você já tiver.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "routerah-live": {
         "name": "Routerah",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.routerah.app/v1"
         },
         "models": {
           "minimax-m3.1-flash:free": {},
           "xing4.0-29b-a4b:free": {},
           "sage-a1.5:free": {},
           "nemotron-3.5-bolt-e4b:free": {},
           "ling-3.1-flash:free": {}
         }
       }
     }
   }

   Entre para preencher automaticamente sua chave API

3. 3
   Verificar o carregamento dos modelos

   Salve o arquivo e execute opencode models em um terminal. Todo id que você listou deve aparecer, prefixado pela sua chave de provedor.

   bash

   opencode models

   Entre para preencher automaticamente sua chave API

4. 4
   Escolher um modelo

   Abra o seletor de modelos e troque para o seu novo modelo. O adaptador cuida do streaming e da chamada de ferramentas.

Modelos recomendados

Modelos gratuitos que funcionam aqui. Cole qualquer id de modelo no cliente.

Pontos de atenção

• !O OpenCode não faz descoberta dinâmica de modelos para provedores compatíveis com OpenAI. Todo modelo desejado precisa estar no bloco "models" com o id exato.
• !Não use apenas "routerah" como chave do provedor. Esse id já existe no registro do models.dev, e o OpenCode passa a usar a lista dele em vez da sua, deixando de fora os modelos mais novos. O sufixo "-live" acima evita o conflito.
• !Use os ids exatos do catálogo da Routerah. Remova qualquer prefixo de provedor que um copiar e colar tenha acrescentado e mantenha o sufixo :free quando o id tiver um.
• !Uma chave de provedor personalizada sem bloco "models" carrega zero modelos, então o provedor some por completo do seletor.