OpenCode

OpenCode is a terminal-based AI coding assistant that runs in your development environment. Here's how to use OpenCode with Vercel AI Gateway to access models from OpenAI, Anthropic, Google, xAI, and more through a unified endpoint.

1. Create an API key

   Go to the AI Gateway section in the Vercel dashboard sidebar and click API keys to create a new API key.

2. Start OpenCode

   Run opencode in your terminal to start OpenCode:

   Terminal

   opencode

3. Connect to AI Gateway

   Run the /connect command and search for Vercel AI Gateway:

   Terminal

   /connect

   Enter your Vercel AI Gateway API key when prompted.

4. Select a model

   Run the /models command to select a model:

   Terminal

   /models

   Your requests will now be routed through Vercel AI Gateway.

5. (Optional) Configure provider routing

   You can customize models through your OpenCode config. Here's an example of specifying provider routing order in opencode.json:

   opencode.json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "vercel": {
         "models": {
           "anthropic/claude-sonnet-5": {
             "options": {
               "order": ["anthropic", "vertex"]
             }
           }
         }
       }
     }
   }

   See the provider options documentation for more details on supported routing options.

6. (Optional) Monitor usage and spend

   View your usage, spend, and request activity in the AI Gateway section in the Vercel dashboard sidebar. See the observability documentation for more details.