OpenCode
OpenCode integration guide for Tokaify
Keep these values handy
OpenCode Desktop connects to Tokaify through a custom provider. The five key fields are:
- Provider ID: recommended value
tokaify - Display Name: recommended value
Tokaify - Base URL:
https://api.tokaify.com/v1 - API Key: the full
sk-...secret - Model: a model enabled for your account, such as
gpt-5.4
Step 1: Create a key in Tokaify
- Sign in to Tokaify.
- Open Token Management.
- Click
Add Tokenand save it. - In the token list, click
Copy Secretto get the fullsk-...value.
If you want OpenCode to be a separate integration scenario, create a dedicated token for it. That makes quota, permission, and usage troubleshooting much easier later.
Step 2: Parameter mapping
| OpenCode field | Value | Notes |
|---|---|---|
| Provider ID | tokaify | The provider's unique identifier; lowercase is recommended |
| Display Name | Tokaify | Only affects UI presentation |
| Base URL | https://api.tokaify.com/v1 | /v1 is required |
| API Key | sk-... | Use the full secret and keep the sk- prefix |
| Model | gpt-5.4 or similar | Replace it with a model available in your account |
Step 3: Open OpenCode settings
In OpenCode Desktop, click the settings button in the lower-left corner.
Step 4: Open the provider page
In settings, choose Providers from the left menu.
If you do not immediately see Custom Provider, click Show More Providers at the bottom.
Step 5: Choose the custom provider
In the provider list, find Custom or Custom Provider, then click Connect.
Step 6: Fill in the Tokaify configuration
Fill the custom provider form like this:
| Field | Value |
|---|---|
| Provider ID | tokaify |
| Display Name | Tokaify |
| Base URL | https://api.tokaify.com/v1 |
| API Key | sk-your-full-secret |
| Model ID | For example gpt-5.4 |
| Model Display Name | For example GPT-5.4 |
Use a model available to your account
gpt-5.4 is only an example. In practice, use a model name that is enabled for your Tokaify account and allowed by the current token.
After filling in the form, click Submit or Connect. Once saved successfully, OpenCode will show Tokaify as a new provider in the model selection list.
Step 7: Choose a model and verify
The simplest verification is to enter this inside OpenCode:
Reply with "OpenCode is connected to Tokaify", then list the top-level directories in the current project.If it returns normally, the configuration is working.
FAQ
Should the Provider ID be Tokaify or tokaify
Use tokaify. The Provider ID is an internal identifier, and many versions expect lowercase letters, digits, hyphens, or underscores. The display name can still be Tokaify for readability in the UI.
What should I use for Base URL
Use:
https://api.tokaify.com/v1Do not use only https://api.tokaify.com, and do not accidentally duplicate it as https://api.tokaify.com/v1/v1.
What if I can't find the model I just added
Go back to Settings > Providers and confirm the custom provider was saved successfully. Then check that the model ID exactly matches a model name available in the Tokaify console.
What should I do if I get 401 or 403
Check these items first:
- Whether the API key is the full
sk-...secret - Whether the Base URL is exactly
https://api.tokaify.com/v1 - Whether the model is allowed by the current token
- Whether the token is expired, disabled, or out of balance
How is this guide?
Last updated on