Droid BetterToken setup guide

Droid is Factory AI’s CLI coding assistant. With BYOK, you can connect BetterToken as a custom OpenAI-compatible provider.

Prerequisites

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

Install Droid

macOS / Linux
Windows

curl -fsSL https://app.factory.ai/cli | sh

irm https://app.factory.ai/cli/windows | iex

Setup

Clear conflicting environment variables

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Set the BetterToken API Key

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Edit the Droid config file

Config file path: ~/.factory/settings.json

{
  "customModels": [
    {
      "displayName": "BetterToken Codex",
      "model": "YOUR_CODEX_MODEL_ID",
      "baseUrl": "https://www.bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai",
      "maxOutputTokens": 64000
    }
  ]
}

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

Only configure extra headers when the official docs explicitly require them

We did not find an official Droid 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.

Restart Droid

After updating the config file or environment variables, stop the current Droid process and launch it again.

Start Droid

cd /path/to/your/project
droid

If your version labels the provider as OpenAI Compatible instead of openai, follow the current UI label. If you need extra headers, follow the current Droid docs or your upstream gateway requirements instead of assuming User-Agent is mandatory for BetterToken.

​Prerequisites

​Install Droid

​Setup

Prerequisites

Install Droid

Setup