Настройка Cursor AI: модели, свой ключ, правила и индексация

Настройка Cursor AI занимает минут пятнадцать, если знать порядок: сначала подключение модели, затем исключения из контекста, затем правила проекта, и только потом всё остальное. Ниже пошаговая инструкция, в которой отдельно отмечено, что нужно сделать в первый день, а что можно отложить. Интерфейс Cursor обновляется часто, поэтому названия пунктов могут чуть отличаться: ориентируйтесь на смысл и сверяйтесь с документацией Cursor↗.

Шаг 1. Проверьте ключ до того, как вводить его в Cursor

Самая частая причина «не работает» — ошибка в ключе или адресе, а не в редакторе. Проверьте ключ Zukko из терминала, пока вы не открыли настройки:

curl https://api.zukko.pro/v1/models \
  -H "Authorization: Bearer fetch_ваш_ключ"

Ответ со списком моделей означает, что ключ и адрес верны. Затем отправьте один короткий запрос:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Ответь одним словом: готово"}]}'

Ключ создаётся в кабинете на странице API-ключей и показывается целиком только один раз. Ответ 401 означает неверный или неполный ключ, 402 — нулевой баланс.

Шаг 2. Подключите свой ключ и base URL

Это ядро настройки Cursor AI, и по документации Zukko↗ оно выглядит так:

1. Откройте Cursor Settings → Models.
2. Включите собственный OpenAI-ключ и вставьте fetch_....
3. Включите подмену Base URL (Override OpenAI Base URL) и впишите https://api.zukko.pro/v1. Суффикс /v1 здесь обязателен: Cursor обращается к шлюзу как OpenAI-совместимый клиент, а адрес OpenAI-формата у Zukko именно такой.
4. Добавьте имя модели, например cursor-sonnet-5 (это второе имя claude-sonnet-5: Cursor не даёт завести модель с именем, которое уже знает, поэтому для популярных моделей Claude в документации Zukko есть вторые имена), и нажмите Verify.

Три оговорки, о которых лучше узнать до начала:

• По документации Zukko, подмена провайдера требует платного плана Cursor. Тарифы Cursor меняются, и на части планов использование своих ключей может быть недоступно, поэтому проверьте это на cursor.com/pricing↗.
• Свой ключ работает только с чат-моделями. Автодополнение остаётся на встроенных моделях Cursor.
• По документации Cursor, все запросы проходят через его серверы (там собирается итоговый промпт), так что адрес шлюза должен быть доступен из интернета. Адрес вида localhost не сработает.

Если Cursor отвечает, что такая модель уже есть, он отправит запрос в собственный бэкенд, а не к вам. В этом случае возьмите альтернативное имя из таблицы в документации Zukko. Если после смены адреса модели не появились, смотрите статью Cursor не видит модели↗.

Шаг 3. Выберите модели

Добавьте две-три модели и переключайтесь между ними по задаче. Цены за 1M токенов на 18 октября 2026 (вход / выход):

Какая модель лучше справится именно с вашим кодом, определит только проверка на ваших задачах. Актуальный список и цены: GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете. Для Claude в OpenAI-формате кэш не даёт скидки: весь вход считается по цене входа.

Шаг 4. Исключите лишнее из контекста

Сделайте это в первый же день: так вы снижаете и расход токенов, и риск, что секреты попадут в запрос. Cursor читает проект и по умолчанию игнорирует файлы из .gitignore и свой список по умолчанию (в него входят .env*, node_modules/, бинарные файлы, архивы и подобное). Остальное исключается файлом .cursorignore в корне проекта, синтаксис как в .gitignore:

secrets/
**/*.pem
**/credentials.json
dist/
build/
data/dumps/

В настройках есть раздел Indexing с пунктом Ignore Files: там включается поиск .cursorignore в родительских каталогах и задаётся глобальный список для всех проектов. Положите туда **/.env, **/*.key, **/id_rsa. По документации, .cursorignore ограничивает доступ агента, автодополнения и @-упоминаний, но терминал и MCP-инструменты агента этим файлом не блокируются, а полной защиты от утечки он не гарантирует.

О самой индексации: по актуальной документации Cursor, поиск точных совпадений (Instant Grep) строит и использует индекс на вашей машине, а код для построения поискового индекса не загружается. Но содержимое файла, который агент открыл, всё равно может попасть в запрос к модели, то есть уйти провайдеру вашего ключа.

Шаг 5. Напишите короткое правило проекта

Правила — самая окупаемая настройка. Они лежат в .cursor/rules как файлы .mdc с метаданными, а проще всего создать правило командой /create-rule в чате агента. Простой markdown-вариант — файл AGENTS.md в корне. Пример правила, которое применяется всегда:

---
alwaysApply: true
---
- Перед правкой читай файл целиком, не угадывай содержимое.
- Тесты запускай командой `npm test`, линтер — `npm run lint`.
- Не трогай каталоги `dist/` и `generated/`.
- Отвечай по-русски, код и комментарии в коде на английском.

Принципы: правило короче 500 строк, конкретное, со ссылками на файлы-образцы вместо копирования кода. Всё, что лежит в правилах с alwaysApply, отправляется с каждым запросом, поэтому раздутые правила стоят токенов. Подробнее — в статье как писать правила Cursor↗.

Шаг 6. Задайте лимит на стороне ключа

Заведите отдельный ключ под Cursor, поставьте дневной и месячный лимит в долларах и, при желании, список разрешённых моделей. Всё это задаётся в настройках ключа в кабинете. Так зациклившийся агент упрётся в потолок, а не в нулевой баланс.

Баланс пополняется от $1: СБП (платёжная страница добавляет 8,5% сверху, на баланс идёт выставленная сумма в долларах), криптовалютой или картой MasterCard (комиссия около 13%, суммы $2–$594).

Что настроить позже

• MCP-серверы. Подключайте по одному и только нужные: каждый добавляет в контекст описания своих инструментов.
• Приватность и политика данных. Откройте соответствующий раздел настроек и документацию Cursor. По документации Cursor, политика нулевого хранения данных Cursor на запросы со своим ключом не распространяется: действуют правила провайдера ключа.
• Режимы агента. Plan Mode (по Shift+Tab) стоит включать для задач на несколько файлов.

Частые вопросы

Verify выдаёт ошибку — что проверить?

Адрес с /v1, ключ целиком (начинается с fetch_), имя модели из GET /v1/models, положительный баланс. Если curl из шага 1 работает, а Verify нет, дело в имени модели или в самой настройке Cursor.

Нужно ли выбирать Anthropic-провайдер для Claude?

В Cursor работает вариант OpenAI с подменой Base URL: Claude вызывается в OpenAI-формате. Anthropic-формат с https://api.zukko.pro (без /v1) нужен Claude Code и официальному Anthropic SDK; общие правила — в выборе формата↗.

Как понять, сколько настройка стоит?

Смотрите «Использование» в кабинете: там видны расходы по ключам. Оценить заранее можно по формуле вход × цена входа / 1 000 000 + выход × цена выхода / 1 000 000.

Можно ли держать несколько моделей?

Да, добавьте их в список моделей и переключайтесь в интерфейсе Cursor. Разрешите ключу только те, что нужны.

Если вы ещё не создавали ключ, начните со страницы API-ключей↗.