ДокументацияCursor IDE
Cursor IDE
Подключите Cursor к Zenvy через OpenAI-compatible настройки и используйте Claude, GPT, Gemini, DeepSeek и другие модели прямо в редакторе кода.
Отдельный SDK не нужен: Cursor отправляет запросы на Zenvy endpoint /v1/chat/completions.
Cursor пропускает часть запросов через свои серверы и применяет специфичную обработку (особенно в Agent Mode и Composer). Из-за этого некоторые модели могут не пройти верификацию ключа или вернуть ошибки tool calling.
Начните с claude-sonnet-4.6 или deepseek-chat — они обычно работают стабильнее. Остальные модели подключайте, понимая, что после обновления Cursor поддержка может измениться.
Быстрый старт
Шаг 1. Откройте настройки моделей
В Cursor перейдите в View → Settings → Models.
Шаг 2. Настройте API-ключ
- Прокрутите до раздела API Keys
- Включите OpenAI API Key
- Вставьте API-ключ Zenvy:
sk-zenvy-... - Включите Override OpenAI Base URL
- Установите адрес:
https://api.zenvy.su/v1
В базовом адресе обязательно оставьте /v1 в конце.
Шаг 3. Добавьте модели
Прокрутите к полю Add or search model и добавьте нужные модели по их Zenvy ID:
claude-sonnet-4.6— рекомендуем для кодингаclaude-opus-4.7— сложные задачиgpt-5.5— модели OpenAIgemini-2.5-flash— быстрые ответыdeepseek-chat— экономичный вариант
Добавьте модель и включите её переключателем.
Шаг 4. Используйте
Откройте чат Cursor (Cmd+L / Ctrl+L) и выберите добавленную модель из выпадающего списка.
Сначала добавьте claude-sonnet-4.6 и убедитесь, что верификация ключа прошла. Если эта модель работает — соединение настроено правильно.
Рекомендуемые модели
Актуальные цены и возможности — на странице моделей или в Модели и баланс.
| ID модели | Назначение |
|---|---|
claude-sonnet-4.6 | Основной выбор для кодинга |
claude-opus-4.7 | Сложные архитектурные задачи |
gpt-5.5 | Модели OpenAI |
gemini-2.5-flash | Быстрые ответы, Cmd+K |
deepseek-chat | Экономичная альтернатива |
Устранение неполадок
| Симптом | В чём проблема |
|---|---|
| Ошибка верификации ключа | Ключ не начинается с sk-zenvy-, неверный Base URL или нулевой баланс. URL: https://api.zenvy.su/v1. |
| Модели не появляются | Cursor не перезапущен после добавления или указан неверный Zenvy ID. Сверьте с каталогом моделей. |
| «Ограниченная поддержка агента» | Предупреждение Cursor для кастомных endpoint. Для claude-sonnet-4.6 и deepseek-chat обычно можно игнорировать. |
Проверка через API
curl https://api.zenvy.su/v1/balance \
-H "Authorization: Bearer sk-zenvy-..."Если баланс возвращается — ключ рабочий.