Cline Desktop и CLI: свой API и проверка подключения
Cline Desktop и Cline CLI подключают к Relay через собственный API, если установленная версия позволяет задать провайдера, адрес, ключ и модель. В документации Relay разобрана настройка Cline через OpenAI Compatible: https://relay-llm.ru/v1, ключ Relay и точный ID модели. Настройка сверена с документацией; отдельный живой прогон Desktop и CLI этим не подтверждён.
Коротко
Проверьте, где ваша версия Cline настраивает провайдер OpenAI Compatible.
Для этого провайдера укажите базовый адрес с
/v1, ключ и ID из каталога Relay.Сначала выполните короткий API-запрос вне клиента, потом проверяйте Cline и журнал запросов.
Как проверить свой API в Cline Desktop и CLI
Под названием Cline встречаются расширение для редактора и варианты запуска с разными экранами настроек. Они могут по-разному называть поле провайдера и хранить конфигурацию. Нельзя переносить путь к файлу или название кнопки из старого ролика без проверки. Откройте официальное руководство своей версии и найдите, есть ли выбор OpenAI Compatible и отдельные поля Base URL, API Key и Model ID.
Relay поддерживает OpenAI Chat Completions, а его страница интеграции Cline описывает подтверждённые поля и типичные отказы. Если в конкретной версии нет собственного базового адреса, не заменяйте его браузерной сессией и не редактируйте неизвестные внутренние файлы. Возьмите клиент с документированной поддержкой собственного API.
Что проверить до настройки Cline
Выпустите отдельный ключ в кабинете. Не используйте ключ, который уже стоит в продакшен-сервисе: у инструментального клиента другой набор запросов и другой риск утечки через логи. Затем выберите модель в каталоге. Для короткой проверки подойдёт gpt-6-sol, если её параметры в карточке соответствуют вашей задаче.
Перед запуском интерфейса Cline сделайте независимую проверку. Она отделяет проблему ключа или сети от проблемы клиента. Команда ниже читает секрет из окружения. Отключите трассировку оболочки и не прикладывайте подробные HTTP-логи с заголовками:
curl https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"Ответь одним словом: ping"}]}'Если запрос вернул ответ, адрес, ключ и модель готовы. Если нет, исправьте это до настройки Cline. Повторные запуски агента не помогут, когда в базовом URL опечатка.
Как задать свой API в Cline
В настройках Cline выберите API Provider: OpenAI Compatible. Введите Base URL ровно https://relay-llm.ru/v1. Не добавляйте /chat/completions, потому что клиент сам дописывает путь метода. Не убирайте /v1, иначе запрос придёт на неизвестный маршрут. В поле API Key вставьте созданный ключ, а в Model ID точный идентификатор из каталога, например gpt-6-sol.
Некоторые версии запрашивают список моделей. Его отсутствие не означает, что модель можно угадать. Скопируйте ID из каталога и сначала проверьте его отдельной командой. Если Cline позволяет заполнить настройки модели, сверяйте контекст, лимит вывода и стоимость с карточкой, а не с предположением интерфейса. Встроенный счётчик клиента может не совпасть с фактическим расходом API.
Как проверить Cline CLI без выдуманных флагов
Найдите в руководстве установленного Cline CLI раздел настройки провайдера. Если вы искали «Cline CLI 2.0», номер из поискового запроса не подтверждает формат конфигурации вашей программы. Эта инструкция не задаёт путь к файлу или CLI-флаг, которых нет в документации Relay. Найдите соответствие четырём полям из предыдущего раздела; если своего адреса нет, используйте документированный вариант Cline.
Для Desktop тоже проверьте сохранённые значения после переключения профиля. Сам факт входа в приложение не означает, что оно использует ключ Relay. В новом чате задайте короткий вопрос, затем сопоставьте модель и ключ в журнале. Не запускайте параллельно другие клиенты с тем же ключом, пока проверяете подключение.
Как сверить запрос с журналом Relay
Даже короткое задание агент может выполнить несколькими запросами. Проверьте все записи за время пробы, отфильтровав журнал по отдельному ключу Cline. В журнале кабинета сопоставьте время, модель и результат. Если записи нет, клиент мог использовать другой адрес или не сохранить настройки. Если запись есть, но ответ Cline отображает ошибку, смотрите текст ошибки и конфигурацию режима клиента, а не меняйте сразу три поля.
Не отправляйте большую задачу по репозиторию для диагностики. Она создаст лишние вызовы и затруднит сравнение. Начните с одного ответа. Только когда он прошёл, подключайте инструменты, правила проекта и длинный контекст.
После текстового ответа проверьте инструменты на копии одного файла. Попросите прочитать его, предложить изменение и дождаться вашего подтверждения. Сравните diff с заданием. Успешный curl подтверждает API, но не права Cline на чтение файлов и запуск команд. Если чтение запрещено клиентом, смена API-ключа это не исправит.
Как разобрать отказ без повторного платного цикла
При 401 проверьте ключ: он мог быть отозван, скопирован с пробелом или принадлежать другому сервису. При 404 проверьте Base URL, в нём нужен /v1, но не путь метода. При model_not_found проверьте ID и доступность модели в каталоге: ошибка не всегда означает опечатку. При 402 проверьте код ошибки, баланс и ограничения ключа, затем условия на странице цен. При 429 дождитесь указанной паузы и прочитайте правила лимитов, не запускайте пачку одинаковых запросов.
Сохраните HTTP-статус и x-request-id, если клиент его показывает. Не прикладывайте в обращение к поддержке ключ, полный конфиг с секретом или снимок, где секрет виден. Меняйте одно поле за раз. Каждый успешный повтор остаётся отдельным запросом; отсутствие изменений в файлах не означает отсутствие расхода.
Когда выбрать другой клиент
Выбирайте другой клиент, когда он прямо документирует нужный протокол и режим работы. Раздел интеграций перечисляет клиенты, а документация Cline описывает его границы. Не считайте наличие слова «CLI» или «Desktop» гарантией одинаковой конфигурации. Версия, режим и поддерживаемый протокол важнее названия программы.
Какой Base URL нужен Cline Desktop для OpenAI Compatible?
Введите https://relay-llm.ru/v1 без пути /chat/completions.
Можно ли вписать название модели вместо ID?
Нет. Используйте точный идентификатор из каталога, например gpt-6-sol.
Почему сначала нужен curl?
Он проверяет ключ, адрес и модель независимо от интерфейса Cline. После успешного короткого запроса легче найти ошибку в настройках клиента.
Где смотреть фактический расход?
В журнале запросов кабинета. Ориентиры цены и параметры модели есть на странице цен и в каталоге.