OpenCode: установка, выбор моделей и подключение по API-ключу
OpenCode это открытый ИИ-ассистент для программирования: он работает в терминале и в десктопном или веб-интерфейсе, а модель вы выбираете сами. Привязки к одному вендору нет, поэтому его берут, когда хотят прогнать несколько моделей по одному и тому же репозиторию. Ниже установка, два способа подключить Relay, подбор моделей и одно ограничение клиента, о котором лучше узнать до первого запроса.
Коротко
Relay добавляется в OpenCode как пользовательский провайдер: Provider ID
relay, адресhttps://relay-llm.ru/v1, ключ из консоли и список идентификаторов моделей.Пользовательские провайдеры OpenCode говорят только по протоколу OpenAI, поэтому Relay не рекомендует гонять через них модели Claude.
Задавайте и основную, и «малую» модель явно: иначе в биллинге появится модель, которую вы не выбирали.
Файловая настройка
opencode.jsonудобна для терминала и хранится в репозитории без ключа.
Установка
Страница Relay отсылает за приложением на страницу загрузки OpenCode, а после установки предлагает запустить opencode. Для терминала есть и пакетные способы, вот они (по сведениям нашего источника на 29 октября 2026):
npm install -g opencode-ai
brew install anomalyco/tap/opencodeПервая команда подойдёт, если есть Node.js, вторая для Homebrew. На сайте проекта есть ещё скрипт установки в одну строку для macOS и Linux и готовые установщики десктопного приложения. Одна оговорка: по тому же источнику, у OpenCode сейчас две ветки с разными командами установки и разным форматом конфигурации. Попали на вторую ветку, сверяйтесь с её документацией: пример opencode.json ниже рассчитан на первую.
Zen и Go: модели от самого OpenCode
У самого проекта есть два способа получить модели, и их полезно отличать от подключения по своему ключу. По описанию в документации OpenCode (сведения источника на 29 октября 2026), Zen это каталог проверенных командой моделей с оплатой по факту использования через консоль OpenCode, а Go подписка на популярные открытые модели для кода. Бесплатные модели в Zen, по тем же сведениям, выдаются на ограниченное время. Условия, цены и способы оплаты читайте у вендора. Relay с ними не связан: вы подключаете его как отдельного провайдера по своему ключу и платите токенами с баланса.
Подключение Relay в десктопном приложении
Пользовательский провайдер в OpenCode Desktop
- Откройте провайдеров
В левом нижнем углу нажмите значок настроек, затем выберите Server и Providers.
- Добавьте пользовательского провайдера
В конце списка найдите Custom provider и нажмите Connect.
- Заполните форму
Значения полей в таблице ниже. Заголовки запроса оставьте пустыми.
- Добавьте модели
В разделе Models нажмите Add model и по одному впишите идентификаторы из каталога. Затем Submit.
- Назначьте модель по умолчанию
В Settings откройте Server, затем Models и переключите модель чата по умолчанию на модель Relay. Новые диалоги пойдут через неё.
| Поле формы | Значение |
|---|---|
| Provider ID | relay |
| Display name | Relay |
| Base URL | https://relay-llm.ru/v1 |
| API key | ключ, созданный в консоли Relay |
Список идентификаторов, проверенных на странице интеграции OpenCode, включает gpt-6.1-sol, gpt-6-astra, gemini-3.1-pro, gemini-3.7-flash, deepseek-v4.1-flash, deepseek-v4.1-flash-1017-free, glm-5.3 и grok-4.5. Актуальный перечень всегда отдаёт метод моделей.
Настройка файлом opencode.json
Терминальному пользователю удобнее файл. Формат описан в документации OpenCode, структура ниже собрана по ней, а размеры окон взяты из карточек каталога Relay. Ключ читается из переменной окружения, поэтому в файле его нет:
{
"model": "relay/gpt-6.1-sol",
"small_model": "relay/deepseek-v4.1-flash",
"provider": {
"relay": {
"npm": "@ai-sdk/openai-compatible",
"name": "Relay",
"options": {
"baseURL": "https://relay-llm.ru/v1",
"apiKey": "{env:RELAY_API_KEY}"
},
"models": {
"gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 1000000, "output": 128000 } },
"gemini-3.7-flash": { "name": "Gemini 3.7 Flash", "limit": { "context": 1000000, "output": 65000 } },
"deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash", "limit": { "context": 1000000, "output": 131072 } }
}
}
}
}Блок limit лучше оставить: когда клиент не знает размер окна, он не умеет вовремя сжимать историю. Модель пишется как провайдер, косая черта и идентификатор. Не видите новую модель в списке? Ищите причину в трёх местах: лишняя запятая делает файл невалидным JSON, модель могла остаться вне блока models, а идентификатор обязан совпадать с ответом GET /v1/models символ в символ.
В репозиторий можно положить урезанный opencode.json без провайдера и ключа: по документации OpenCode конфигурации объединяются, а проектный файл перекрывает глобальный при конфликте. Так провайдер и ключ остаются у вас дома, а команда видит только выбор модели:
{
"model": "relay/deepseek-v4.1-flash"
}Проверка ключа до первого запуска
Прежде чем искать причину в настройках клиента, убедитесь, что ключ и модель отвечают сами по себе:
curl https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "Ответь одним словом: готово"}]}'Ответ 401 говорит о неверном или отключённом ключе, 404 с кодом model_not_found об опечатке в идентификаторе, 402 о нулевом балансе. Если прямой запрос проходит, а OpenCode молчит, ищите проблему в форме провайдера или в opencode.json.
Какие модели добавить
| Роль | Идентификатор | Зачем |
|---|---|---|
| Сложные задачи и рефакторинг | gpt-6.1-sol | сильная модель для долгих правок |
| Быстрые ответы в редакторе | gemini-3.7-flash | у карточки отмечены инструменты и контекст 1 000 000 токенов |
| Служебные и мелкие задачи | deepseek-v4.1-flash | подходит на роль малой модели |
Для проверки связки без лишних трат добавьте в блок models модель с пометкой Free, deepseek-v4.1-flash-1017-free: условия и лимиты смотрите в её карточке. Остальные модели из списка вроде glm-5.3 или grok-4.5 добавляются тем же образом, по одной строке на модель.
Это стартовая схема, а не результат бенчмарка. Проверьте её на десятке своих задач: способ описан в статье про выбор нейросети для программирования.
Ограничение: модели Claude лучше вести другим клиентом
Страница Relay говорит прямо: из-за ограничения клиента пользовательские провайдеры OpenCode поддерживают только протокол OpenAI. При вызове моделей Claude таким путём кэширование может работать хуже, запросы могут срываться, а расходы расти. Relay не рекомендует использовать Claude в OpenCode. Когда нужен Claude, берите клиент Claude, например Claude Code.
Есть и вторая тонкость. Клиенты часто поручают вспомогательную работу отдельной моделью, а Relay учитывает фактическую модель каждого запроса. Поэтому в журнале может мелькнуть идентификатор, которого вы не выбирали. Это не сбой выбора: настройка small_model из примера выше как раз закрывает этот случай явным значением.
OpenCode бесплатный?
Сам клиент открыт и бесплатен, платить нужно за модели. В Relay подписки нет: токены списываются с баланса по цене из карточки модели. В каталоге есть и модель с пометкой Free, её условия смотрите в карточке.
Как подключить свой ключ к OpenCode?
В десктопе откройте Server, Providers и Custom provider. В терминале опишите провайдера в opencode.json, указав адрес https://relay-llm.ru/v1, ключ из консоли и список моделей.
Почему в биллинге не та модель, которую я выбрал?
Скорее всего, клиент вызвал вспомогательную модель для служебной работы. Relay записывает фактическую модель каждого запроса. Задайте small_model явно и сверьте записи в журнале.