OpenCode Setup Guide

What you need

1. Install OpenCode

Pick one. When you are done, typing opencode in a terminal should start it.

The desktop app is on opencode.ai. It reads the same config as the terminal version.

2. Add JZS Token in CC Switch

Open the OpenCode tab

In CC Switch, select the OpenCode icon (1) and click + (2), or Add Provider in the middle of the empty list. Keep Custom Configuration selected on the next screen.

Fill in the provider

1. Provider Key: a short ID, lowercase with hyphens, for example jzstoken. It becomes the provider name in OpenCode's model list.
2. Provider Name: JZS Token.
3. API Format: OpenAI Compatible.
4. API Key: paste your key.

Scroll down and set:

1. Base URL: https://jzstoken.com/api/v1.
2. Models: click Add Model, enter the Model ID (for example gpt-5.6-terra) and a display name. Add one row per model you want to use.

Click Add. Then click Add on the provider card itself. That writes the provider into OpenCode's opencode.json, and the button turns into Remove.

3. Switch to the model in the terminal

1. Run opencode in your project folder.
2. Press Ctrl + P to open the command list.

3. Type switch model and press Enter (shortcut: Ctrl + X, then M).

4. Scroll to the jzstoken group, select your model and press Enter.

The prompt bar now shows the model and the provider. Start typing.

Without CC Switch: edit opencode.json

OpenCode reads ~/.config/opencode/opencode.json (Windows: %USERPROFILE%\.config\opencode\opencode.json). Add a provider block like this, merging it with anything already in the file:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jzstoken": {
      "name": "JZS Token",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://jzstoken.com/api/v1",
        "apiKey": "sk-your-key-here"
      },
      "models": {
        "gpt-5.6-terra": { "name": "GPT-5.6 Terra" }
      }
    }
  }
}

Restart OpenCode, then switch models as in step 3.

Troubleshooting