OpenCode Setup Guide

Overview

OpenCode reads providers from a JSON config. Add UnoRouter with the OpenAI-compatible adapter to use any UnoRouter model.

Quick Config

Paste these into the client. Your key auto-fills when 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 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. Add your API key and pick a 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, then Ctrl + Shift + P and run Developer: Reload Window.

4. 4
   Pick a model

   Open the model picker and switch to your new model. The adapter handles streaming and tool calling.

Recommended models

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

Gotchas

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