Как подключить OpenCode к своему API

Подключите API провайдера, выбрав адаптер для его формата запросов.

  1. Выберите модель в каталоге. В документации провайдера найдите формат и адрес API, точный ID модели; создайте API-ключ.
  2. Создайте или дополните файл opencode.json в папке проекта. В примере для OpenCode 2 и совместимого Chat Completions замените API_BASE_URL адресом API, а MODEL_ID — точным ID модели. Если настройки уже есть, объедините поля с существующим JSON.

Значение API_BASE_URL заменяется адресом API; запись {env:API_KEY} оставьте как есть — OpenCode прочитает ключ из переменной API_KEY терминала.

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "myprovider": {
      "name": "Мой провайдер",
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "API_BASE_URL",
        "apiKey": "{env:API_KEY}"
      },
      "models": {
        "my-model": {
          "modelID": "MODEL_ID",
          "capabilities": { "tools": true }
        }
      }
    }
  }
}
  1. В терминале задайте переменную API_KEY, заменив ваш-ключ своим ключом:

macOS / Linux (bash или zsh):

export API_KEY='ваш-ключ'

Windows (PowerShell):

$env:API_KEY = 'ваш-ключ'
  1. В том же терминале запустите opencode. Выполните /models и выберите «Мой провайдер» и модель. Отправьте короткий запрос.

Для уже поддерживаемого провайдера можно также выполнить /connect, выбрать его и ввести ключ, а затем открыть /models. Для Anthropic-совместимого Messages API в OpenCode 2 выберите пакет @opencode/ai/providers/anthropic-compatible, для OpenAI-совместимого Responses API — @opencode/ai/providers/openai-compatible/responses; укажите адрес для выбранного протокола. Для версии 1 смотрите руководство по переходу.

Если не работает

Проверьте адрес, ID модели, ключ и доступный баланс у провайдера. Если модель отвечает, но не выполняет действия, сверьте настройки с инструкцией провайдера для вашего инструмента.

Источники: модели и свой API в OpenCode, подключение провайдеров, переход с версии 1.