OpenCode BetterToken setup guide

You can connect BetterToken to OpenCode by first adding credentials with /connect, then declaring BetterToken as an OpenAI-compatible provider in the config file and selecting a model ID from the Codex group.

Prerequisites

BetterToken API Key (register here (https://www.bettertoken.ai/register))

Install OpenCode

curl
npm

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

Setup

Automatic setup
Configure via CC Switch
Manual setup

You can run the BetterToken automatic setup script directly. It only writes the BetterToken provider configuration and does not replace the installation prerequisites above. The script requires Node.js. If you do not pass an API Key or model explicitly, the script prompts for them when the tool supports interactive input.Follow the step for your operating system. You only need one of them.

If you use macOS / Linux

curl -fsSL https://www.bettertoken.ai/install-opencode-provider.sh | bash

If you use Windows

iwr https://www.bettertoken.ai/install-opencode-provider.ps1 -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

Clear conflicting environment variables

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Add the BetterToken credential with /connect first

Start OpenCode and run:

/connect

In the wizard, choose Other and then:

set the provider id to bettertoken
paste your BetterToken API Key

OpenCode stores the credential in ~/.local/share/opencode/auth.json.

Edit the OpenCode config file

You can use the global config at ~/.config/opencode/opencode.json or create opencode.json in your project root. The project config has higher precedence.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_CODEX_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "YOUR_CODEX_MODEL_ID": {
          "name": "YOUR_CODEX_MODEL_ID"
        }
      }
    }
  }
}

Replace YOUR_CODEX_MODEL_ID with a current Codex group model ID copied from the model plaza (https://www.bettertoken.ai/pricing).

If you want to inline the API key, use this fallback format

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_CODEX_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "YOUR_CODEX_MODEL_ID": {
          "name": "YOUR_CODEX_MODEL_ID"
        }
      }
    }
  }
}

This is a fallback. The /connect flow above is the preferred setup.

Only use `options.headers` for provider-specific needs

OpenCode’s official docs support custom headers through provider.<id>.options.headers, but this is optional. You usually do not need an extra User-Agent when connecting BetterToken.If you are also using Helicone, tenant routing, observability, or caching services, add the required headers based on those upstream services’ official docs.

Restart OpenCode

After updating the config file, quit the current OpenCode session and start it again.

Start OpenCode

cd /path/to/your/project
opencode

Notes

Use a Codex group model ID as the default model instead of fixed Claude model names
BetterToken should currently use @ai-sdk/openai-compatible as the OpenAI-compatible provider adapter
If you use /connect, you usually do not need to store the API key directly in the config file
OpenCode’s official docs treat options.headers as optional extended configuration; BetterToken usually does not need extra headers

​Prerequisites

​Install OpenCode

​Setup

​Notes

Prerequisites

Install OpenCode

Setup

Notes