Key settings
Prerequisites
- The current version of the tool is installed
- A BetterToken API key: register and get one
- A Model ID from the model plaza
Additional requirements
- VS Code installed
Install
Install Cline
Open VS Code, search for Cline in the extensions marketplace, and install it.Manual setup
Complete this setup in the Cline configuration UI. You do not need to edit a configuration file.Setup
1
Clear conflicting environment variables
2
Open the Cline config UI
Click Use your own API key in the Cline sidebar.
3
Configure the API provider
Fill in:
- API Provider →
OpenAI Compatible - Base URL →
https://bettertoken.ai/v1 - API Key → your BetterToken API Key
- Model → a model ID from a supported provider copied from the model plaza
4
Only configure extra headers when the official docs explicitly require them
The official Cline OpenAI-compatible setup docs focus on the
Base URL, API key, and model ID. You usually do not need an extra User-Agent when connecting BetterToken.If you are also using a custom gateway, tenant routing, observability, or caching layer, add headers only according to that upstream service’s official docs.5
Save the config
Click Done.
6
Restart Cline
After saving the config, restart VS Code or reload the Cline extension so the new settings take effect.
Verify the connection
Send a short test prompt. If the tool returns a response without an authentication or Model ID error, the connection works. Fully restart the tool after changing its configuration.Switch models
Open the model selector or change theModel field in the configuration. Use the exact Model ID from the model plaza, then restart the current session.
Common errors
- How to configure an OpenAI-compatible API in Cline
- OpenAI-compatible API vs Anthropic-compatible API
- MCP vs API Key and Base URL
- How to configure a custom OpenAI API in Cursor
Check the
Base URL, API key, model ID, and tool version first. Do not assume User-Agent is a required BetterToken setting.Advanced setup
Supported providers
Statuses apply to the BetterToken setup documented on this page.
What the setup methods mean
What the setup methods mean
- Manual setup: enter the API Key, Base URL, and Model.
- Not supported: no verified direct setup is currently available.
Technical details
Protocol, endpoint, and internal provider fields
Protocol, endpoint, and internal provider fields
This setup uses
https://bettertoken.ai/v1. The tool appends the OpenAI-compatible endpoint path. Do not add /chat/completions or /responses unless a specific field explicitly requires it.
