> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка кастомной модели Cursor через LLMEasy

> Подключите LLMEasy к Cursor с ID моделей группы GPT.

При подключении LLMEasy к Cursor используйте OpenAI-compatible endpoint. Внешние инструменты используют группу **GPT**, поэтому копируйте актуальный ID модели из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.

<Warning>
  Cursor позволяет настраивать custom models только пользователям платного advanced tier или выше. Если в вашем аккаунте или версии клиента нет опций custom model, API Key или Base URL, сначала проверьте план Cursor и версию клиента.
</Warning>

<Warning>
  **Известное ограничение:** **Override OpenAI Base URL** — глобальная настройка. Когда она включена, она влияет на все API keys, настроенные в Cursor, включая Anthropic / GPT keys для встроенных моделей Cursor. Официальное сообщество Cursor подтверждало это поведение: Base URL влияет на все API keys и модели ([обсуждение](https://forum.cursor.com/t/cursor-models-fail-when-using-byok-openai-key-with-overridden-base-url-glm-4-7/147218)).

  Если встроенные Claude / GPT модели Cursor перестали работать после включения **Override OpenAI Base URL**, выключайте **Override OpenAI Base URL**, когда не используете LLMEasy. Cursor пока не поддерживает отдельный Base URL для каждой модели; эта возможность отслеживается как feature request ([feature request](https://forum.cursor.com/t/custom-base-urls-for-each-custom-model/147219)).
</Warning>

## Требования

* Установленный Cursor ([скачать Cursor](https://www.cursor.com))
* API Key LLMEasy (<a href={"https://www.llmeasy.ru/register"}>зарегистрироваться</a>)
* В поле **Группа ключа** выбрано **GPT**, и вы будете выбирать модель из той же группы

## Настройка

<Steps>
  <Step title="Откройте страницу настроек моделей">
    В Cursor нажмите **Settings** в левом нижнем углу, затем перейдите в **Models** и прокрутите до **API Keys**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/ejT8e_A0sPBKAOtG/images/cursor/settings-api-key.png?fit=max&auto=format&n=ejT8e_A0sPBKAOtG&q=85&s=295505e5defbee1c10687edc39a4d616" alt="Страница настроек Cursor с полями Settings, Models, API Keys, OpenAI API Key и Override OpenAI Base URL." style={{ borderRadius: '0.5rem' }} width="2560" height="1600" data-path="images/cursor/settings-api-key.png" />
    </Frame>
  </Step>

  <Step title="Введите Base URL и API Key">
    В **API Keys** заполните поля в таком порядке:

    1. Включите **Override OpenAI Base URL**
    2. Введите `https://www.llmeasy.ru/v1` в поле Base URL
    3. Вставьте API Key LLMEasy в **OpenAI API Key**
    4. После заполнения URL и ключа включите toggle **OpenAI API Key**

    Введите ключ до включения toggle. Так Cursor покажет dialog подтверждения авторизации.
  </Step>

  <Step title="Включите OpenAI API Key">
    В dialog подтверждения нажмите **Enable OpenAI API Key**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cursor/enable-openai-api-key.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=e91657f5347421f34f13c8952cb5ee30" alt="Dialog Cursor с запросом включить собственный OpenAI API key." style={{ borderRadius: '0.5rem' }} width="802" height="248" data-path="images/cursor/enable-openai-api-key.png" />
    </Frame>
  </Step>

  <Step title="Обновите список моделей и включите модели">
    В **Models** нажмите кнопку refresh справа перед выбором модели. Дождитесь завершения обновления списка.

    Выбирайте только модели из той же группы LLMEasy, что и ваш API Key. Если в поле **Группа ключа** выбрано **GPT**, выберите ID модели из группы **GPT** в model plaza, затем включите toggle для этой модели.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cursor/models-refresh-select.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=b60c411c28cc0f3afc486368f327fa61" alt="Раздел Models в Cursor с кнопкой refresh и toggle моделей." style={{ borderRadius: '0.5rem' }} width="2560" height="1600" data-path="images/cursor/models-refresh-select.png" />
    </Frame>
  </Step>

  <Step title="Вернитесь в chat и выключите Auto">
    После настройки вернитесь в chat Cursor и откройте model picker под полем ввода. Если включен **Auto**, сначала выключите **Auto**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cursor/chat-disable-auto.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=57778e15214433605f2c877fe52a52db" alt="Model picker в чате Cursor с toggle Auto, который нужно выключить." style={{ borderRadius: '0.5rem' }} width="2560" height="1600" data-path="images/cursor/chat-disable-auto.png" />
    </Frame>
  </Step>

  <Step title="Выберите модель и начните чат">
    Выберите включенную модель группы GPT и начните общение.

    <Frame>
      <img src="https://mintcdn.com/bettertoken/3Irzp0wIG1eGzGGI/images/cursor/chat-select-model.png?fit=max&auto=format&n=3Irzp0wIG1eGzGGI&q=85&s=2ced2fcb24c78b3dff747967c651363f" alt="Поле ввода Cursor chat с выбранной включенной моделью." style={{ borderRadius: '0.5rem' }} width="2560" height="1600" data-path="images/cursor/chat-select-model.png" />
    </Frame>
  </Step>
</Steps>

## Связанные FAQ

* [Как настроить custom OpenAI API Key и Base URL в Cursor](/faq/cursor/custom-openai-api)
* [Cursor Rules, AGENTS.md и .cursorignore](/faq/cursor/rules-agents-cursorignore)
* [Как настроить MCP в Cursor](/faq/cursor/mcp)
* [Claude Code или Cursor для локальной разработки](/faq/claude-code/claude-code-vs-cursor)
* [OpenAI-compatible API и Anthropic-compatible API](/faq/concepts/openai-compatible-vs-anthropic-compatible)

## Примечания

* Не используйте ID моделей группы **Claude** в Codex / OpenAI-compatible flow
* Не используйте жестко заданные имена Claude-моделей; берите актуальный ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>