К содержимому

Zed API: подключение и настройка моделей

Zed подключает чужие шлюзы блоком language_models.openai_compatible в settings.json. Адрес OpenAI-совместимого провайдера указывается с /v1, адрес блока anthropic_compatible без него. Ключ в файл не кладут: его вводят в панели или задают переменной окружения.

  • Тип: Редактор и IDE
  • Протокол: OpenAI Chat Completions, Anthropic Messages
  • Статус: Работает
Настройки сверены с официальной документацией клиента, 2026-10-14. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовДа
АвтодополнениеНетПредсказание правок настраивается отдельно, провайдеры из language_models на него не действуют.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте settings.json командой zed: open settings file из палитры команд. Путь к файлу показан в блоке ниже.
  2. Добавьте блок провайдера из примера. Имя провайдера (здесь Gateway) определяет имя переменной окружения для ключа. В api_url стоит https://relay-llm.ru/v1, в available_models записана модель gpt-5.6-luna. В max_tokens впишите окно контекста модели из каталога: число в примере условное.
  3. Передайте ключ: введите его в настройках агента (команда agent: open settings, раздел LLM Providers) или задайте переменную GATEWAY_API_KEY. Ключ, введённый в Zed, хранится в связке ключей системы.
  4. Выберите добавленную модель в панели агента.

Провайдер OpenAI-совместимого типа

~/.config/zed/settings.json

%APPDATA%\Zed\settings.json

json
{
  "language_models": {
    "openai_compatible": {
      "Gateway": {
        "api_url": "https://relay-llm.ru/v1",
        "available_models": [
          {
            "name": "gpt-5.6-luna",
            "display_name": "gpt-5.6-luna",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

Провайдер Anthropic-совместимого типа

~/.config/zed/settings.json

%APPDATA%\Zed\settings.json

json
{
  "language_models": {
    "anthropic_compatible": {
      "Gateway": {
        "api_url": "https://relay-llm.ru",
        "available_models": [
          {
            "name": "claude-haiku-5-5",
            "display_name": "claude-haiku-5-5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Откройте панель агента, выберите модель и отправьте «ping». Ответ пришёл, запрос появится в журнале запросов кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Anthropic Messages

Работают модели, которые принимают этот протокол. Модели GPT по пути /v1/messages недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /v1.

Ловушки

  • Ключ в settings.json класть нельзя: документация Zed это запрещает. Ключ идёт через панель или через переменную окружения ИМЯ_ПРОВАЙДЕРА_API_KEY: имя провайдера записывается заглавными буквами, пробелы и дефисы заменяются подчёркиванием.
  • Непустая переменная окружения приоритетнее ключа из связки. Приложение, запущенное из Dock, переменные оболочки не видит, поэтому проще ввести ключ в панели. Чтобы Zed перестал брать ключ из переменной, удалите её и перезапустите Zed.
  • Модель нужно описать в available_models: name с идентификатором из каталога и max_tokens с окном контекста. Без записи модель в списке не появится.
  • Блоки двух протоколов не взаимозаменяемы. В openai_compatible адрес с /v1 и любая модель каталога, в anthropic_compatible адрес без /v1 и только модели Claude: GPT и другие модели по протоколу Anthropic не отвечают.
  • Подключение действует для агента Zed, Inline Assistant, генерации сообщений коммитов и сводок тредов. Внешние агенты, Terminal Threads и предсказание правок настраиваются отдельно.

Типичные ошибки

Что вы видитеПочему такЧто сделать
Модель не появляется в списке панели агента.В available_models нет записи или в settings.json ошибка синтаксиса: пропущена запятая или скобка.Проверьте файл, убедитесь, что у модели есть name и max_tokens, и сохраните его.
Ответ 401, в тексте Invalid API key.Ключ не дошёл до Zed или неверен: переменная GATEWAY_API_KEY не видна приложению, запущенному из Dock, либо имя провайдера в settings.json другое.Введите ключ в настройках агента, раздел LLM Providers. Если ключ задан переменной, перезапустите Zed после её установки.
Ответ 404, в тексте Unknown path (код not_found).В api_url блока openai_compatible нет /v1. Либо в блоке anthropic_compatible он лишний: путь /v1/messages Zed дописывает сам.Для openai_compatible укажите https://relay-llm.ru/v1, для anthropic_compatible укажите https://relay-llm.ru.
Ответ 404, модель не найдена (код model_not_found).В name стоит не идентификатор из каталога. Отображаемое имя display_name на запрос не влияет.Скопируйте идентификатор из каталога моделей в поле name.
Ответ 503 (код model_unavailable).Модель без протокола Anthropic Messages вписана в блок anthropic_compatible.Перенесите модель в блок openai_compatible с адресом https://relay-llm.ru/v1. Повторять запрос бесполезно.

Вопросы и ответы

Можно ли добавить провайдера без правки файла?

Можно. Выполните команду agent: open settings, в разделе LLM Providers нажмите Add Provider и заполните имя провайдера, API URL, идентификатор модели и окно контекста. Значения те же, что в блоке настроек.

Где лежит settings.json в Windows?

В %APPDATA%\Zed\settings.json. Проще открыть файл командой zed: open settings file.

Как подключить модели Claude?

Блоком anthropic_compatible с адресом https://relay-llm.ru без /v1 и моделью claude-haiku-5-5. Claude работает и через openai_compatible: у его моделей доступен протокол OpenAI Chat.

Работает ли предсказание правок (Edit Prediction)?

Нет. Предсказание правок настраивается отдельно, в разделе edit_predictions, а провайдеры из language_models на него не действуют.

Где смотреть расход?

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

Официальная документация: Zed API: подключение и настройка моделей

Скачайте Zed с сайта производителя

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key