OpenCode Setup Guide

Overview

OpenCode reads its providers from a JSON config file. Add UnoRouter as a custom provider with the OpenAI-compatible adapter and you can pick any UnoRouter model as the active model.

Quick Config

Drop these values into the client. Your key auto-fills when you are signed in.

Base URL: https://api.unorouter.com/v1
API Key: YOUR_API_KEY

Compatibility

Step-by-step setup

1. 1
   Open the OpenCode config file

   Press Ctrl + O inside OpenCode and paste the path. On Windows, replace YOUR_USER with your Windows username.

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

   Sign in to auto-fill your API key

2. 2
   Replace the file contents

   Wipe the file and paste the UnoRouter provider block. Drop in your UnoRouter API key and pick any model from the catalog.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

   Sign in to auto-fill your API key

3. 3
   Save and reload

   Press Ctrl + S to save, then Ctrl + Shift + P and run Developer: Reload Window. OpenCode picks up the new provider on reload.

4. 4
   Pick a model

   Open the model picker in OpenCode and switch to the model you added. The OpenAI-compatible adapter handles streaming and tool calling automatically.

Recommended models

Free models that work well here. Paste any model id into the client.

Gotchas

• !With "discoverModels": true, OpenCode auto-fetches the full UnoRouter catalog from /v1/models on startup, so every model (including new ones) shows up in the picker without listing them by hand.
• !If Developer: Reload Window does not show your provider, double check the JSON saved without trailing commas.
• !Use exact model ids from the UnoRouter catalog. Strip any leading provider prefix if a copy-paste added one.
• !On older OpenCode without auto-discovery, add a "models" block listing the exact ids you need (e.g. {"gemini-3.1-flash-lite": {}}) and restart.