Skip to main content
Before you start, install the tool and create an API key with prepaid balance in the AsterWise app.
Based on the tool’s documented custom-provider setup. Live AsterWise compatibility has not yet been tested for this tool.

​
Which API does this use?

This guide selects Chat Completions through the openai-compatible package. The base URL is https://api.asterwise.dev/v1. The client builds the full endpoint: https://api.asterwise.dev/v1/chat/completions. The model name chooses AsterCode or AsterWork, not the protocol. Use the base URL in the configuration below, rather than the full endpoint.

​
1. Set your API key

​
2. Choose the configuration for your version

Check opencode --version. Create or edit opencode.json in your project, merging these fields with existing settings. The key stays in your environment.
Do not mix the v1 provider schema with v2 providers.

​
3. Start OpenCode

Run opencode from that project in the same terminal. Enter /models and select AsterCode under AsterWise. Before your first request, configure model context and output limits from the app’s Setup page rather than assuming OpenCode’s defaults match the service.

​
Check the connection

Ask “Reply with hello” first. Confirm a response appears and find the request in Usage in AsterWise. Then try a small coding task before a larger project. For authentication errors, check the key and restart the tool from the terminal where you exported it. See troubleshooting.

​
Official reference

Configuration reviewed on September 16, 2026. OpenCode v1 providers and v2 providers.