opencode

Getting started

Install opencode and omniroute, configure providers and connect them through a local API.

References

• opencode
• omniroute

---

1. Install opencode

   Install opencode using the official installer.

   curl -fsSL https://opencode.ai/install | bash

2. Install omniroute

   Install the latest omniroute release globally, then start the local server.

   pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

3. Configure omniroute

   Open the omniroute web UI and complete the initial setup.

   open http://localhost:20128/login

   • Set an omniroute password.
   • Get API keys for the providers you want to use:
     • Cerebras
     • Mistral
     • Google AI Studio (Gemini)
     • Groq
     • DeepSeek
     • OpenRouter
   • Add providers http://localhost:20128/dashboard/providers.
   • Create omniroute API key http://localhost:20128/dashboard/api-manager.
   
   

4. Configure opencode

   Create the opencode configuration directory and file.

   mkdir -p ~/.config/opencode

   nano ~/.config/opencode/opencode.json

   Add the following configuration and replace YOUR_OMNIROUTE_API_KEY with your omniroute API key.

   opencode.json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "omniroute": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "omniroute",
         "options": {
           "baseURL": "http://localhost:20128/v1",
           "apiKey": "YOUR_OMNIROUTE_API_KEY"
         },
         "models": {
           "auto": {
             "name": "Auto / Best Available"
           }
         }
       }
     }
   }

5. Start opencode

   Start opencode from your terminal.

   opencode

   Verify that omniroute is available as a provider. If needed, use /connect and select omniroute.