Cursor — Интеграция с Ручкой

Cursor — AI-native IDE на базе VS Code. Ручка подключается как кастомная OpenAI-совместимая модель: рублёвый биллинг, закрывающие документы, без VPN и иностранной карты.

Зачем Ручка для Cursor

• Без VPN — api.ruchka.dev → российский IP (h3llo.cloud, РФ DC, 152-ФЗ).
• Без иностранной карты — карта РФ, СБП или счёт для юрлица.
• Закрывающие документы — акт + счёт ежемесячно, ПЭП по 63-ФЗ.
• Промпты не пишутся в логи — архитектурно, не «обещаем».

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

• Cursor 0.40+ (последняя стабильная)
• API-ключ (sk-ruchka-...) — на раннем доступе выдаём в @ruchkadev_bot

Быстрый старт (30 секунд)

Cursor хранит конфигурацию моделей иначе, чем Cline — через UI настроек, не через файл ~/.cline/settings.json.

1. Открой Cursor → Settings (Cmd/Ctrl+Shift+J) → Models.
2. Прокрути до OpenAI API Key → включи Override OpenAI Base URL.
3. Укажи:
   • Base URL: https://api.ruchka.dev/v1
   • API Key: sk-ruchka-YOUR_KEY_HERE
4. В разделе Models нажми + Add model и добавь имя модели из каталога (например kimi-k2.6).
5. Сохрани → нажми Verify в Cursor (он сделает тестовый запрос).

Важно: Cursor использует свой Base URL override (не ~/.cline/settings.json как Cline). Если переключаешься с Cline — настройки не переносятся, конфигурируй заново через Settings → Models.

Проверка подключения

curl https://api.ruchka.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-ruchka-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k2.6", "messages": [{"role": "user", "content": "Привет"}]}'

Ответ 200 + choices[0].message.content = подключение работает.

Рекомендованные модели для Cursor

Модель	Лучше для	Контекст
claude-sonnet-4.6	Composer и multi-file рефакторинги	200K
gpt-5.1-codex	Cmd-K и код-задачи	400K
kimi-k2.6	Cmd-K большие рефакторинги, Composer multi-file	128K
deepseek-v4-flash	Inline-правки, быстрый Cmd-K	64K
deepseek-v4-pro	Глубокий анализ, архитектурные вопросы в Chat	64K
qwen-3.6-coder	Автодополнение, code-specific задачи	32K
glm-4.6	Daily-driver баланс качество/скорость	128K
gemma	Дешёвые короткие запросы	8K

Цены ₽/1M токенов — в каталоге на ruchka.dev: списывается ровно цена каталога. Состояние сервисов и история инцидентов → status.ruchka.dev.

Совет: добавь в Cursor две модели — kimi-k2.6 для Composer/Chat и deepseek-v4-flash для быстрых Cmd-K правок. Переключение в один клик в выпадающем списке модели.

Ограничения и лимиты

• Частота запросов не ограничена по умолчанию; авто-fallback на резервный upstream при throttle.
• Spend-cap — в настройках кабинета → «Лимит расходов».
• Нулевой баланс → ключ приостановлен; пополнение через /billing.

Устранение проблем

401 Unauthorized — проверь API Key в Settings → Models. Должен начинаться с sk-ruchka-.

429 Too Many Requests — upstream throttle, Ручка делает fallback автоматически. Повторяется — пиши в @ruchkadev_bot.

503 + stealth_launch — закрытый запуск, доступ выдаётся вручную. Связь: @ruchkadev_bot.

Cursor использует свою модель вместо Ручка — убедись, что в выпадающем списке выбрана добавленная модель (kimi-k2.6), а не встроенный cursor-small / gpt-4.

model not found — modelName должен точно совпадать с ID каталога (строчные, дефисы).

Base URL игнорируется — проверь, что включён тумблер Override OpenAI Base URL, а URL оканчивается на /v1 без финального слеша.

Нет VPN. Нет иностранной карты.

Ручка работает через h3llo.cloud (РФ дата-центр, 152-ФЗ). DNS ruchka.dev → российский IP. Платежи YooKassa + СБП. Закрывающие документы каждый месяц.

---

Нужна расширенная настройка или что-то не работает? Пиши в @ruchkadev_bot.