Как подключить OpenCode к своему API
Подключите API провайдера, выбрав адаптер для его формата запросов.
- Выберите модель в каталоге. В документации провайдера найдите формат и адрес API, точный ID модели; создайте API-ключ.
- Создайте или дополните файл
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 }
}
}
}
}
}- В терминале задайте переменную
API_KEY, заменивваш-ключсвоим ключом:
macOS / Linux (bash или zsh):
export API_KEY='ваш-ключ'Windows (PowerShell):
$env:API_KEY = 'ваш-ключ'- В том же терминале запустите
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.