Tokens Code is the tokens.bd coding agent for VS Code and editors built on it, such as Cursor, Windsurf and VSCodium. It plans, edits files, runs commands and answers questions about your code, using the models in your tokens.bd plan. You log in once in your browser: there is no API key to copy or paste.
Tokens Code is based on Kilo Code, an open-source agent, and keeps its features. It never sends anything to Kilo's servers.
Install Tokens Code#
- In your editor, open the Extensions view (Ctrl+Shift+X, or Cmd+Shift+X on a Mac).
- Search for Tokens Code and pick the one published by tokensbd.
- Click Install. A Tokens Code icon appears in the activity bar.
VS Code installs it from the Visual Studio Marketplace. Cursor, Windsurf and VSCodium install it from Open VSX. Both have the same extension.
Log in with tokens.bd#
- Open Tokens Code from the activity bar and click Log in with tokens.bd.
- Your browser opens tokens.bd. Sign in if you are asked to, check the computer and editor names, then click Approve.
- The browser hands you back to the editor and Tokens Code shows your account.
Tokens Code creates an API key for this computer, named Tokens Code on followed by the computer's name. It appears on your API keys page, and its usage shows under the Tokens Code project in Usage. Each computer you log in from gets its own key.
If the browser does not return to the editor#
In a remote window (Remote SSH, WSL, Codespaces) or when your browser blocks the editor link, the approval page shows a login code instead. Copy it, go back to Tokens Code and paste it into the Browser didn't come back? box, then click Log in. The code works once, for 5 minutes.
Choose a model#
Pick a model from the model selector under the chat box. The list holds the models your plan includes, plus pay-as-you-go models when your wallet has a balance. New chats start on auto, a good default the Tokens team chooses; pick a specific model when you want the same one every time. A model that takes effort levels shows a picker for them.
Your account and usage#
Click the account icon at the top of the Tokens Code panel to see:
| Shown | Meaning |
|---|---|
| Plan | Your current plan and when it renews |
| Usage limits | How much of each plan window (5-hour, weekly or monthly) you have used, and when it resets |
| Balance | Your wallet balance |
The Dashboard and Top up buttons open tokens.bd. Log out deletes this computer's key on tokens.bd and forgets it in the editor.
When tokens.bd refuses a request#
If a request can't go ahead, Tokens Code shows tokens.bd's message in the chat with what to do and a button to the right page:
| Message | What to do |
|---|---|
| Balance used up | Top up your wallet or choose a plan in Billing |
| Usage limit reached | Wait for the window to reset, shown in Usage, or top up |
| Model not in your plan | Pick another model, or see Pricing |
| Key limit | Change the key's model list or monthly cap on API keys |
| Key no longer works | Log in again |
Each message shows a request ID; include it when you contact support.
Use other providers too#
Tokens Code also works with your own API keys for other providers, such as OpenAI, Anthropic, OpenRouter or a local Ollama. Open Settings, then Providers, and add one. Your tokens.bd login and other providers can be used side by side.
Inline autocomplete (suggestions as you type) is not available yet: tokens.bd does not offer an autocomplete model. It will appear in Settings once it does.
Privacy and telemetry#
Tokens Code sends anonymous usage events to tokens.bd only while telemetry is on in your editor, and never your prompts, code, file paths or account. Turn VS Code's telemetry setting off to stop it. See section 6 of the privacy policy.
Troubleshooting#
"Verify your email first": confirm the email we sent when you signed up, then log in from Tokens Code again.
"Members with the … role can't create API keys": your team role can't create keys. Ask a team owner or admin to change your role, or to log in for you.
"Too many logins": you started more logins in the last hour than we allow. Wait a little and try again.
The login timed out: approval codes last 5 minutes. Click Log in with tokens.bd again.
The model list is empty: you have no active plan and no wallet balance. Subscribe or top up in Billing, then reopen the model selector.