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 корректно подтянул каталог моделей.
- Откройте Settings → API Providers. В Cline Desktop перейдите в Settings, затем на вкладку API Providers.
- Зарегистрируйте OpenAI Compatible. Найдите в списке OpenAI Compatible и заполните поля:
- Base URL:
https://api.usellm.ru/v1 - API Key: ваш ключ из личного кабинета
Статус провайдера в списке должен смениться на Configured. - Base URL:
- Закройте Cline Desktop. Полностью выйдите из приложения: изменения в
models.jsonподхватываются только при следующем старте. - Откройте models.json. Перейдите в папку с настройками:
- Windows:
C:\Users\<ИМЯ_ПОЛЬЗОВАТЕЛЯ>\.cline\data\settings\models.json - macOS / Linux:
~/.cline/data/settings/models.json
Откройте файлmodels.jsonв любом текстовом редакторе. - Windows:
- Замените секцию 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, а ошибка вылезет уже на запросе. - Запустите 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.1 | anthropic/claude-fable-5.1 | Лучший выбор для сложных агентских задач |
| Claude Sonnet 5 | anthropic/claude-sonnet-5 | Оптимальный баланс скорости и качества, основной рабочий вариант |
| GPT-6 Astra | openai/gpt-6-astra | Frontier для reasoning-задач, стабильный tool calling |
| Gemini 3.8 Flash | google/gemini-3.8-flash | Очень быстрая, мультимодальная, хороша для коротких сессий |
| Qwen3.8 Flash | alibaba/qwen3.8-flash | Самая дешёвая в списке, подходит для типовых правок и теста подключения |
| GLM 5.3 Flash | zai/glm-5.3-flash | Быстрая и экономичная для рутинных задач |
Cline Desktop активно вызывает инструменты (правка файлов, терминал, браузер). Модели со слабой поддержкой tool use зависают или выдают ошибки формата. Все модели в таблице выше стабильно работают с tools. Если хотите другую модель, проверьте её на простом запросе перед длинной агентской задачей.