Cursor: свой Base URL и ключ (2026)

Подключение QCode в Cursor через свой OpenAI- или Anthropic-Base URL и API-ключ: настройка, ID моделей и ограничения пользовательских эндпоинтов (2026).

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-10-20 · 📄 По официальной документации (на официальной странице загрузки Cursor по-прежнему 3.24 — проверено 2026-10-20; последняя запись changelog датирована 2026-10-16; страница BYOK проверена в тот же день; ответ на форуме от 2026-08-11 про поля Override сохранён как историческая справка)

Да. Cursor позволяет указать свой API-ключ и включить Override OpenAI Base URL (или Override Anthropic Base URL), направив Chat, Composer и Inline Edit на QCode. Автодополнение Tab по-прежнему работает на встроенных моделях Cursor, а запросы всё так же проходят через бэкенд Cursor для сборки prompt.

Кратко¶

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

Адрес вводится в 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 (перепроверено 2026-10-20: на странице загрузки уже 3.24, а этот ответ с форума от 2026-08-11 сохранён как история периода 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 не структурирован по номерам версий, последняя запись датирована 2026-10-16; на 2026-10-20 на странице загрузки последней версией значилась 3.24. Дальше мы описываем, как подключить 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); пользователям из материкового Китая рекомендуется asia.qcode.cc

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

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

QCode сейчас не предоставляет серию Gemini, а также gpt-6-luna / gpt-5.6-luna. Таблица выше — текущая рекомендация; claude-opus-5, claude-sonnet-5, claude-sonnet-4-6, claude-opus-4-8 и другие по-прежнему можно вызывать. Доступные модели и цены — на qcode.cc/models.

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

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

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

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

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

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

1. В списке Models отметьте модели, которые хотите включить (например, gpt-6.1-sol, 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; сильно управляемые функции (часть агентных сценариев) могут остаться на моделях Cursor. Строка про Tab теперь соответствует официальной формулировке (проверено 2026-10-20, см. таблицу выше); остальное — наблюдение, а не официальная документация, так что сверяйтесь с анонсами Cursor.

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

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

1. Выберите модель в Composer (например, claude-sonnet-5-5 на каждый день, claude-opus-5-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.5 / Sonnet 5.5 / Haiku 5.5 и модели GPT (например, gpt-6.1-sol и gpt-5.6-terra).
• Генерация изображений (чтобы модель «нарисовала»): это другое. Для генерации используйте модель 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 идёт через сервис QCode. При одновременном использовании маршрутизация определяется приоритетом, заданным в настройках Cursor
• Agents Window и фоновые агенты лучше всего работают с основными провайдерами (протоколы OpenAI / Anthropic); с собственными OSS-моделями результат непредсказуем
• Переопределение — глобальный переключатель: заполненный Override OpenAI Base URL переводит запросы, которые по умолчанию идут по протоколу OpenAI, на QCode; очистка возвращает к настройке Cursor по умолчанию. Но, по официальной формулировке, запросы всё равно проходят через бэкенд Cursor для сборки prompt'а, так что представление «переехал только трафик, остальное не изменилось» неверно
• Zero Data Retention не применяется к своему ключу (страница BYOK, проверено 2026-10-20): при использовании своего API-ключа политика Zero Data Retention от Cursor не действует; обработка данных определяется политикой конфиденциальности выбранного провайдера (OpenAI, Anthropic, Google, Azure или AWS)
• На Teams / Enterprise по-прежнему действует Cursor Token Rate (страница BYOK, проверено 2026-10-20): даже со своим ключом каждый запрос к сторонней модели на Teams / Enterprise тарифицируется по Cursor Token Rate — $0.25 за миллион токенов (входные, выходные и кешированные); на индивидуальных тарифах (Premium, Super, Ultra и прежние Pro) запросы со своим ключом не расходуют включённую квоту тарифа

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

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

Enterprise →