Подключение редактора Cursor

Подключите QCode.cc в Cursor IDE через пользовательские эндпоинты Anthropic / OpenAI; поддерживаются Agents Window и Design Mode из Cursor v3

Подключение редактора Cursor¶

Cursor — это AI-native редактор на базе VS Code. В Cursor v3 (выпуск 2026-04) появились три новые возможности: Agents Window (координация нескольких агентов), Design Mode (визуальный дизайн в связке с кодом) и CLI agents (суб-агенты в терминале). В этом руководстве описано, как настроить QCode.cc в качестве источника моделей для Cursor.

Зачем использовать Cursor¶

• Agents Window (новинка v3): запускайте несколько AI-агентов параллельно в боковой панели без взаимных помех
• Cursor Composer: многофайловое редактирование и контекстно-зависимый рефакторинг — лучше подходит для крупных правок, чем Cursor Chat
• Inline Edit (Cmd+K): выделите код и сразу дайте инструкцию — самый быстрый способ итерации
• На базе VS Code: совместимость со всей экосистемой расширений VS Code (включая расширение Claude Code для VS Code)

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

• Установлен Cursor (macOS / Windows / Linux)
• Имеется API Key QCode.cc (начинается с cr_), полученный в личном кабинете

Шаги настройки¶

В Cursor есть два пути подключения — выберите один в зависимости от сценария.

Путь A: Custom OpenAI-compatible endpoint (рекомендуется)¶

Используется протокол OpenAI с подключением к пути /openai/v1 QCode; доступны модели от нескольких поставщиков — GPT-5.5 / GPT-5.4 / Gemini и др.

1. Откройте настройки Cursor: Cmd + , (macOS) / Ctrl + , (Windows/Linux)
2. Models → прокрутите вниз до Override OpenAI Base URL
3. Заполните:

1. В списке Models отметьте модели, которые хотите включить (например, gpt-5.5, gpt-5.4-codex); те, которых нет в списке, можно добавить вручную через + Add model, указав model id
2. Нажмите Verify, чтобы проверить соединение; после успешной проверки можно использовать в Cursor Chat / Composer

Путь B: Custom Anthropic endpoint (подключение к Claude)¶

⚠️ Известное ограничение: интеграция Anthropic в Cursor в режиме Agent использует стиль OpenAI Responses API, что в некоторых сценариях несовместимо с путём протокола Anthropic в QCode (конкретно проявляется как ошибки преобразования схемы в отдельных вызовах инструментов). Рекомендуется выбирать путь A через протокол OpenAI; если нужны модели Claude — добавьте в путь A model id вроде claude-opus-4-7 (QCode выполняет проброс на уровне протокола OpenAI).

Резервные эндпоинты¶

Полный список эндпоинтов (включая резервные узлы в Северной Америке / Европе / Азии) см. в разделе Эндпоинты и форматы API.

Совместное использование с Claude Code¶

Встроенный AI в Cursor и отдельный Claude Code CLI не конфликтуют между собой — оба можно использовать в одном окне Cursor:

• Cursor Chat / Composer: AI внутри редактора, идёт через эндпоинт, заданный в настройках Cursor
• Claude Code CLI: запустите claude во встроенном терминале Cursor (Ctrl + `), он использует собственную переменную окружения ANTHROPIC_BASE_URL

Эти два пути аутентифицируются независимо, но при использовании одного API Key QCode они разделяют общую квоту (см. Биллинг).

Ограничения и замечания¶

• Privacy Mode: Cursor по умолчанию отправляет фрагменты кода на настроенный эндпоинт. Если в настройках Cursor включён Privacy Mode, проверьте, что после настройки API Key соединение с QCode сохраняется; Privacy Mode не влияет на исходящий трафик, а только запрещает Cursor хранить промпты у себя
• Подписка Cursor Pro и API Key QCode — это две независимые системы: Cursor Pro даёт встроенную в Cursor квоту (через собственный пул GPT-4 Cursor), API Key QCode идёт через наш промежуточный пул. При одновременном использовании маршрутизация определяется приоритетом, заданным в настройках Cursor
• Agents Window в Cursor v3 на текущий момент имеет наиболее стабильную совместимость с протоколами OpenAI / Anthropic; поддержка нестандартных провайдеров (например, самостоятельно поднятых OSS-моделей) неоднородна

Часто задаваемые вопросы¶

Cursor выдаёт «API key not valid»¶

1. Убедитесь, что API Key полный, начинается с cr_ и не содержит пробелов в начале или конце
2. Нажмите Verify в настройках Cursor, чтобы увидеть конкретную ошибку
3. Проверьте соединение через командную строку: bash curl -H "Authorization: Bearer YOUR_KEY" \ http://103.236.53.153/openai/v1/models Если возвращается JSON-список — эндпоинт и API Key в порядке

Composer не работает с моделями Claude¶

С Cursor v2 Composer по умолчанию использует протокол OpenAI; при выборе Claude нужно вручную добавить model id вроде claude-opus-4-7 в список Models (даже если QCode пробрасывает модели Claude через протокол OpenAI, Cursor должен распознать model id, чтобы показать его в выпадающем меню).

Inline Edit (Cmd+K) работает медленно¶

По умолчанию Cmd+K в Cursor использует собственную fast model Cursor; после переключения на QCode он идёт через настроенный base URL, и первая задержка будет немного выше встроенной (на один промежуточный hop больше). В настройках можно отметить, чтобы Cursor Tab использовал стандартную модель Cursor, а Chat / Composer — эндпоинт QCode.

Дальнейшие шаги¶

• Интеграция с VS Code — родственный редактор, общие принципы конфигурации
• Эндпоинты и форматы API — полная таблица трёх протоколов и четырёх доменов QCode.cc
• Полное руководство по Claude Code — справка по рабочему процессу CLI
• Биллинг — правила общей квоты