Настройка кастомной модели OpenCode через LLMEasy

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

Требования

API Key LLMEasy (зарегистрироваться)

Установка OpenCode

curl
npm

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

npm install -g opencode-ai

Настройка

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

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

macOS / Linux

curl -fsSL https://www.llmeasy.ru/install-opencode-provider.sh | bash

Windows

iwr https://www.llmeasy.ru/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 LLMEasy через /connect

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

/connect

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

задайте provider id как llmeasy
вставьте API Key LLMEasy

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

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "model": "llmeasy/YOUR_GPT_MODEL_ID",
  "provider": {
    "llmeasy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLMEasy",
      "options": {
        "baseURL": "https://www.llmeasy.ru/v1"
      },
      "models": {
        "YOUR_GPT_MODEL_ID": {
          "name": "YOUR_GPT_MODEL_ID"
        }
      }
    }
  }
}

Замените YOUR_GPT_MODEL_ID на актуальный ID модели группы GPT из model plaza.

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

{
  "$schema": "https://opencode.ai/config.json",
  "model": "llmeasy/YOUR_GPT_MODEL_ID",
  "provider": {
    "llmeasy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLMEasy",
      "options": {
        "baseURL": "https://www.llmeasy.ru/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "YOUR_GPT_MODEL_ID": {
          "name": "YOUR_GPT_MODEL_ID"
        }
      }
    }
  }
}

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

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

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

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

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

Запустите OpenCode

cd /path/to/your/project
opencode

Связанные FAQ

Примечания

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

​Требования

​Установка OpenCode

​Настройка

​Связанные FAQ

​Примечания

Требования

Установка OpenCode

Настройка

Связанные FAQ

Примечания