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

Zed и Continue: настройка собственного base URL

Zed и Continue: настройка собственного base URL

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

Коротко

  • Для OpenAI-совместимого подключения Relay адрес содержит /v1.

  • Секрет не добавляют в рабочий репозиторий.

  • Сначала подтвердите короткий успешный запрос, затем настраивайте специальные режимы редактора.

Что настроить в Zed

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

Для OpenAI-совместимого варианта используйте https://relay-llm.ru/v1. Для Anthropic-совместимого адрес идёт без /v1. Оба протокола описаны на странице Zed. Модель берите из каталога, а возможности специальных режимов сверяйте с документацией установленного клиента.

Короткая проверка проста: выберите модель, отправьте нейтральный запрос и сохраните HTTP-статус с x-request-id. Затем найдите запрос по времени и идентификатору в журнале. Если записи нет, сначала сверьте ответ клиента и фильтры журнала: неверный ключ и служебный запрос тоже могут не появиться в списке.

Что настроить в Continue

Сначала откройте официальную документацию установленной версии Continue и найдите её актуальные поля подключения. Для OpenAI-совместимого протокола адрес Relay указывается с /v1. Секрет держат вне репозитория в согласованном хранилище, а в файл проекта его не добавляют.

Сначала подтвердите базовый текстовый запрос. Режимы, которые требуют особой возможности модели, включайте только после сверки требований текущей версии клиента и карточки модели. Хороший ответ в чате сам по себе не доказывает совместимость с другой задачей редактора.

Не копируйте флаги из старых конфигураций. Если клиент предлагает несколько API-режимов, выберите тот, который одновременно подтверждён его текущей документацией и документацией Relay.

Где хранить ключ

Создайте самостоятельный ключ для редактора. Укажите назначение, срок, лимит и список моделей, если они нужны. Это разделяет расходы и даёт возможность отозвать один доступ без остановки других сервисов. Все ключи используют общий баланс, поэтому лимит не заменяет контроль расходов.

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

Как найти ошибку адреса

401 обычно означает проблему с ключом: неверное значение, отзыв, отключение или срок действия. Откройте параметры ключа, а не вставляйте секрет в форму проверки.

404 сначала проверяют по протоколу. OpenAI Compatible ожидает /v1, Anthropic использует корневой адрес. Затем сверяют модель с каталогом и доступность этого протокола для модели. Не добавляйте и не убирайте /v1 одновременно с заменой модели, иначе результат проверки ничего не объяснит.

Как выбрать порядок настройки

Настраивайте один редактор за раз. Откройте его актуальную документацию, выберите протокол, укажите адрес и секрет безопасным способом, затем задайте модель и сделайте короткую пробу. После каждой пробы проверьте HTTP-статус, x-request-id и журнал по времени.

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

Когда менять модель

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

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

Можно ли использовать один ключ в Zed и Continue?

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

Почему чат работает, а автодополнение нет?

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

Нужно ли хранить ключ в файле настроек?

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

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

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