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

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

Последняя проверка: 2026-09-18 · 📄 По официальной документации (Cursor 3.21 (официальная страница загрузки, канал golden, проверено 2026-09); поля Override подтверждены ответом сотрудника Cursor на форуме от 2026-08-11)

Кратко¶

Где эти поля и известная ошибка¶

Адрес вводится в Settings → Models → API Keys. Страница BYOK в официальной справке (cursor.com/help/models-and-usage/api-keys) описывает только четыре шага: открыть Cursor Settings → Models, выбрать провайдера (OpenAI, Anthropic, Google, Azure или AWS Bedrock), вставить API-ключ в текстовое поле, нажать Save — поля переопределения там не перечислены. Сами поля существуют; сотрудник Cursor deanrie назвал их в официальном форуме:

"The fix for the OpenAI API Key and Override OpenAI Base URL fields, and other provider key fields, that didn't focus on mouse click has been merged and will ship in an upcoming 3.15 update. It's not in 3.15.6 yet. Once you update to a version newer than 3.15.6, please try again." (2026-08-11, исходная ветка)

Три практических вывода:

• Поля называются Override OpenAI Base URL (ветка OpenAI) и Override Anthropic Base URL (ветка Anthropic), у каждого свой тумблер включения.
• В 3.15.6 есть известная регрессия: эти поля не фокусируются мышью. Официальный обходной путь: в Settings → Models сначала включить нужный тумблер, затем нажать Tab, чтобы перевести фокус в поле — после этого ввод и вставка Ctrl+V работают. Помогает и временный откат на 3.14.27. Исправление выйдет в обновлении после 3.15.6, в 3.15.6 его ещё нет, поэтому сначала обновитесь на версию новее 3.15.6.
• На той же странице дословно: «Your API key is not stored on our servers. It is sent to our backend with every request because all requests are routed through Cursor's servers for final prompt building» — то есть даже со своим ключом запросы проходят через бэкенд Cursor, редактор не соединяется с вашим поставщиком моделей напрямую.

Ещё три ограничения и один риск по срокам:

• На тарифах Teams / Enterprise Cursor Token Rate взимается даже при своём ключе, а описание BYOK для OpenAI ограничено формулировкой "Standard, non-reasoning chat models".
• Если нужно полностью вывести трафик из-под бэкенда Cursor, берите клиент с поддержкой своего Base URL: Claude Code, Codex CLI, Cline, Zed и подобные.
• Риск по срокам: в заявлении от 2026-08-28 OpenAI написала, что «intend to wind down our contract providing OpenAI models to Cursor, with a proposed shutoff date of November 12, 2026» — планируют, ещё не вступило в силу. Со стороны Cursor на 2026-09-18 ответа нет. Источник: openai.com.

Cursor — это AI-native редактор на базе VS Code. Журнал изменений Cursor не структурирован по номерам версий, поэтому здесь нет рассказов в духе «в версии X добавили функцию Y»; подтвердить удалось одно: на странице загрузки канал golden отдавал 3.21. Дальше мы описываем, как подключить QCode.cc, но сначала прочитайте следующий раздел — от него зависит, доступен ли вам этот путь.

Зачем использовать 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

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

В таблице ниже — часто используемые id моделей QCode (актуальный список и цены — на qcode.cc/models); именно их и вводят в Cursor. Где находятся поля и что за ошибка ввода в 3.15.6 — в разделе выше.

Цены Gemini и наличие множителя в тарифе смотрите на qcode.cc/models; не повторяйте устное «×2». Таблица выше — текущая рекомендация; идентификаторы 4.x (claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-7) по-прежнему в продаже.

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

Два пути ниже соответствуют двум полям Override; путь A (протокол OpenAI) совместим лучше всего. Если поля не берут фокус — используйте обход с Tab выше или обновитесь на версию новее 3.15.6.

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

Используется протокол OpenAI с подключением к пути /openai/v1 QCode. На этом протоколе доступны модели GPT и четыре китайских семейства (GLM / Kimi / DeepSeek / Qwen).

🔴 Здесь недоступны ни Claude, ни Gemini. Точка OpenAI у QCode принимает только эти две группы; идентификатор claude-… или gemini-… вернёт model_not_available_on_endpoint. Для Claude используйте путь B ниже. См. Точки доступа и форматы API.

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).

В настройках Cursor откройте Models → Anthropic API, укажите ключ QCode и включите Override Anthropic Base URL с адресом выше.

🔴 Два переопределения мешают друг другу. По сообщениям пользователей: если задан Override OpenAI Base URL, Cursor направляет туда и трафик Claude, из-за чего модели Claude падают с 422. Документация Cursor этого не описывает — это наблюдение сообщества, оно может меняться с версиями. Для Claude задавайте только переопределение Anthropic, а поле OpenAI оставьте пустым. Если нужны оба, используйте разные профили Cursor или переключайтесь по ситуации.

⚠️ В режиме Agent часть возможностей использует стиль OpenAI Responses API, что в некоторых сценариях несовместимо с путём протокола Anthropic (обычно — ошибки преобразования схемы в вызовах инструментов). Переключатели эндпоинтов в Cursor меняются, поэтому ориентируйтесь на официальную документацию Cursor.

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

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

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

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

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

1. Выберите модель в Composer (например, claude-sonnet-5 на каждый день, claude-opus-5 для крупных правок)
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 5 / Sonnet 5 и 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 и фоновые агенты лучше всего работают с основными провайдерами (протоколы OpenAI / Anthropic); с собственными OSS-моделями результат непредсказуем
• Переопределение — глобальный переключатель: заполненный Override OpenAI Base URL переводит запросы, которые по умолчанию идут по протоколу OpenAI, на QCode; очистка возвращает к настройке Cursor по умолчанию. Но, по официальной формулировке, запросы всё равно проходят через бэкенд Cursor для сборки prompt'а, так что представление «переехал только трафик, остальное не изменилось» неверно

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

• Выбирайте модель под задачу: на пути B (Anthropic, https://api.qcode.cc/api) claude-sonnet-5 — лучший выбор для повседневного редактирования, claude-opus-5 — для крупных рефакторингов; на пути A (OpenAI) попробуйте gpt-5.6-terra для автодополнения и gpt-5.5 для общих задач
• Для длинного контекста предпочитайте тариф 1M: модели с контекстом 1M, такие как claude-opus-5 / 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¶

Composer по умолчанию использует протокол OpenAI, а точка OpenAI у QCode не принимает модели Claude — добавление claude-opus-5 в список Models не поможет: запрос отклоняется с model_not_available_on_endpoint.

Используйте путь B: в Models → Anthropic API укажите ключ QCode, включите Override Anthropic Base URL со значением https://api.qcode.cc/api и очистите Override OpenAI Base URL (иначе Cursor отправит трафик Claude в точку OpenAI и получит 422).

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 и в любом инструменте с поддержкой пользовательских эндпоинтов.