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

Подключите QCode.cc в Cursor IDE через пользовательский Base URL Anthropic / OpenAI + API Key: настройка моделей, ограничения пользовательских эндпоинтов и устранение неполадок

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

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

Зачем использовать 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_), полученный в личном кабинете
• Один и тот же API Key работает со всеми протоколами QCode и всеми четырьмя доменами доступа (api / asia / us / eu); пользователям из материкового Китая рекомендуется asia.qcode.cc

Доступные модели¶

QCode отдаёт модели трёх протоколов одним и тем же Key. Пользовательский эндпоинт Cursor наиболее стабилен по протоколу OpenAI; просто вводите model id из таблицы ниже:

Семейство Gemini тарифицируется в QCode по ×2. Полный прайс-лист — на qcode.cc/pricing.

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

В Cursor есть два пути подключения — выберите один в зависимости от сценария. Путь A (протокол OpenAI) обладает наилучшей совместимостью и настоятельно рекомендуется.

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

Используется протокол OpenAI с подключением к пути /openai/v1 QCode; доступны GPT-5.5 / GPT-5.4 / Gemini, проброшенные модели Claude и другие семейства.

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

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

Base URL не должен заканчиваться слешем. Запрос самопроверки QCode возвращает 401 — это значит, что путь верный и не хватает только авторизации; это нормально и подтверждает, что эндпоинт доступен.

Соответствие Base URL по протоколам (один и тот же Key работает для всех):

Путь B: Custom Anthropic endpoint (нативный протокол Claude)¶

Если вы хотите использовать нативный протокол Anthropic для моделей Claude, Anthropic Base URL у QCode — https://api.qcode.cc/api (SDK автоматически добавляет /v1/messages).

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

Какие функции работают через пользовательский эндпоинт¶

Cursor делит свои AI-возможности на несколько категорий, и пользовательский эндпоинт OpenAI покрывает их в разной степени. Таблица ниже — практическая оценка по текущим наблюдениям; Cursor часто обновляется, поэтому последнее слово — за официальной документацией Cursor:

Коротко: связка Chat / Composer / Inline Edit наиболее надёжна через эндпоинт QCode; сильно управляемые функции (автодополнение Tab, часть потоков агентов) могут оставаться на собственных моделях Cursor. Когда Cursor откроет пользовательские эндпоинты для конкретной функции агентов — ориентируйтесь на официальные анонсы.

Типичный рабочий процесс¶

После настройки эндпоинта повседневная работа с Composer выглядит примерно так:

1. Выберите модель в Composer (например, claude-sonnet-4-6 на каждый день, claude-opus-4-8 для крупных правок)
2. Откройте Composer через Cmd + I и перетащите нужные файлы в область контекста
3. Опишите цель на естественном языке, например: «перенеси управление состоянием этого компонента с useState на useReducer, сохранив существующие props»
4. Просмотрите diff и принимайте / отклоняйте по блокам (Accept / Reject)
5. Для быстрых локальных правок используйте Inline Edit (Cmd + K), не открывая каждый раз Composer

Весь этот процесс идёт через настроенный вами эндпоинт QCode, а квота списывается по правилам Биллинга.

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

Четыре домена — это разные точки входа в одну и ту же службу, и один и тот же API Key работает на всех. Полное описание см. в разделе Эндпоинты и форматы API.

Ввод изображений и генерация изображений¶

• Ввод изображений (чтобы модель «увидела» картинку): Cursor позволяет вставлять или перетаскивать скриншоты / макеты дизайна в диалог, чтобы их прочитала модель с поддержкой зрения — например, написать компонент по эскизу UI или отладить по скриншоту ошибки. Модели с поддержкой зрения в QCode: Claude Opus 4.8 / Sonnet 4.6 и GPT-5.x.
• Генерация изображений (чтобы модель «нарисовала»): это другое. Для генерации используйте модель QCode gpt-image-2 через специальный эндпоинт изображений — не в рамках работы редактора Cursor. См. Генерация изображений gpt-image-2.

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

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

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

Направьте Claude Code на QCode (протокол Anthropic) из встроенного терминала:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_Key"
claude

Эти два пути аутентифицируются независимо, но при использовании одного API Key QCode они разделяют общую квоту (см. Биллинг). Суб-агенты и Автоматизация и CI/CD Claude Code работают прямо в этом терминале.

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

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

Практические советы¶

• Выбирайте модель под задачу: claude-sonnet-4-6 даёт лучшее соотношение цена/качество для повседневного редактирования; для крупных рефакторингов / длинного контекста берите claude-opus-4-8; для чистого автодополнения кода попробуйте gpt-5.6-terra
• Для длинного контекста предпочитайте тариф 1M: модели с контекстом 1M, такие как claude-opus-4-8 / gpt-5.5, подходят для правок Composer, куда подаётся целый репозиторий
• Экономия: задайте моделью по умолчанию в Composer средний тариф и переключайтесь на флагман вручную только для трудных задач
• Используйте ближайший эндпоинт: в материковом Китае смена Base URL на https://asia.qcode.cc/openai/v1 обычно быстрее
• При странном поведении сначала нажмите Verify: после обновления Cursor поведение эндпоинта может меняться, поэтому сначала нажмите Verify, а потом ищите другие причины

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

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

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

Verify не проходит, а curl работает¶

Чаще всего это лишний слеш в конце Base URL или путь без /v1. Убедитесь, что введено https://api.qcode.cc/openai/v1 (протокол OpenAI) без завершающего /. Обратите внимание: запрос к базовому пути напрямую с ответом 401 — это нормально (путь верный, нет авторизации) и не означает ошибки в настройке.

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

С Cursor v2 Composer по умолчанию использует протокол OpenAI; при выборе Claude нужно вручную добавить model id вроде claude-opus-4-8 в список 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.

Agents Window / фоновые агенты выдают ошибку или не используют QCode¶

Часть суб-возможностей агентов имеет требования к источнику модели и может принудительно использовать встроенные модели Cursor, а не пользовательский эндпоинт. Это особенность стороны Cursor, которая меняется от версии к версии, поэтому ориентируйтесь на официальную документацию Cursor; можно переключить Chat / Composer на QCode, оставив потоки агентов на умолчании Cursor.

Добавленного model id нет в выпадающем меню¶

Убедитесь, что в списке Models вы и отметили эту модель, и корректно ввели её id через + Add model (с учётом регистра, без лишних пробелов). После изменения один раз перезапустите Cursor, чтобы обновить список.

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

• Интеграция с VS Code — родственный редактор, общие принципы конфигурации
• Эндпоинты и форматы API — полная таблица трёх протоколов и четырёх доменов QCode.cc
• Генерация изображений gpt-image-2 — специальный эндпоинт генерации изображений
• Суб-агенты — использование суб-агентов Claude Code
• Автоматизация и CI/CD — headless-процессы
• Полное руководство по Claude Code — справка по рабочему процессу CLI
• Биллинг — правила общей квоты

Ещё нет API Key? Выберите тариф на qcode.cc/pricing — один Key работает в Cursor, Claude Code и в любом инструменте с поддержкой пользовательских эндпоинтов.