Documentation Index
Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
Use this file to discover all available pages before exploring further.
OpenCode можно подключить к BetterToken так: сначала добавьте credentials через /connect, затем объявите BetterToken как OpenAI-compatible provider в конфиге и выберите ID модели из Codex group.
Требования
- API Key BetterToken (зарегистрироваться (
https://www.bettertoken.ai/register))
Установка OpenCode
curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai
Настройка
Можно запустить автоматический скрипт 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"
Этот путь описан в инструкции CC Switch.Перейдите сразу к вкладке OpenCode в инструкции CC Switch.После настройки в CC Switch вернитесь на эту страницу, чтобы проверить запуск и остальные примечания. Очистите конфликтующие переменные окружения
unset OPENAI_API_KEY
unset OPENAI_BASE_URL
Сначала добавьте credential BetterToken через /connect
Запустите OpenCode и выполните:В мастере выберите 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"
}
}
}
}
}
/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
