Skip to main content
Настройка 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 выбирайте по руководству по моделям.

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

Подготовка

Установка

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

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

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

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

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

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

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

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

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

Смена модели

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

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

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

Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Настройка командой + вручную: доступна готовая команда и полная ручная настройка.
  • Ручная настройка: укажите API Key, Base URL и Model.
  • Не поддерживается: проверенный способ прямого подключения пока отсутствует.

Связанные FAQ

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

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

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

Provider OpenCode имеет id bettertoken и использует @ai-sdk/openai-compatible с Chat Completions. GPT, Kimi и GLM — провайдеры моделей в BetterToken; в models нужно указать выбранный полный Model ID.