OpenCode

OpenCode is a terminal-based AI coding assistant that supports 75+ LLM providers through the AI SDK. Connect it to ClearMaas by configuring a custom provider in your JSON config file.

Prerequisites

OpenCode installed (npm install -g opencode or via installer)
A ClearMaas API key starting with sk-

Config file locations

OpenCode merges configuration from multiple sources (later overrides earlier):

Remote config (.well-known/opencode) �?organizational defaults
Global config (~/.config/opencode/opencode.json) �?user preferences
OPENCODE_CONFIG env var �?custom overrides
Project config (opencode.json in project root) �?project-specific
OPENCODE_CONFIG_CONTENT env var �?runtime overrides

Setup via global config

Add to ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-...",
        "baseURL": "https://api.clearmaas.com/v1"
      }
    }
  }
}

Setup via environment variable

For temporary or CI usage, use OPENCODE_CONFIG_CONTENT:

export OPENAI_API_KEY="sk-..."
export OPENCODE_CONFIG_CONTENT='{
  "model": "openai/gpt-4o",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.clearmaas.com/v1"
      }
    }
  }
}'
opencode "Explain this code"

Using environment variables in config

Reference API keys via env vars to avoid hardcoding:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gpt-4o-mini",
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}",
        "baseURL": "https://api.clearmaas.com/v1"
      }
    }
  }
}

export OPENAI_API_KEY="sk-..."
opencode

Choosing models

Set the default model in config:

{
  "model": "anthropic/claude-sonnet-4-5"
}

Override with the /models command in the TUI:

/model openai/gpt-4o-mini

Using a separate small model

OpenCode can use a cheaper model for lightweight tasks (title generation, etc.):

{
  "model": "anthropic/claude-opus-4-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

Verifying the setup

opencode
# In the TUI, type: /models
# You should see ClearMaas models listed
# Or type: /connect and verify the endpoint

Check your ClearMaas dashboard to confirm requests are being routed.

Config example with all options

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "autoupdate": true,
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}",
        "baseURL": "https://api.clearmaas.com/v1",
        "timeout": 300000,
        "setCacheKey": true
      }
    }
  }
}

Available provider options:

timeout �?Request timeout in milliseconds (default: 300000)
setCacheKey �?Always set a cache key for designated provider
baseURL �?Override the default API endpoint

AI Agents

Prerequisites

Config file locations

Setup via global config

Setup via environment variable

Using environment variables in config

Choosing models

Using a separate small model

Verifying the setup

Config example with all options

See also

​Prerequisites

​Config file locations

​Setup via global config

​Setup via environment variable

​Using environment variables in config

​Choosing models

​Using a separate small model

​Verifying the setup

​Config example with all options

​See also

Prerequisites

Config file locations

Setup via global config

Setup via environment variable

Using environment variables in config

Choosing models

Using a separate small model

Verifying the setup

Config example with all options

See also