Guía de configuración de OpenCode

Visión general

OpenCode lee los proveedores de una configuración JSON. Añade UnoRouter con el adaptador compatible con OpenAI para usar cualquier modelo de UnoRouter.

Configuración rápida

Pega estos valores en el cliente. Tu clave se rellena sola si has iniciado sesión.

URL base: https://api.unorouter.com/v1
Clave API: YOUR_API_KEY

Compatibilidad

Configuración paso a paso

1. 1
   Abrir el archivo de configuración de OpenCode

   Abre tu configuración de OpenCode en un editor de texto. Crea el archivo si todavía no existe.

   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

   Inicia sesión para autocompletar tu clave API

2. 2
   Reemplazar el contenido del archivo

   Añade el bloque de proveedor de UnoRouter a tu configuración. Combínalo con el archivo existente y conserva los bloques mcp o agent que ya tengas.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter-live": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         },
         "models": {
           "ling-3.1-flash:free": {},
           "agnes-3.0-flash:free": {},
           "minicpm5-2b:free": {},
           "k2-horizon:free": {},
           "qwen3.8-flash-next:free": {}
         }
       }
     }
   }

   Inicia sesión para autocompletar tu clave API

3. 3
   Comprobar que los modelos cargan

   Guarda el archivo y ejecuta opencode models en una terminal. Cada id que hayas indicado debe aparecer con tu clave de proveedor como prefijo.

   bash

   opencode models

   Inicia sesión para autocompletar tu clave API

4. 4
   Elegir un modelo

   Abre el selector de modelos y cambia a tu nuevo modelo. El adaptador se encarga del streaming y de las llamadas a herramientas.

Modelos recomendados

Modelos gratuitos que funcionan aquí. Pega cualquier id de modelo en el cliente.

Aspectos a tener en cuenta

• !OpenCode no tiene descubrimiento dinámico de modelos para proveedores compatibles con OpenAI. Todo modelo que quieras usar debe estar en el bloque "models" con su id exacto.
• !No llames "unorouter" a secas a la clave del proveedor. Ese id ya existe en el registro de models.dev y OpenCode usará su lista en lugar de la tuya, por lo que faltarán los modelos más nuevos. El sufijo "-live" de arriba evita el conflicto.
• !Usa los ids exactos del catálogo de UnoRouter. Quita cualquier prefijo de proveedor que haya añadido un copiar y pegar, y conserva el sufijo :free cuando el id lo tenga.
• !Una clave de proveedor personalizada sin bloque "models" carga cero modelos, así que el proveedor desaparece por completo del selector.