https://bettertoken.ai/v1, and an exact Model ID, save the binding, and start a new chat. Use this path when you want to select a compatible model for MonkeyCode yourself. If the error occurs in Kodacode / Koda, use the separate Kodacode setup and 429 error guide. Official product information and registration are available on the MonkeyCode website.
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
- MonkeyCode account (sign up at MonkeyCode)
Install
Install or open MonkeyCode, then continue with the manual setup below.Manual setup
Complete this setup in the MonkeyCode settings UI. You do not need to edit a configuration file.Setup
1
Log in to MonkeyCode
Visit MonkeyCode and log in.
2
Open system settings
Enter the task page, then click Settings in the bottom-right corner.
3
Bind an AI model
In the AI Model section, click Bind.
4
Fill in the BetterToken config
5
Only configure extra headers when the official docs explicitly require them
We did not find an official MonkeyCode setup requirement that makes
User-Agent mandatory for BetterToken. Start with the Base URL, API key, and model ID shown on this page.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.6
Save and start using it
Click Save, then return to the main page and select the model you just configured.
7
Restart MonkeyCode
After saving the config, refresh the page or reopen MonkeyCode before using the new model.
If you need extra headers, follow the current MonkeyCode 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.