Skip to main content

​
1. Obtain an API Key

Open the Ace Data Cloud application list, enter an available application, and copy the API Key. Obtain Ace Data Cloud API Key

​
2. Install OpenCode

You can also use npm:

​
3. Set the API Key

To make it effective long-term, add this line to ~/.zshrc or ~/.bashrc and reopen the terminal.

​
4. Configure the Provider

Edit ~/.config/opencode/opencode.json:
Go to the model catalog to view model names (for example, claude-opus-5, gpt-6-sol), and replace all MODEL_ID values with the same name; for precise verification, use the id value in the /v1/models response. This value is the model name used by the API model parameter, not the UUID of the service or API. Ace Data Cloud uses Chat Completions here, so the adapter is @ai-sdk/openai-compatible.

​
5. Verify and Start

Then run opencode in the project directory. If the model does not appear, check the configuration file path, JSON syntax, and environment variables; 401 indicates that the Key is invalid or has not been exported. The IDE extension reuses the same OpenCode runtime configuration; see OpenCode IDE Extension.

​
Official References