К содержимому
Блог

Cline Desktop и CLI: свой API и проверка подключения

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, если её параметры в карточке соответствуют вашей задаче.

GPT-6 Sol0,38 $ за 1 млн входных токенов

Перед запуском интерфейса Cline сделайте независимую проверку. Она отделяет проблему ключа или сети от проблемы клиента. Команда ниже читает секрет из окружения. Отключите трассировку оболочки и не прикладывайте подробные HTTP-логи с заголовками:

bash
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. После успешного короткого запроса легче найти ошибку в настройках клиента.

Где смотреть фактический расход?

В журнале запросов кабинета. Ориентиры цены и параметры модели есть на странице цен и в каталоге.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.