Use OpenRouter in OpenCode

Steps

1. 1
   Step 1.

   Install OpenCode.

   Terminal

   Copy

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

2. 2
   Step 2.

   Or install with npm or Homebrew.

   Terminal

   Copy

   npm install -g opencode-ai
   brew install anomalyco/tap/opencode

3. 3
   Step 3.

   Start OpenCode in your project directory.

   Terminal

   Copy

   cd /path/to/your/project
   opencode

4. 4
   Step 4.

   Run /connect, search for OpenRouter, and paste your OpenRouter API key when prompted.

   Snippet

   Copy

   /connect

5. 5
   Step 5.

   Run /models to pick a model. Many OpenRouter models are preloaded.

   Snippet

   Copy

   /models

6. 6
   Step 6.

   Optional: add more OpenRouter models in opencode.json, using the OpenRouter slug as the key.

   JSON

   Copy

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "openrouter": {
         "models": {
           "~anthropic/claude-sonnet-latest": {},
           "~google/gemini-flash-latest": {}
         }
       }
     }
   }

7. 7
   Step 7.

   Optional: set a default model. OpenCode model ids are provider_id/model_id, so prefix the slug with openrouter/.

   JSON

   Copy

   {
     "$schema": "https://opencode.ai/config.json",
     "model": "openrouter/~anthropic/claude-sonnet-latest"
   }

8. 8
   Step 8.

   Optional: write the key directly to ~/.local/share/opencode/auth.json.

   JSON

   Copy

   {
     "openrouter": {
       "type": "api",
       "key": "sk-or-v1-your-key-here"
     }
   }

9. 9
   Step 9.

   Check that the credential was stored.

   Terminal

   Copy

   opencode auth list