Cline Desktop

Подключение десктопного приложения Cline к usellm через OpenAI Compatible API

Cline Desktop

Cline Desktop: десктоп-приложение от команды Cline с поддержкой автономного выполнения задач: создание и редактирование файлов, запуск команд, работа с браузером. Подключается к usellm по протоколу OpenAI Compatible.

Эта страница про десктоп-приложение Cline. Расширение для VS Code / Cursor описано в интеграции с Cline.

Требования

  • Cline Desktop последней версии (скачать или установить через пакетный менеджер)
  • Аккаунт на usellm и API-ключ
  • Права на запись в ~/.cline/data/settings/models.json

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

Подключение состоит из двух частей: сначала регистрируем провайдера в GUI, затем правим models.json, чтобы Cline корректно подтянул каталог моделей.

  1. Откройте Settings → API Providers. В Cline Desktop перейдите в Settings, затем на вкладку API Providers.
  2. Зарегистрируйте OpenAI Compatible. Найдите в списке OpenAI Compatible и заполните поля:
    Статус провайдера в списке должен смениться на Configured.
  3. Закройте Cline Desktop. Полностью выйдите из приложения: изменения в models.json подхватываются только при следующем старте.
  4. Откройте models.json. Перейдите в папку с настройками:
    • Windows: C:\Users\<ИМЯ_ПОЛЬЗОВАТЕЛЯ>\.cline\data\settings\models.json
    • macOS / Linux: ~/.cline/data/settings/models.json

    Откройте файл models.json в любом текстовом редакторе.
  5. Замените секцию openai-compatible. Приведите секцию провайдера openai-compatible к виду:
    {
      "version": 1,
      "providers": {
        "openai-compatible": {
          "provider": {
            "name": "usellm",
            "baseUrl": "https://api.usellm.ru/v1",
            "defaultModelId": "zai/glm-5.3-flash",
            "protocol": "openai-chat",
            "client": "openai-compatible",
            "modelsSourceUrl": "https://api.usellm.ru/v1/models",
            "capabilities": [
              "tools",
              "popular",
              "reasoning",
              "vision",
              "prompt-cache"
            ]
          },
          "models": {
          }
        }
      }
    }
    

    defaultModelId: это модель, которая подставляется в пикер по умолчанию. Можно заменить на любую из каталога, например anthropic/claude-sonnet-5. Пустой объект "models": {} заставляет Cline подтянуть полный список с modelsSourceUrl при старте. :::

    Указанные capabilities: это заявленные возможности провайдера. Реальный набор зависит от выбранной модели. Если модель не поддерживает, например, vision, Cline всё равно покажет её как vision-capable, а ошибка вылезет уже на запросе.

  6. Запустите Cline и сделайте первый запрос. Откройте Cline Desktop заново, в пикере моделей выберите провайдера usellm и нужную модель, затем отправьте первый запрос.

Селектор усилия размышления (reasoning effort) в UI Cline Desktop по умолчанию выключен, если модели в models.json не помечены явно. Чтобы селектор заработал, каждая модель в секции [models.<id>] должна иметь поле supportsReasoning: true.

Cline Desktop читает только модели, перечисленные в [models.<id>]: модели, пришедшие из /v1/models провайдера, игнорируются, если их нет в models.json. Минимальный ручной пример, который включает reasoning:

{
  "version": 1,
  "providers": {
    "openai-compatible": {
      "provider": {
        "name": "usellm",
        "baseUrl": "https://api.usellm.ru/v1",
        "defaultModelId": "anthropic/claude-sonnet-5",
        "protocol": "openai-chat",
        "client": "openai-compatible",
        "modelsSourceUrl": "https://api.usellm.ru/v1/models",
        "capabilities": ["tools", "popular", "reasoning", "vision", "prompt-cache"]
      },
      "models": {
        "anthropic/claude-sonnet-5": {
          "id": "anthropic/claude-sonnet-5",
          "name": "anthropic/claude-sonnet-5",
          "supportsVision": true,
          "supportsAttachments": true,
          "supportsReasoning": true
        }
      }
    }
  }
}

Возможности

  • Автономные задачи: Cline Desktop сам создаёт и редактирует файлы, запускает команды в терминале, исправляет ошибки
  • Написание кода: генерация и рефакторинг по описанию на естественном языке
  • Работа с браузером: управление веб-страницами без участия пользователя
  • Tool calling: поддерживается всеми моделями с capability tools

Рекомендуемые модели

Cline Desktop активно использует tool calling, поэтому для стабильной работы подходят модели с надёжной поддержкой tools.

МодельIDОсобенности
Claude Fable 5.1anthropic/claude-fable-5.1Лучший выбор для сложных агентских задач
Claude Sonnet 5anthropic/claude-sonnet-5Оптимальный баланс скорости и качества, основной рабочий вариант
GPT-6 Astraopenai/gpt-6-astraFrontier для reasoning-задач, стабильный tool calling
Gemini 3.8 Flashgoogle/gemini-3.8-flashОчень быстрая, мультимодальная, хороша для коротких сессий
Qwen3.8 Flashalibaba/qwen3.8-flashСамая дешёвая в списке, подходит для типовых правок и теста подключения
GLM 5.3 Flashzai/glm-5.3-flashБыстрая и экономичная для рутинных задач

Cline Desktop активно вызывает инструменты (правка файлов, терминал, браузер). Модели со слабой поддержкой tool use зависают или выдают ошибки формата. Все модели в таблице выше стабильно работают с tools. Если хотите другую модель, проверьте её на простом запросе перед длинной агентской задачей.

Решение проблем

Следующие шаги