К содержимому
Блог

OpenCode: установка, выбор моделей и подключение по API-ключу

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):

bash
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

  1. Откройте провайдеров

    В левом нижнем углу нажмите значок настроек, затем выберите Server и Providers.

  2. Добавьте пользовательского провайдера

    В конце списка найдите Custom provider и нажмите Connect.

  3. Заполните форму

    Значения полей в таблице ниже. Заголовки запроса оставьте пустыми.

  4. Добавьте модели

    В разделе Models нажмите Add model и по одному впишите идентификаторы из каталога. Затем Submit.

  5. Назначьте модель по умолчанию

    В Settings откройте Server, затем Models и переключите модель чата по умолчанию на модель Relay. Новые диалоги пойдут через неё.

Поле формыЗначение
Provider IDrelay
Display nameRelay
Base URLhttps://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. Ключ читается из переменной окружения, поэтому в файле его нет:

json
{
  "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 конфигурации объединяются, а проектный файл перекрывает глобальный при конфликте. Так провайдер и ключ остаются у вас дома, а команда видит только выбор модели:

json
{
  "model": "relay/deepseek-v4.1-flash"
}

Проверка ключа до первого запуска

Прежде чем искать причину в настройках клиента, убедитесь, что ключ и модель отвечают сами по себе:

bash
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 Sol0,12 $ за 1 млн входных токенов
Gemini 3.7 Flash0,66 $ за 1 млн входных токенов
DeepSeek V4.1 Flash0,06 $ за 1 млн входных токенов
РольИдентификаторЗачем
Сложные задачи и рефакторинг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 явно и сверьте записи в журнале.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.