Windsurf (бывший Codeium) — редактор на базе VS Code со встроенным агентом Cascade. Многие ищут, как подключить к нему собственный OpenAI-совместимый API, чтобы платить за модели в рублях. Коротко: напрямую в Cascade это сейчас не делается, но рабочий путь внутри Windsurf есть.
Что умеет Windsurf «из коробки»
Cascade работает на моделях, которые Windsurf показывает в своём селекторе. Режим BYOK (свой ключ) принимает только ключи определённых вендоров на стороне аккаунта Windsurf; поля для произвольного base URL вроде https://getheli.ru/v1 и произвольного слага модели в публичной документации нет. Поэтому инструкции «впишите base URL в настройки Cascade» не работают — честнее сказать об этом сразу. Если в будущих версиях появится OpenAI-compatible провайдер, настройки будут такими же, как ниже.
Рабочий вариант: агент-расширение внутри Windsurf
Windsurf поддерживает расширения VS Code из каталога Open VSX. Агенты Cline и Roo Code умеют подключаться к любому OpenAI-совместимому API, поэтому Heli работает через них прямо в Windsurf, а Cascade остаётся на своих моделях.
- Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID) и создайте ключ на вкладке «Ключи».
- В Windsurf откройте Extensions и установите Cline или Roo Code.
- В настройках расширения выберите API Provider OpenAI Compatible.
- Base URL —
https://getheli.ru/v1, API Key —sk-heli-…, Model ID — слаг из каталога Heli. - Отправьте короткую задачу и убедитесь, что агент отвечает.
API Provider: OpenAI Compatible
Base URL: https://getheli.ru/v1
API Key: sk-heli-ВАШ_КЛЮЧ
Model ID: anthropic/claude-sonnet-5
# Проверка ключа и слага из терминала
curl https://getheli.ru/v1/chat/completions \
-H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model": "anthropic/claude-sonnet-5", "messages": [{"role": "user", "content": "ping"}]}'Какие модели выбрать
Для агентной работы с кодом — Claude Sonnet 5 или GPT-5.3 Codex. Для недорогих итераций — DeepSeek V4 Flash. Модель должна поддерживать tool calling, иначе агент не сможет читать файлы и запускать команды.
Частые ошибки
- 401 — ключ неверный или отозван; создайте новый в кабинете.
- 402 — недостаточно средств, пополните баланс.
- Model not found — слаг указан без вендора или с опечаткой; возьмите точное значение из
GET /v1/models. - Таймауты — агент шлёт большой контекст; разбейте задачу на части или выберите более быструю модель.
Подробности по расширениям — в гайдах Cline и Roo Code. Справка по API — в документации, пополнение — в разделе «Оплата». Если нужен редактор с нативной поддержкой своего endpoint, посмотрите Cursor.
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.