Zed + Heli: OpenAI-compatible провайдер в settings.json

Настройка через интерфейс

1. Зарегистрируйтесь на getheli.ru (почта с подтверждением или Google / Яндекс ID) и создайте ключ на вкладке «Ключи» кабинета.
2. В Zed выполните команду agent: open settings и в разделе LLM Providers нажмите Add Provider.
3. Заполните имя провайдера (например, heli), API URL https://getheli.ru/v1, ID модели и размер контекстного окна, затем вставьте ключ.
4. Выберите модель Heli в селекторе Agent Panel.

Ключ, введённый в интерфейсе, Zed хранит в системной связке ключей, а не в settings.json.

Настройка через settings.json

То же самое можно описать в файле настроек: секция language_models.openai_compatible, внутри — провайдер с api_url и списком available_models. Поле max_tokens — это размер контекстного окна модели.

// ~/.config/zed/settings.json
{
  "language_models": {
    "openai_compatible": {
      "heli": {
        "api_url": "https://getheli.ru/v1",
        "available_models": [
          {
            "name": "anthropic/claude-sonnet-5",
            "display_name": "Claude Sonnet 5 (Heli)",
            // окно контекста модели — сверьте с её карточкой
            "max_tokens": 128000
          },
          {
            "name": "deepseek/deepseek-v4-flash",
            "display_name": "DeepSeek V4 Flash (Heli)",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

Ключ задаётся в интерфейсе провайдера или переменной окружения перед запуском Zed:

export HELI_API_KEY="sk-heli-ВАШ_КЛЮЧ"
zed .

Имя переменной Zed строит из ID провайдера: heli → HELI_API_KEY. Ключ не кладите в settings.json. По умолчанию для таких моделей включены tools и выключены изображения; при необходимости это меняется в блоке capabilities.

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

Для агентного редактирования — Claude Sonnet 5 или GPT-5.5. Для коммит-сообщений, суммаризации тредов и быстрых правок хватит DeepSeek V4 Flash. Значение max_tokens не должно превышать окно модели.

Модели одного провайдера можно назначать разным функциям: тяжёлую — агенту, лёгкую — inline-ассистенту и генерации коммитов. В удалённых проектах (SSH, dev-контейнеры) Zed берёт ключ из локальной связки ключей или локального окружения, поэтому настраивать Heli на сервере не нужно.

Частые ошибки

• 401 — ключ неверный или в окружении осталась старая переменная. Переменная окружения важнее ключа из связки: удалите её и перезапустите Zed.
• 402 — закончился баланс; пополните его в кабинете.
• Модель не найдена — в name нужен точный слаг с префиксом вендора, как в GET /v1/models.
• Обрывы на длинных ответах — уменьшите контекст треда или ограничьте вывод полем max_output_tokens.

Справка по API — в документации, пополнение — в разделе «Оплата».