Настройка пользовательского API редактора Zed

Добавьте TokenHub в качестве OpenAI-совместимого провайдера Zed Editor и протестируйте его с помощью безопасного запроса AI.

Что такое редактор Zed?

Zed Editor — это высокопроизводительный редактор кода для совместной работы со встроенными функциями искусственного интеллекта и настраиваемыми поставщиками языковых моделей.

Эта установка редактора Zed добавляет в настройки именованный OpenAI-совместимый поставщик, сохраняет его ключ API в файле settings.json и использует ограничения модели, соответствующие выбранной модели TokenHub. Zed отделяет декларации поставщика в файле settings.json от учетных данных, хранящихся в пользовательском интерфейсе или среде поставщика. Идентификатор поставщика определяет сгенерированную ключевую переменную, и каждая доступная модель должна использовать свой реальный предел контекста. Сначала протестируйте встроенный помощник, а затем проверяйте инструменты агента отдельно, поскольку базовая генерация не подтверждает совместимость инструментов.

Zed поддерживает как пользовательский интерфейс настроек агента, так и settings.json для конечных точек OpenAI-compatible. Пусть Zed сохранит ключ TokenHub API в системной цепочке ключей или предоставит его через переменную среды, полученную из имени провайдера. Не помещайте ключ в settings.json.

Добавьте провайдера в настройках агента

  1. Откройте палитру команд и запустите agent: open settings.
  2. Перейдите к Settings → AI → LLM Providers.
  3. Нажмите Add Provider и выберите поставщика OpenAI-compatible.
  4. Введите tokenhub в качестве имени поставщика.
  5. Введите https://us-api.tokenhub.com/v1 в качестве API URL.
  6. Введите точный идентификатор модели, указанный в каталоге моделей TokenHub.
  7. Войдите в окно реального контекста этой модели.
  8. Введите свой ключ TokenHub API в настройках провайдера, чтобы Zed сохранил его в системной цепочке ключей.

Отредактируйте файл settings.json, если вам нужно несколько моделей.

Zed поддерживает поставщиков под language_models.openai_compatible. В этой схеме max_tokens означает контекстное окно, а не максимальный вывод. Замените оба ограничения значениями, документированными для вашей модели:

{
  "language_models": {
    "openai_compatible": {
      "tokenhub": {
        "api_url": "__API_BASE_URL__/v1",
        "available_models": [
          {
            "name": "YOUR_TOKENHUB_MODEL_ID",
            "display_name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
            "max_tokens": 128000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": false
            }
          }
        ]
      }
    }
  }
}

Если capabilities опущен, Zed использует значения по умолчанию OpenAI-compatible, показанные выше. Установите images, parallel_tool_calls или другую возможность на true только в том случае, если и модель, и конечная точка TokenHub действительно поддерживают ее.

Следуйте правилу поиска ключей Zed API.

Zed преобразует идентификатор поставщика в прописные буквы и добавляет _API_KEY. Таким образом, идентификатор провайдера tokenhub соответствует:

export TOKENHUB_API_KEY="sk-..."

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

Не делайте вывод о поддержке рассуждений или ответов на основе названия модели.

  • Если модель TokenHub поддерживает reasoning_effort в стиле OpenAI, задавайте только значение, которое принимает конечная точка. Zed предоставляет none, minimal, low, medium, high, xhigh и max, но сторонняя конечная точка может поддерживать меньшее количество ценности.
  • TokenHub в настоящее время рекомендует использовать завершение чата для этого соединения, поэтому сохраните capabilities.chat_completions: true.
  • Измените его на false только для модели, требующей ответов API. Не переключайте API только для того, чтобы включить рассуждения.
  • Установите max_tokens_parameter: true только в том случае, если конечная точка требует max_tokens вместо max_completion_tokens.

Проверьте внутри Zed

Выберите TokenHub / YOUR_TOKENHUB_MODEL_ID в агенте или встроенном помощнике и попросите его объяснить текущий файл. Если модель отсутствует, проверьте JSON, идентификатор поставщика и available_models. Для ошибки 401 проверьте TOKENHUB_API_KEY, видимый для процесса Zed. Если инструменты или изображения не работают, вернитесь к capabilities и убедитесь, что декларация не превышает реальную поддержку модели.

Официальная ссылка

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы о провайдере искусственного интеллекта Zed Editor

Где должен находиться ключ API TokenHub в Zed?

Используйте настройки поставщика LLM или переменную среды TOKENHUB_API_KEY. Не сохраняйте ключ открытого текста в файле settings.json.

Почему модель отсутствует в селекторе?

Подтвердите идентификатор провайдера, URL-адрес API и записьavailable_models, а затем перезапустите Zed после изменения настроек или переменных среды.

Что должен содержать max_tokens?

Используйте фактическое контекстное окно для выбранной модели TokenHub, а не значение, скопированное из другой модели.

Доказывает ли успех Inline Assistant совместимость с Zed Agent?

Нет. Inline Assistant проверяет базовую генерацию; Рабочие процессы агента могут требовать структурированных вызовов инструментов и дополнительных разрешений. Проверьте эти возможности отдельно.

Как проверить, что Zed использует модель TokenHub?

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

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。