Zed

Сторонние OpenAI-совместимые сервисы настраиваются в Zed в разделе language_models.openai_compatible.<provider>. В этом руководстве используется идентификатор провайдера getrouter.

Статус интеграции
  • Протокол: OpenAI-совместимый (по умолчанию Chat Completions)
  • Конфигурация проверена: 15 июля 2026 года
  • Практическая проверка: Ожидает проверки

1. Сохраните ключ API

Откройте настройки Agent в Zed командой agent: open settings, добавьте или выберите OpenAI-совместимый провайдер getrouter и сохраните YOUR_API_KEY в интерфейсе учётных данных Zed. Учётные данные, добавленные через интерфейс, хранятся в системном хранилище ключей, а не в settings.json.

Также можно перед запуском Zed задать переменную окружения, сформированную из идентификатора провайдера:

export GETROUTER_API_KEY="YOUR_API_KEY"

2. Настройте провайдер и модель

Откройте файл settings.json Zed и добавьте в него следующий шаблон:

{
  "language_models": {
    "openai_compatible": {
      "getrouter": {
        "api_url": "https://getrouter.ai/v1",
        "available_models": [
          {
            "name": "MODEL_ID",
            "display_name": "GetRouter Model",
            "max_tokens": MODEL_MAX_TOKENS
          }
        ]
      }
    }
  }
}

MODEL_MAX_TOKENS — это маркер шаблона, а не готовое значение JSON. Перед сохранением замените его целым числом, соответствующим реальному размеру контекстного окна выбранной модели. Не копируйте и не угадывайте ограничение другой модели.

Эта структура соответствует официальной конфигурации OpenAI-совместимых эндпоинтов Zed.

3. Проверьте настройку

Откройте Agent Panel, выберите GetRouter Model и отправьте короткий текстовый запрос. После успешной проверки обычного чата тестируйте редактирование и инструменты только в том случае, если выбранная модель поддерживает эти функции. Это руководство ещё не проходило практическую проверку.

Устранение неполадок

  • Модель не отображается: проверьте иерархию openai_compatible.getrouter.available_models и перед сохранением замените MODEL_MAX_TOKENS целым числом.
  • Учётные данные не найдены: идентификатор провайдера getrouter соответствует GETROUTER_API_KEY; сохраните ключ в интерфейсе провайдера Zed или перезапустите Zed после экспорта переменной.
  • Ответ 401: убедитесь, что локальный процесс Zed имеет доступ к нужным учётным данным.
  • Ошибка Agent или инструментов: проверьте возможности выбранной модели и укажите реальный размер её контекстного окна.