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 Roo Code
Open VS Code, search for Roo Code in the extensions marketplace, and install it.Manual setup
Complete this setup in the Roo Code settings UI. You do not need to edit a configuration file.Setup
1
Clear conflicting environment variables
2
Open Roo Code settings
Open the Roo Code Settings panel.
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 Roo Code material we checked focuses on OpenAI-compatible or custom API setup, but it does not treat an extra
User-Agent as a required BetterToken step.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 and start using it
Click Save and Done, then select the configured model.
6
Restart Roo Code
After saving the config, restart VS Code or reload the Roo Code extension before selecting the configured model.
Roo Code’s OpenAI Compatible provider still depends on OpenAI-style tool calling. If you need extra headers, follow the current Roo Code docs or your upstream gateway requirements instead of assuming
User-Agent is mandatory for BetterToken.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
- OpenAI-compatible API vs Anthropic-compatible API
- MCP vs API Key and Base URL
- What are model_provider, base_url, and wire_api?
- How to configure an OpenAI-compatible API in Cline
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.