Настройка OpenCode: скачать, подключить API Key и Base URL

Настройка OpenCode начинается с установки CLI и подключения BetterToken через @ai-sdk/openai-compatible. Назовите provider в OpenCode BetterToken или OpenAI Compatible. Если вам нужна обычная настройка API Key, Base URL или opencode.json без привязки к конкретной модели, оставайтесь на этой странице.

OpenCode: скачать и настроить provider

Установите OpenCode из официального источника, затем сохраните credential через /connect или настройте opencode.json. Инструкции для GLM и для Kimi K3 нужны только для выбора и проверки конкретной модели. Точный Model ID выбирайте по руководству по моделям.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

Подготовка

Установите последнюю версию OpenCode
Создайте API Key BetterToken
Скопируйте Model ID из model plaza или окна Setup для ключа

Установка

curl
npm

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

npm install -g opencode-ai

Настройка командой

Скрипт Automatic setup BetterToken создаёт или обновляет provider BetterToken в OpenCode. Для работы нужен Node.js. Если API Key или Model ID не переданы через параметры, скрипт запросит их во время запуска.

macOS / Linux
Windows

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

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

После завершения выберите bettertoken/YOUR_MODEL_ID. Если OpenCode уже запущен, перезапустите его перед проверкой.

Ручная настройка

Вариант 1: сохраните credential через /connect

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

/connect

Выберите Other, укажите provider id bettertoken, затем введите YOUR_API_KEY. OpenCode сохранит credential локально.

Вариант 2: настройте JSON

Глобальный файл: ~/.config/opencode/opencode.json. Для проекта можно использовать opencode.json в его корне.

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

Если /connect не используется, добавьте "apiKey": "YOUR_API_KEY" в options. Не отправляйте конфигурацию с реальным ключом в Git.

Проверка подключения

Запустите opencode в проекте, выберите bettertoken/YOUR_MODEL_ID и отправьте короткое сообщение. Обычный ответ подтверждает настройку. После изменения JSON перезапустите OpenCode.

Смена модели

Добавьте новый YOUR_MODEL_ID в provider.bettertoken.models, обновите верхнее поле model, сохраните файл и перезапустите OpenCode.

Частые ошибки

Ошибка	Решение
`401`	Повторите `/connect` или проверьте `apiKey`.
`404`	В `baseURL` укажите только `https://bettertoken.ai/v1`, без `/chat/completions`.
Модель не найдена	Верхнее поле `model` должно точно совпадать с ID внутри `models`.
Конфигурация не применилась	Проверьте, не переопределяет ли проектный `opencode.json` глобальный файл, затем перезапустите OpenCode.

Расширенная настройка

Связанные FAQ

Дополнительно: управление provider через CC Switch

Если вы хотите управлять providers нескольких инструментов в одном месте, см. настройку OpenCode в CC Switch.

Технические детали

Настройка модели

Provider OpenCode имеет id bettertoken и использует @ai-sdk/openai-compatible с Chat Completions. Скопируйте точный Model ID из model plaza.

Начало работы

Подключение Coding Agent

Подключение AI-платформ

Дополнительно

Настройка OpenCode: скачать, подключить API Key и Base URL

OpenCode: скачать и настроить provider

Ключевые параметры

Подготовка

Установка

Настройка командой

Ручная настройка

Вариант 1: сохраните credential через /connect

Вариант 2: настройте JSON

Проверка подключения

Смена модели

Частые ошибки

Расширенная настройка

Связанные FAQ

Дополнительно: управление provider через CC Switch

Технические детали

​OpenCode: скачать и настроить provider

​Ключевые параметры

​Подготовка

​Установка

​Настройка командой

​Ручная настройка

​Вариант 1: сохраните credential через /connect

​Вариант 2: настройте JSON

​Проверка подключения

​Смена модели

​Частые ошибки

​Расширенная настройка

​Связанные FAQ

​Дополнительно: управление provider через CC Switch

​Технические детали

OpenCode: скачать и настроить provider

Ключевые параметры

Подготовка

Установка

Настройка командой

Ручная настройка

Вариант 1: сохраните credential через /connect

Вариант 2: настройте JSON

Проверка подключения

Смена модели

Частые ошибки

Расширенная настройка

Связанные FAQ

Дополнительно: управление provider через CC Switch

Технические детали