Configure OpenCode with the ScaleMax API

OpenCode settings for ScaleMax

Enter these values in OpenCode. A Pay as you go key and a token pack key use different base URLs — use the one that matches the key you bought.

{
  "provider": {
    "scalemax": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ScaleMax",
      "options": {
        "baseURL": "https://api.scalemax.pro/v1",
        "apiKey": "{file:~/.config/opencode/scalemax.key}"
      },
      "models": { "gpt-5.6-terra": {}, "gpt-5.6-luna": {} }
    }
  },
  "model": "scalemax/gpt-5.6-terra",
  "small_model": "scalemax/gpt-5.6-luna"
}

Step by step

1. Save your key on its own line in ~/.config/opencode/scalemax.key.
2. Add the scalemax provider block to opencode.json with the base URL for your key.
3. List the model IDs you want under "models" and set "model" and "small_model" with the scalemax/ prefix.
4. Start OpenCode and run a short prompt to confirm.

Or let the installer do it

Choose OpenCode. The installer backs up your existing opencode.json before writing the provider.

npm install -g scalemax@latest && scalemax

A recorded walkthrough is on the Video setup page in the ScaleMax dashboard (sign-in required).

Good to know

• The scalemax/ prefix only selects OpenCode’s provider; ScaleMax receives the exact model ID after the slash.
• For Claude models, add per-model limit values so OpenCode does not request more output than the model allows.
• OpenCode talks to ScaleMax through an OpenAI-compatible adapter, so a few Responses-only behaviours are not available.

Troubleshooting

OpenCode says the provider has no key

Check the {file:…} path matches where you saved the key and that the file holds only the key.

Model not found

Use the ID exactly as the catalogue lists it after the scalemax/ prefix, and make sure your key includes that model.

ScaleMax is not affiliated with the makers of OpenCode. Compatibility describes the API protocol; OpenCode's own features and plans are provided by its developer.