opencode в России: настройка своего провайдера

Коротко: opencode — это ИИ-агент для терминала, который не привязан к одному провайдеру. В файле opencode.json можно объявить любой OpenAI-совместимый сервис, указать его baseURL и ключ — и работать дальше как обычно. Ниже — готовый конфиг и разбор ошибок, на которых спотыкаются чаще всего.

Что такое opencode

opencode — консольный агент для написания кода: он читает проект, правит файлы, запускает команды и умеет работать headless (без интерфейса), что удобно для CI. От расширений вроде Cline он отличается тем, что живёт в терминале и не требует VS Code.

Ключевое для нас свойство — свои провайдеры. opencode подключает их через пакет @ai-sdk/openai-compatible, который рассчитан ровно на эндпоинт /v1/chat/completions. Поэтому любой сервис с OpenAI-совместимым API добавляется в конфиг руками.

Шаг 1. Установка

Через npm (нужен Node.js 20 и новее):

npm install -g opencode-ai

Проверьте, что бинарник на месте:

opencode --version

Шаг 2. Получите base_url и ключ

Нужны две вещи, и обе выдаются одной кнопкой прямо здесь:

• Base URL вида https://twelver.ru/api/ai/<config-id>/v1 — здесь config-id это ваш слот конфигурации, в котором хранится выбранная серия моделей;
• API-ключ вида sk-… — показывается один раз, скопируйте сразу.

Скопированный конфиг рабочий как есть. Но ключ в нём лежит открытым текстом, поэтому в проекте его лучше вынести в переменную окружения — так он не уедет в git:

export TWELVER_API_KEY="sk-<ваш-ключ>"

Шаг 3. Пропишите провайдера в opencode.json

Глобальный конфиг лежит в ~/.config/opencode/opencode.json, конфиг проекта — в opencode.json в корне репозитория. Настройки проекта перекрывают глобальные, так что под конкретный проект можно поставить другую модель.

Вариант из виджета выше объявляет одну модель — auto. Ниже тот же конфиг, но развёрнутый: ключ вынесен в переменную окружения, объявлено несколько серий и добавлен small_model.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "twelver": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Twelver",
      "options": {
        "baseURL": "https://twelver.ru/api/ai/<ваш-config-id>/v1",
        "apiKey": "{env:TWELVER_API_KEY}"
      },
      "models": {
        "auto": { "name": "Qwen3.7-Plus (auto)" },
        "qwen-flash": { "name": "Qwen3.8-Flash" },
        "zai": { "name": "GLM-5.3" },
        "grok": { "name": "Grok 4.6" }
      }
    }
  },
  "model": "twelver/auto",
  "small_model": "twelver/qwen-flash"
}

Два поля внизу решают, сколько вы потратите. model — основная модель, которой агент пишет код. small_model — дешёвая модель для служебных задач (заголовки сессий, короткие вспомогательные запросы). Если её не задать, opencode использует основную модель и для этих мелких запросов.

Шаг 4. Запуск

cd ваш-проект
opencode

Внутри сессии модель переключается командой /models — там появится провайдер twelver с моделями, которые вы объявили в конфиге. Правила для агента (стиль кода, что трогать нельзя) кладутся в файл AGENTS.md в корне проекта.

Какую серию выбрать

Названия моделей в конфиге — это серии, а не конкретные версии. Серия сама указывает на актуальную модель, поэтому конфиг не придётся править после обновления.

Как не переплачивать

• Задайте small_model. Служебные запросы идут постоянно, и на дорогой модели они незаметно съедают заметную долю счёта.
• Новая сессия под новую задачу. Контекст отправляется целиком при каждом запросе, поэтому длинная сессия дорожает с каждым сообщением.
• Сужайте контекст. Чем меньше файлов агент тянет в запрос, тем дешевле выходит вход — а именно вход доминирует в счёте.
• Начинайте с дешёвой серии. Поднимать класс модели стоит только там, где качества действительно не хватило.

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

Попробуйте сами

Получите base_url и ключ прямо сейчас

Кнопка на странице API выдаёт адрес и ключ сразу — без регистрации и без привязки карты.

Получить API-ключ

⚡Лендинг по темеAPI для кодаTwelver на AndroidТот же чат в приложении