Cursor — широко используемый AI-редактор кода. Помимо встроенных лимитов моделей, он позволяет указать собственный API-ключ и Base URL. Для команд из Китая подключение Cursor к единому шлюзу, совместимому с OpenAI, даёт фиксированный путь доступа, консолидированные счета и возможность переключаться между моделями.

Ниже — практический порядок действий: подготовка, настройка, проверка, ограничения и внедрение в команде. Названия пунктов меню могут отличаться в разных версиях; ориентируйтесь на Cursor Settings в вашей установке.

Примечание: Cursor — товарный знак Anysphere, Inc. Статья носит технический характер и не подразумевает аффилированность или агентские отношения с Cursor/Anysphere; интерфейс, тарифы и правила биллинга определяются официальными страницами Cursor.

1. Различайте два «Cursor API»

Первый — API, который открывает сама платформа Cursor, например Cloud Agents и административные интерфейсы. Ключ создаётся в аккаунте Cursor и используется для вызова сервисов Cursor. Второй — «свой ключ модели» (BYOK): в Cursor вводится ключ поставщика модели, и редактор вызывает модель от имени вашего аккаунта. В статье речь о втором варианте.

Есть важная предпосылка, которую легко упустить: запросы к моделям в Cursor передаются через серверы Cursor, а не идут напрямую с вашего компьютера. Поэтому Base URL должен быть доступен из публичной сети. Шлюз, доступный только из корпоративной сети, на стороне Cursor обычно приводит к тайм-ауту. ZSQH AI Gateway — публичный сервис, и это ограничение к нему, как правило, не относится.

2. Подготовьте ключ, Base URL и имя модели

Перед началом нужны три вещи: API-ключ, совместимый адрес и точный ID модели.

  1. Откройте страницу регистрации ZSQH AI Gateway, зарегистрируйтесь и войдите в консоль.
  2. Перейдите в раздел «API-ключи», создайте ключ и укажите назначение в названии, например cursor-work-pc.
  3. Задайте лимит расхода и срок действия. Для личного аккаунта тоже рекомендуется, чтобы избежать неожиданного расходования.
  4. Скопируйте ключ и сохраните в менеджере паролей. Консоль обычно показывает его полностью только один раз.
  5. Откройте цены на модели и запишите ID нужной модели. Цены и модели меняются, ориентируйтесь на текущее отображение на странице.

Три параметра конфигурации выглядят так:

Base URL: https://ai.zhongshangqihang.com/v1
API Key:  sk-... (создаётся в консоли, храните только в менеджере паролей)
Model:    ID модели, который сейчас указан на странице «Цены на модели»

Base URL — совместимый с OpenAI адрес, оканчивающийся на /v1. Не указывайте корневой адрес Anthropic и не добавляйте самостоятельно /chat/completions, иначе легко получить дублирование пути.

3. Настройка в Cursor

Обычный путь — Cursor Settings → Models → API Keys. В разных версиях набор пунктов меняется, но основные шаги близки.

  1. Откройте Cursor Settings; сочетание клавиш обычно Cmd/Ctrl + ,.
  2. Перейдите в Models и разверните раздел API Keys.
  3. Включите OpenAI API Key, вставьте созданный ключ и нажмите Save.
  4. Включите Override OpenAI Base URL и введите https://ai.zhongshangqihang.com/v1.
  5. Нажмите + Add Custom Model (в некоторых версиях — + Add model), укажите ID модели со страницы цен и включите её.
  6. Выберите эту модель в селекторе модели в чате и отправьте простой запрос.

Если пункт Override OpenAI Base URL не находится, текущая версия или тариф не поддерживают направление OpenAI-совместимого трафика на свой адрес. В этом случае не пытайтесь повторять раз за разом: обновите версию или используйте сборку, где такой переключатель доступен.

Имя модели — это идентификатор маршрутизации, а не заметка. Регистр, дефисы и суффикс версии должны совпадать со шлюзом. При ошибке обычно появляется «модель не существует», 404 или отказ в запросе.

4. Как выбрать модель

В Cursor можно добавить несколько пользовательских моделей, но успех запроса зависит от того, предоставляет ли шлюз модель с таким именем и поддерживает ли соответствующий способ вызова.

Сценарий Рекомендуемый класс Как заполнять Что учесть
Повседневные вопросы, небольшие правки Лёгкая быстрая модель Скопировать ID со страницы цен Низкая задержка, ограниченные возможности сложного рефакторинга
Правки в нескольких файлах, Agent Основная модель для кода Скопировать ID со страницы цен Нужна поддержка вызова инструментов
Проектирование архитектуры, сложная отладка Модель высокого класса Скопировать ID со страницы цен Дороже, использовать по необходимости
Автодополнение Tab Встроенная модель Cursor Не проходит через свой ключ BYOK не покрывает автодополнение

Режим Agent может зависеть от Responses API или вызова инструментов. Если шлюз совместим только с Chat Completions, часть функций Agent не будет работать. В такой ситуации сначала проверьте обычный чат, а затем определите, дело в модели или в несовместимости функции.

Кроме того, Auto, Composer и автодополнение Tab не обязательно используют ваш ключ. По документации Cursor автодополнение Tab всегда работает на встроенных моделях; режим Auto также может маршрутизироваться самим Cursor. Реалистичнее рассматривать пользовательские модели как канал, который включается только после явного выбора.

5. Проверка, что конфигурация работает

Недостаточно увидеть ответ в Cursor: он может прийти по встроенному каналу. Проверяйте по порядку.

  1. Создайте новый пустой диалог, чтобы не мешал контекст истории.
  2. Явно выберите пользовательскую модель в селекторе, не используйте Auto.
  3. Отправьте короткий запрос, например попросите объяснить фрагмент кода до десяти строк.
  4. Откройте журнал использования или запросов в консоли шлюза и убедитесь, что появилась запись с тем же временем, моделью и ключом.
  5. Зафиксируйте результат проверки. Если записи в журнале нет, запрос не дошёл до шлюза — вернитесь к проверке Base URL и переключателя.

Типичные ошибки можно сопоставить так:

  • 401 или 403: неверный ключ, ключ отключён или лимит исчерпан.
  • 404: неверный путь Base URL или имя модели не существует.
  • 429: сработало ограничение частоты или достигнут лимит ключа.
  • Тайм-аут: конечная точка недоступна или есть проблема с сетевым маршрутом.
  • Падает только Agent: вероятно, несовместимы возможности интерфейса, а не ключ.

6. Ограничения, которые нужно знать

  • BYOK в основном покрывает чат-модели; автодополнение Tab по-прежнему использует встроенные модели Cursor.
  • Поддержка OpenAI-ключа различается по версиям. Документация Cursor указывает, что собственный ключ OpenAI покрывает только стандартные чат-модели без рассуждений; модели с рассуждением и часть новых функций могут быть недоступны.
  • Запросы идут через серверы Cursor, поэтому пользовательская конечная точка должна быть доступна из публичной сети.
  • Запросы со своим ключом не обязательно попадают под политику нулевого хранения данных Cursor; обработка данных зависит от поставщика модели и шлюза. Командам с жёсткими требованиями к хранению данных следует сначала провести оценку.
  • В командных и корпоративных тарифах даже при собственном ключе может взиматься платформа Cursor по её правилам; точные условия — на странице тарифов Cursor.
  • Cursor обновляется быстро: названия меню, поддерживаемые модели и правила биллинга могут меняться.

7. Внедрение в команде

  • Начните с малого пилота: выберите трёх–пятерых разработчиков, задайте одну основную модель и поработайте неделю.
  • Записывайте три показателя: долю успешных запросов, среднюю задержку и расход на человека в день.
  • Создайте в шлюзе отдельный ключ для каждого сотрудника и задайте лимиты; не используйте общий ключ.
  • Ведите таблицу сопоставления моделей: что указано в Cursor, что соответствует на шлюзе, на что переключаться при сбое.
  • Занесите конфигурацию во внутреннюю документацию: Base URL, ID моделей и обработку типичных ошибок.
  • После наблюдения за затратами решите, кому использовать свой ключ, а кому — тарифные лимиты. Цены — на странице цены на модели.
  • При увольнении, смене компьютера или завершении проекта отключайте соответствующий ключ в тот же день.

8. Чек-лист безопасности

  • Один ключ — одно назначение; не переиспользуйте его между устройствами.
  • Задавайте лимит расхода и срок действия.
  • Не записывайте ключ в код, .env, скриншоты или тикеты.
  • Не храните ключ постоянно на общем компьютере.
  • Регулярно меняйте ключи; при подозрении на утечку сначала отключите, затем разбирайтесь.
  • В команде используйте единый шлюз и сохраняйте журналы запросов для аудита.
  • Для чувствительных репозиториев заранее выясните, покидают ли данные компьютер и в какие сервисы попадают.

9. Частые вопросы

Поддерживает ли Cursor любой OpenAI-совместимый интерфейс?

Не обязательно. Возможность зависит от того, есть ли в версии Cursor пункт Override OpenAI Base URL и совместим ли интерфейс с фактически используемыми путями и параметрами. Сначала проверьте обычный чат, затем функции Agent.

Почему при своём ключе всё равно требуется подписка?

Свой ключ не равен разблокировке всех функций. Часть возможностей редактора, управление командой и встроенные модели по-прежнему ограничены тарифом; ориентируйтесь на действующие правила Cursor.

Почему автодополнение Tab не расходует мой ключ?

По документации Cursor автодополнение Tab всегда использует встроенные модели Cursor и не идёт через свой ключ. Это особенность продукта, а не ошибка настройки.

В Base URL указывать корневой адрес или /v1?

При работе по OpenAI-совместимому протоколу указывайте адрес до /v1. Не добавляйте /chat/completions, иначе возможны дублирование пути и ошибка 404.

Можно ли команде использовать один общий ключ?

Технически можно, но не рекомендуется. По общему ключу нельзя разделить расход между сотрудниками, а при утечке сложно локализовать проблему. Отдельный ключ на человека вместе с лимитами и журналами надёжнее.

Следующий шаг

Сначала зарегистрируйтесь в ZSQH AI Gateway, создайте отдельный ключ для Cursor и заполните Base URL и модель по этой статье. После успешного обычного диалога посмотрите цены на модели и настройте основную модель и лимиты.

Что читать дальше: