Skip to content

opencode integration

opencode can connect to any OpenAI-compatible gateway (including SU8 Codes) via a custom provider.

Create/update opencode.json in your project and fill the key fields:

  • options.baseURL: https://www.su8.codes/codex/v1 (from https://www.su8.codes/codex/v1/responses, remove /responses)
  • options.apiKey: <your SU8 Codes API key> (or {env:SU8_API_KEY} to read from env vars)
  • models: add the model ids you want to use (copy from Models)

Example (key fields only):

{
"$schema": "https://opencode.ai/config.json",
"provider": {
"su8": {
"npm": "@ai-sdk/openai-compatible",
"name": "SU8 Codes",
"options": {
"baseURL": "https://www.su8.codes/codex/v1",
"apiKey": "{env:SU8_API_KEY}"
},
"models": {
"<model id>": {
"name": "<model id>"
}
}
}
}
}

Quick check:

If errors happen: