# Cursor

Чат и агент Cursor можно перевести на собственный OpenAI-совместимый сервис. Введите ключ и base URL, затем добавьте названия моделей вручную.

> https://nezhagate.com/ru/docs/integrations/cursor

Проверено на версии Cursor 3.22

## Перед началом

- Платный план Cursor (Pro и выше): на бесплатном плане чат и агент не работают с собственным ключом.

- На командном плане администратор должен разрешить использование личных API-ключей.

- Cursor отправляет запросы со своих серверов, поэтому публичный адрес NezhaGate подходит без изменений.

## Настройка

1. Откройте **Cursor Settings** (`Ctrl/Cmd + Shift + J`) → **Models**, прокрутите до конца и раскройте **API Keys**.

2. Вставьте свой ключ NezhaGate в поле **OpenAI API Key** и включите **Use OpenAI API Key** (это два разных шага, нужны оба).

3. Включите **Override OpenAI Base URL** и введите `https://nezhagate.com/v1`.

4. Введите точное название модели в поле поиска моделей (например, одно из списка ниже) и нажмите **Add Custom Model**.

5. Перезапустите Cursor, откройте новый чат и выберите добавленную модель.

Base URL`https://nezhagate.com/v1`

## Какие модели добавлять

Чат-модели NezhaGate в продаже, которые можно добавить в Cursor:

`deepseek-v4.1-flash` · `deepseek-v4-flash-0731` · `glm-5.3` · `glm-5.3-flash` · `kimi-k3` · `qwen3.7-max` · `qwen3.8-max` · `qwen3.8-max-0902` · `qwen3.8-flash` · `gpt-5.6-sol` · `gpt-5.6-terra` · `gpt-5.6-luna` · `gpt-6-astra` · `gpt-6.1-sol` · `gpt-6-sol` · `gpt-6-luna` · `doubao-seed-2-1-pro` · `doubao-seed-2-1-turbo` · `grok-4.7`

- Любую модель с именем на `claude-` Cursor отправляет через свой Anthropic-ключ, а в этом слоте переопределить base URL нельзя, поэтому модели Claude от NezhaGate в Cursor не работают. Имена на `gemini-` тоже не гарантированно используют пользовательский адрес, поэтому их в списке выше нет. Для Claude используйте [Claude Code](https://nezhagate.com/ru/docs/integrations/claude-code).

- Название, совпадающее с одной из собственных моделей Cursor (например, `gpt-5.5`), добавить не получится — выберите другую модель.

- Чтобы отправлять изображения, выберите модель, которая принимает их на вход (см. документацию API нужной модели).

## Ограничения, которые нужно знать

- Автодополнение Tab никогда не использует ваш ключ — через NezhaGate идут только чат и агент.

- Этот параметр действует на все модели семейства OpenAI: пока он включён, некоторые собственные модели Cursor сообщают, что не поддерживают пользовательские ключи. Чтобы снова их использовать, выключите **Use OpenAI API Key**.

- У Cursor нет кнопки проверки пользовательских ключей, а поле с ключом не показывает его после сохранения — лучший способ проверить — отправить сообщение.

## Проверка

Откройте новый чат, выберите добавленную модель и отправьте сообщение Reply with exactly: ok. После ответа запрос появится в журнале запросов вашей консоли.

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

**Model name is not valid / AI Model Not Found**

**Use OpenAI API Key** выключен (ключ не был отправлен), либо название модели начинается на `claude-`.

**This model does not support custom API keys**

Выбрана собственная модель Cursor. Выберите добавленную вами модель либо выключите **Use OpenAI API Key**, чтобы использовать модели Cursor.

**Invalid API key / Unauthorized User API key**

Ключ неверный: вставьте его заново полностью (поле не показывает старое значение — просто впишите новое поверх него).

**Зависает на статусе Planning next moves, а потом выходит ошибка лимита запросов или недоступности сервиса**

Чаще всего дело в бесплатном плане, который не поддерживает пользовательские ключи, либо в неверном base URL. Проверьте план и что адрес равен `https://nezhagate.com/v1`.