Zed API: подключение и настройка моделей
Zed подключает чужие шлюзы блоком language_models.openai_compatible в settings.json. Адрес OpenAI-совместимого провайдера указывается с /, адрес блока anthropic_compatible без него. Ключ в файл не кладут: его вводят в панели или задают переменной окружения.
- Тип: Редактор и IDE
- Протокол: OpenAI Chat Completions, Anthropic Messages
- Статус: Работает
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да | |
| Вызов инструментов | Да | |
| Автодополнение | Нет | Предсказание правок настраивается отдельно, провайдеры из language_models на него не действуют. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Откройте
settings.jsonкомандой zed: open settings file из палитры команд. Путь к файлу показан в блоке ниже. - Добавьте блок провайдера из примера. Имя провайдера (здесь
Gateway) определяет имя переменной окружения для ключа. Вapi_urlстоитhttps://, вrelay-llm.ru/ v1 available_modelsзаписана модельgpt-5.6-luna. Вmax_tokensвпишите окно контекста модели из каталога: число в примере условное. - Передайте ключ: введите его в настройках агента (команда agent: open settings, раздел LLM Providers) или задайте переменную
GATEWAY_API_KEY. Ключ, введённый в Zed, хранится в связке ключей системы. - Выберите добавленную модель в панели агента.
Провайдер OpenAI-совместимого типа
~/.config/zed/settings.json
%APPDATA%\Zed\settings.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
{
"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
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Откройте панель агента, выберите модель и отправьте «ping». Ответ пришёл, запрос появится в журнале запросов кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Anthropic Messages
Работают модели, которые принимают этот протокол. Модели GPT по пути / недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /.
Ловушки
- Ключ в
settings.jsonкласть нельзя: документация Zed это запрещает. Ключ идёт через панель или через переменную окруженияИМЯ_ПРОВАЙДЕРА_API_KEY: имя провайдера записывается заглавными буквами, пробелы и дефисы заменяются подчёркиванием. - Непустая переменная окружения приоритетнее ключа из связки. Приложение, запущенное из Dock, переменные оболочки не видит, поэтому проще ввести ключ в панели. Чтобы Zed перестал брать ключ из переменной, удалите её и перезапустите Zed.
- Модель нужно описать в
available_models:nameс идентификатором из каталога иmax_tokensс окном контекста. Без записи модель в списке не появится. - Блоки двух протоколов не взаимозаменяемы. В
openai_compatibleадрес с/и любая модель каталога, вv1 anthropic_compatibleадрес без/и только модели Claude: GPT и другие модели по протоколу Anthropic не отвечают.v1 - Подключение действует для агента 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 нет /. Либо в блоке anthropic_compatible он лишний: путь / Zed дописывает сам. | Для openai_compatible укажите https://, для anthropic_compatible укажите https://. |
Ответ 404, модель не найдена (код model_not_found). | В name стоит не идентификатор из каталога. Отображаемое имя display_name на запрос не влияет. | Скопируйте идентификатор из каталога моделей в поле name. |
Ответ 503 (код model_unavailable). | Модель без протокола Anthropic Messages вписана в блок anthropic_compatible. | Перенесите модель в блок openai_compatible с адресом https://. Повторять запрос бесполезно. |
Вопросы и ответы
Можно ли добавить провайдера без правки файла?
Можно. Выполните команду agent: open settings, в разделе LLM Providers нажмите Add Provider и заполните имя провайдера, API URL, идентификатор модели и окно контекста. Значения те же, что в блоке настроек.
Где лежит settings.json в Windows?
В %APPDATA%\Zed\settings.json. Проще открыть файл командой zed: open settings file.
Как подключить модели Claude?
Блоком anthropic_compatible с адресом https:// без / и моделью claude-haiku-5-5. Claude работает и через openai_compatible: у его моделей доступен протокол OpenAI Chat.
Работает ли предсказание правок (Edit Prediction)?
Нет. Предсказание правок настраивается отдельно, в разделе edit_predictions, а провайдеры из language_models на него не действуют.
Где смотреть расход?
В журнале запросов кабинета: там видны модель, токены и стоимость каждого запроса.
Ссылки
Официальная документация: Zed API: подключение и настройка моделей
Скачайте Zed с сайта производителя
Подключение клиентов: общие сведения и все клиенты