OpenCode - Aixy

Store the API key

Run /connect in OpenCode, select Aixy, and enter a project-scoped Aixy API key. This stores the credential outside your project configuration. For a release using the custom-provider flow, select Other and use aixy as the provider ID, then add the configuration below.

Configure project models

Aixy’s models depend on your project’s connections and policies. Define the model IDs your team uses in opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aixy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Aixy",
      "options": {
        "baseURL": "https://api.aixy-gateway.com/v1"
      },
      "models": {
        "openai/gpt-4.1-mini": {
          "name": "GPT-4.1 mini via Aixy"
        }
      }
    }
  }
}

Replace the model entry with any ID returned by Aixy’s /v1/models, including an aixy/<route>. Run /models in OpenCode and select the model under Aixy. Send a short prompt and check Activity for the project and effective model. To verify that the credential was stored under the same provider ID, run:

opencode auth list

Do not add apiKey or a literal Authorization header to a committed opencode.json.

See OpenCode custom providers for additional model limits and capability settings.