🚀 Интеграция Cursor с пользовательскими моделями CodingPlanX

Введение: Cursor — это редактор кода на базе ИИ, горячо любимый разработчиками, обладающий мощными встроенными возможностями Больших языковых моделей (LLM). Однако из-за сетевых ограничений, контроля затрат (использование сторонних прокси-API или более дешевых моделей, таких как DeepSeek) или потребностей развертывания в корпоративной интрасети нам часто требуется настроить пользовательский URL-адрес API и API-ключ.

Это руководство шаг за шагом покажет вам, как легко выполнить эту настройку.

---

📋 Предварительные требования

Перед началом убедитесь, что у вас готова следующая информация:

1. Установленный Cursor: Убедитесь, что ваш Cursor обновлен до последней версии.
2. API-ключ: например, sk-xxxxxxxxxxxxxxxxxxxxxxxx.
3. Base URL: Ваш пользовательский адрес прокси-API.
   • Примечание: обычно он должен заканчиваться на /v1, например, https://api.codingplanx.ai/v1.
4. Имя модели: Стандартное имя модели, которую вы собираетесь использовать (например, gpt-4o, claude-3-5-sonnet, deepseek-chat и т. д.).

---

⚙️ Подробные шаги конфигурации

Шаг 1: Открытие настроек Cursor

1. Запустите редактор Cursor.
2. Нажмите на значок шестеренки ⚙️ в правом верхнем углу или используйте сочетание клавиш для открытия настроек:
   • Windows / Linux: Ctrl + ,
   • macOS: Cmd + ,

Шаг 2: Переход на страницу настройки моделей

На левой панели навигации в окне настроек найдите и нажмите вкладку Models.

Шаг 3: Настройка API-ключа

1. Прокрутите страницу Models вниз, чтобы найти раздел OpenAI API Key.
2. Вставьте ваш пользовательский API-ключ в поле ввода.
3. Нажмите кнопку Verify (Проверить) справа. (Если проверка на этом этапе не удастся, не волнуйтесь, так как мы еще не настроили URL).
4. ⚠️ Важное примечание: Убедитесь, что переключатели официального Cursor Tab и других платных подписок выше находятся в соответствующем состоянии (если вы используете бесплатный сторонний API, рекомендуется отключить переключатели официальных моделей).

Шаг 4: Настройка Base URL (Переопределение конечной точки по умолчанию)

Это самый важный шаг, так как он определяет, куда будут отправляться ваши запросы:

1. Ниже поля ввода OpenAI API Key найдите опцию Override OpenAI Base URL.
2. Разверните эту опцию и введите ваш пользовательский адрес интерфейса в поле.

   💡 Пример формата:

   • CodingplanX AI: https://api.codingplanx.ai/v1

3. После заполнения вы должны нажать клавишу Enter, чтобы сохранить настройки.

Шаг 5: Добавление пользовательских имен моделей (Необязательно, но рекомендуется)

Если используемая вами модель отсутствует в списке Cursor по умолчанию (например, deepseek-coder), вам нужно добавить ее вручную:

1. Прокрутите в начало страницы Models и найдите раздел Model Names.
2. Нажмите + Add Model.
3. Точно введите имя вашей модели (например, deepseek-chat), затем нажмите Enter для подтверждения.
4. Включите переключатель рядом с только что добавленной моделью и рекомендуется отключить другие модели, которые вы не используете, чтобы избежать ошибочного выбора.

---

✅ Тестирование и проверка

После настройки нам нужно проверить, работает ли она:

1. Вернитесь в интерфейс редактирования кода.
2. Нажмите Ctrl + L (Windows) или Cmd + L (macOS), чтобы открыть окно чата (Chat) справа.
3. Внизу окна чата нажмите на отображаемое в данный момент имя модели и переключитесь на модель, которую вы только что настроили (например, gpt-4o или deepseek-chat).
4. Отправьте простое приветствие, например: "Кто ты? Пожалуйста, назови версию своей модели."
5. Если ИИ отвечает нормально и быстро, поздравляем, настройка прошла успешно! 🎉

---

❓ Часто задаваемые вопросы и устранение неполадок

---

📝 Заключение: Овладение настройкой пользовательских API не только значительно снижает стоимость использования программирования с ИИ, но и позволяет свободно переключаться между различными передовыми LLM. Если это руководство оказалось для вас полезным, не стесняйтесь поделиться им с друзьями-разработчиками!