OpenCode: как подключить свой API через /connect

Что такое OpenCode

OpenCode — open-source кодинг-агент для терминала от команды SST: удобный TUI, интеграция с LSP, поддержка любых провайдеров. Работает в любом терминале на macOS, Linux и Windows; с ключом LLMost агент использует любые модели каталога.

Требования

Терминал (macOS, Linux или Windows)
Аккаунт LLMost с API-ключом

Установка

Официальный установщик:

curl -fsSL https://opencode.ai/install | bash

Альтернативы: npm i -g opencode-ai или brew install sst/tap/opencode.

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...).
Запустите opencode и выполните команду:
```
/connect
```
В списке провайдеров выберите Other.
В поле Enter provider id введите llmost.
В поле Enter your API key вставьте ваш ключ llmost_... — OpenCode сохранит его в своём хранилище учётных данных, переменные окружения не нужны.

Осталось рассказать OpenCode, куда ходить с этим ключом и какие модели доступны. Создайте конфиг ~/.config/opencode/opencode.json (глобально) или opencode.json в корне проекта — id провайдера должен совпадать с введённым в /connect:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "llmost": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLMost",
      "options": {
        "baseURL": "https://llmost.ru/api/v1"
      },
      "models": {
        "~anthropic/claude-sonnet-latest": {
          "name": "Claude Sonnet (LLMost)",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "deepseek/deepseek-v3.2-20251201": {
          "name": "DeepSeek V3.2 (LLMost)",
          "limit": { "context": 163840, "output": 8192 }
        }
      }
    }
  }
}

Перезапустите opencode, откройте список моделей командой /models и выберите модель LLMost.

Поле limit подсказывает агенту размер контекста и максимальную длину ответа — значения берите со страницы модели в каталоге LLMost.

Выбор модели

В списке /models появляются только модели, описанные в конфиге, — добавьте те, что нужны. Для агентной работы модель обязана поддерживать tool calling:

~anthropic/claude-sonnet-latest — лучший выбор для агентного кодинга;
~openai/gpt-latest — универсальная флагманская альтернатива;
deepseek/deepseek-v3.2-20251201 — бюджетный вариант для простых задач.

Алиасы, начинающиеся с ~, всегда указывают на актуальную версию модели.

Проверка

Запустите OpenCode в каталоге любого проекта и дайте простую задачу:

opencode "Создай файл hello.txt с текстом Привет"

Агент создаст файл — значит, всё работает.

Чтобы проверить подключение в обход OpenCode, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Моделей LLMost нет в /models. Проверьте opencode.json на синтаксические ошибки (валидный JSON, без запятых в конце) и что файл лежит в ~/.config/opencode/ или в корне проекта.

Ошибка авторизации (401). Ключ не привязан к провайдеру: id, введённый в /connect, должен совпадать с ключом секции в opencode.json (в нашем примере — llmost). Повторите /connect с правильным id; при смене ключа — тоже просто выполните /connect заново.

Ошибка 402 «Недостаточно средств». Пополните баланс LLMost в личном кабинете.

Агент отвечает текстом, но не выполняет действия. Выбранная модель не поддерживает tool calling — смените её на одну из рекомендованных выше.

Агент «забывает» контекст на длинных задачах. Укажите реальный размер контекста модели в поле limit.context — без него OpenCode использует консервативное значение по умолчанию.

Ссылки

Официальный сайт: opencode.ai
Документация: opencode.ai/docs
GitHub: sst/opencode
Другие приложения — в каталоге ИИ-агентов

OpenCode + LLMost: установка и настройка