OpenCode setup

Configure OpenCode with Asterionyx as a custom OpenAI-compatible provider for coding sessions in your local projects.

This page describes how to point OpenCode at Asterionyx’s Chat Completions endpoint. It is a setup guide, not a partnership or endorsement.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "asterionyx": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Asterionyx",
      "options": {
        "baseURL": "https://api.a.eus/v1",
        "apiKey": "{env:ASTERIONYX_API_KEY}"
      },
      "models": {
        "asterionyx-from-catalog": {
          "name": "Published Model ID from the live catalog"
        }
      }
    }
  }
}

1. 1

   Open custom provider setup

   In OpenCode, open the provider connection flow and choose the custom provider option for an OpenAI-compatible endpoint.

2. 2

   Set Provider ID

   Use a lowercase integration label such as asterionyx. Keep the selected public model ID in your environment configuration.

3. 3

   Set Display name

   Use Asterionyx as the display name so it is easy to recognize in OpenCode.

4. 4

   Set the Base URL

   Paste the Asterionyx Base URL shown below. Keep the /v1 suffix because OpenCode sends OpenAI-compatible requests to that path.

5. 5

   Add your API key

   Paste your Asterionyx API key in the API key field. OpenCode stores provider credentials locally, so do not commit the key to your project.

6. 6

   Select a Model ID

   Open the model picker, select your Asterionyx connection, and choose the published model ID you configured.