Настройка OpenCode с BetterToken

OpenCode можно подключить к BetterToken так: сначала добавьте credentials через /connect, затем объявите BetterToken как OpenAI-compatible provider в конфиге и выберите ID модели из Codex group.

Требования

API Key BetterToken (зарегистрироваться (https://www.bettertoken.ai/register))

Установка OpenCode

curl
npm

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

npm install -g opencode-ai

Настройка

Автоматическая настройка
Настройка через CC Switch
Ручная настройка

Можно запустить автоматический скрипт BetterToken. Он записывает только provider-конфигурацию BetterToken и не заменяет предварительные требования выше. Скрипту нужен Node.js. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.Выберите шаг для своей ОС. Нужен только один вариант.

macOS / Linux

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

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"

Очистите конфликтующие переменные окружения

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Сначала добавьте credential BetterToken через /connect

Запустите OpenCode и выполните:

/connect

В мастере выберите Other, затем:

задайте provider id как bettertoken
вставьте API Key BetterToken

OpenCode сохранит credential в ~/.local/share/opencode/auth.json.

Отредактируйте конфиг OpenCode

Можно использовать глобальный конфиг ~/.config/opencode/opencode.json или создать opencode.json в корне проекта. Project config имеет более высокий приоритет.

{
  "$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"
        }
      }
    }
  }
}

Замените YOUR_CODEX_MODEL_ID на актуальный ID модели Codex group из model plaza (https://www.bettertoken.ai/pricing).

Если нужно inline API key, используйте fallback-формат

{
  "$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"
        }
      }
    }
  }
}

Это fallback. Предпочтительный путь — /connect выше.

Используйте `options.headers` только для provider-specific задач

Официальная документация OpenCode поддерживает custom headers через provider.<id>.options.headers, но это optional. При подключении BetterToken обычно не нужен дополнительный User-Agent.Если вы также используете Helicone, tenant routing, observability или кеширующие сервисы, добавляйте нужные headers по официальной документации этих upstream-сервисов.

Перезапустите OpenCode

После обновления конфига завершите текущую сессию OpenCode и запустите ее снова.

Запустите OpenCode

cd /path/to/your/project
opencode

Примечания

Используйте ID модели Codex group по умолчанию вместо фиксированных имен Claude-моделей
Для BetterToken сейчас следует использовать @ai-sdk/openai-compatible как OpenAI-compatible provider adapter
Если вы используете /connect, обычно не нужно хранить API key прямо в конфиге
Официальная документация OpenCode трактует options.headers как optional extended configuration; BetterToken обычно не требует extra headers

​Требования

​Установка OpenCode

​Настройка

​Примечания

Требования

Установка OpenCode

Настройка

Примечания