OpenCode

Choose installer or manual setup

In OpenCode, a provider is a named API connection with its models and connection settings. The installer configures an existing OpenCode installation; it does not install OpenCode. It authenticates GET /v1/models, adds or refreshes the provod provider, and carries the returned names, limits, capabilities, modalities, and public prices into the local configuration.

Use the installer for catalog-driven setup. Use the manual provider only when you need to review and merge every field yourself.

Run the installer

export PROVOD_API_KEY="sk_..."

curl -fsSL https://app.provod.ai/install/opencode.sh | \
  PROVOD_API_KEY="$PROVOD_API_KEY" sh

Set OPENCODE_CONFIG before the command to target a non-default file. Otherwise the installer checks ~/.config/opencode/opencode.json, then opencode.jsonc, and creates opencode.json when neither exists.

The macOS/Linux installer backs up an existing file before changing it. The PowerShell installer does not create a backup, so copy an important configuration before running it.

Configure a provider manually

First export the key and use GET /v1/models to choose an available exact ID. Then replace every model-id-from-GET-v1-models string below with that ID, and paste the current key value where the example names PROVOD_API_KEY.

export PROVOD_API_KEY="sk_..."

{
  "$schema": "https://opencode.ai/config.json",
  "model": "provod/model-id-from-GET-v1-models",
  "provider": {
    "provod": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "provod.ai",
      "options": {
        "baseURL": "https://api.provod.ai/v1",
        "apiKey": "paste-value-from-PROVOD_API_KEY"
      },
      "models": {
        "model-id-from-GET-v1-models": {
          "name": "model-id-from-GET-v1-models"
        }
      }
    }
  }
}

Save the example as ~/.config/opencode/opencode.json, then restrict the directory and credential file to the current user. If OPENCODE_CONFIG points elsewhere, apply equivalent owner-only permissions to that file:

chmod 700 ~/.config/opencode
chmod 600 ~/.config/opencode/opencode.json

The manual example defines only the connection. The installer is preferable when you want OpenCode to receive current context/output limits, reasoning, tools, image input, and prices from catalog metadata.

Verify the current configuration

List the models OpenCode loaded for the provider:

opencode models provod

Select one through /models, or run a current catalog ID directly:

export PROVOD_MODEL="model-id-from-GET-v1-models"
opencode run --model "provod/$PROVOD_MODEL" "Reply with ok"

Recover or refresh

On macOS/Linux, the installer prints the timestamped backup path. If the merged file no longer loads, stop OpenCode, preserve the failed file for comparison, restore the printed backup, and rerun only after checking OPENCODE_CONFIG.

If the shell installer cannot merge safely, it keeps the backup and writes a standalone provod-opencode-provider.jsonc snippet for review. On Windows, restore the copy you made before running PowerShell. Rerunning the installer refreshes the live catalog; it is not necessary to copy new model IDs from this page.

A public error code is the client-facing error.code from the API response. Record it with the HTTP status, exact model ID, time, OpenCode version, config path, and masked key prefix. See API authentication for safe key handling and Chat Completions for the request format.

Troubleshooting