Droid 接入 BetterToken 指南

Droid 是 Factory AI 的 CLI 编程助手。通过 BYOK 配置，可以将 BetterToken 作为自定义 OpenAI 兼容提供商接入。

前置条件

已获取 BetterToken API Key（注册并获取 (https://www.bettertoken.ai/register)）

安装 Droid

macOS / Linux
Windows

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

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

配置步骤

清除冲突的环境变量

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

设置 BetterToken API Key

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

编辑 Droid 配置文件

配置文件路径：~/.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
    }
  ]
}

将 YOUR_CODEX_MODEL_ID 替换为从模型广场 (https://www.bettertoken.ai/pricing)复制的 Codex 分组模型 ID。

仅在官方文档明确要求时再配置额外 headers

当前我们没有查到 Droid 官方接入说明要求 BetterToken 额外配置 User-Agent。默认先按页面中的 Base URL、API Key 和模型 ID 完成接入即可。如果你还接了自定义网关、租户路由或审计服务，再按对应上游服务的官方文档补充所需 headers。

重启 Droid

修改配置文件或环境变量后，请退出当前 Droid 进程，再重新启动。

启动 Droid

cd /path/to/your/project
droid

如果当前版本把 provider 文案显示为 OpenAI Compatible，以当前界面显示为准。如需额外 headers，请以 Droid 官方当前版本说明或上游网关要求为准，不要默认把 User-Agent 当作 BetterToken 必填项。

​前置条件

​安装 Droid

​配置步骤

前置条件

安装 Droid

配置步骤