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

Cline в VS Code: настройка собственного base URL

Cline в VS Code: настройка собственного base URL

Cline настраивают по актуальной документации установленной версии расширения. Сбой обычно лежит в одном из трёх мест: выбран не тот протокол, адрес указан с лишним или отсутствующим /v1, либо модель не подходит задаче. Начните с короткой проверки адреса и ключа, а уже потом разрешайте работу с файлами.

Коротко

  • OpenAI Compatible использует адрес Relay с /v1, Anthropic использует корень без /v1.

  • Идентификатор модели копируют из каталога, не из списка другого клиента.

  • Ошибка 401 указывает на ключ или его статус, 404 часто означает неверный путь или модель.

Какой провайдер выбрать в Cline

Откройте документацию установленной версии Cline и найдите поля для OpenAI-совместимого подключения. Укажите базовый адрес https://relay-llm.ru/v1, ключ и точный public_id модели из каталога.

Anthropic-совместимый вариант использует корень https://relay-llm.ru без /v1. Не смешивайте этот адрес с настройкой OpenAI Compatible: лишний сегмент меняет конечный маршрут запроса.

На странице интеграции Cline собраны требования Relay. Перед обновлением расширения или изменением конфигурации сначала сделайте пробный запрос.

Как проверить подключение до первой правки

Создайте отдельный ключ для редактора. Дайте ему понятное имя, установите срок и лимит, если это нужно для вашей среды. Секрет показывается один раз, поэтому не вставляйте его в файл настроек репозитория или в чат с коллегами. О правилах хранения подробнее написано в разделе ключей.

В Cline отправьте короткий безопасный запрос, например просьбу ответить одним словом о пустом файле. Затем откройте журнал запросов. Запись с ожидаемым ключом и моделью ещё не подтверждает рабочее подключение: проверьте успешный HTTP-статус и ожидаемый ответ модели. После этого можно дать агенту ограниченную задачу на чтение.

Почему Cline получает 401

Сначала проверьте ключ, а не модель. Ошибка 401 возникает у отключённого, отозванного или просроченного ключа, а также при неправильном секрете. Не отправляйте полный ключ для проверки. Сверьте имя ключа, его статус и срок в кабинете, затем замените значение в настройках расширения.

Учитывайте способ запуска редактора. Если секрет задан через окружение, убедитесь, что его получает запущенный процесс, не печатая значение в терминал. При сомнении используйте способ хранения секрета из актуальной документации Cline и правил команды.

Почему приходит 404 или агент не начинает работу

404 после смены провайдера чаще всего означает неверную форму base URL. У OpenAI Compatible проверьте /v1; у Anthropic уберите его. Затем скопируйте модель из каталога символ в символ. Модель, которая не доступна выбранному протоколу, тоже не сможет обработать запрос.

Перед сложной задачей сверяйте требования режима с карточкой модели. Начните с настройки из документации, затем меняйте один параметр за раз. Подтверждения действий, которые меняют файлы или запускают команды, не отключайте до отдельного согласования в команде.

Порядок диагностики

  1. Откройте настройки Cline и запишите выбранный протокол.

  2. Сверьте форму base URL с протоколом.

  3. Проверьте статус ключа и модель в каталоге.

  4. Выполните один короткий запрос без доступа к секретным файлам.

  5. Найдите его по времени в журнале и сохраните request_id, если есть ошибка.

Этот порядок быстрее случайной смены полей. Он ещё даёт воспроизводимое описание для коллеги или поддержки без передачи секрета.

Как ограничить действия агента в редакторе

Рабочее подключение не обязано сразу получать доступ ко всему репозиторию. Начните с режима чтения и одной безопасной задачи. В настройках Cline подтверждайте действия, которые меняют файлы или выполняют команды, пока команда не согласовала перечень исключений. Такой режим позволяет проверить модель и протокол, не превращая первую настройку в массовый дифф.

Ключ тоже должен соответствовать этой границе. Отдельный ключ для редактора с лимитом проще отозвать и проще найти в журнале. Если Cline запускают на компьютерах нескольких разработчиков, не копируйте секрет между ними через сообщения. Для каждого окружения нужна собственная процедура выдачи.

Что записать после настройки

Сохраните короткую памятку без секретов: выбранный провайдер, форму base URL, путь к документации, способ проверки и модель для первого запроса. При обновлении Cline повторите пробу до работы с основным проектом. Интерфейс и поля расширения меняются, а старая инструкция может привести к неверному маршруту.

Если проверка прошла, не отменяйте все подтверждения действий сразу. Сначала посмотрите несколько реальных задач в журнале и на ревью. Настройка доступа и доверие к автономным изменениям решаются отдельно.

Можно ли вставить ключ в настройки проекта VS Code?

Не стоит. Файлы проекта обычно попадают в Git, резервные копии и ревью. Используйте способ хранения секрета, который поддерживает расширение и правила вашей команды. Для отдельной интеграции лучше выпустить отдельный ключ с ограниченным сроком и лимитом.

Почему выбранная модель не появилась в интерфейсе Cline?

Проверьте точный идентификатор в каталоге и выбранный протокол. Если поле модели изменилось или исчезло в текущей версии, сверяйтесь с документацией Cline и не подставляйте похожее имя наугад.

Что передать при обращении в поддержку?

Передайте время, название интеграции, выбранный протокол, статус ответа и request_id. Укажите также версию Cline и способ запуска VS Code. Не отправляйте API-ключ, полный экспорт настроек или содержимое файлов, с которыми работал агент.

Создать ключ для Cline

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