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

Ниже — как настроить собственный API в Cursor, какие бывают подводные камни и как выбрать между подпиской и собственным ключом.

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

1. Два способа использования Cursor

1. Собственные квоты Cursor

Работает сразу после установки, оплата по тарифу Cursor. Подходит индивидуальным пользователям, которые не хотят настраивать инфраструктуру и имеют небольшой объём работы.

2. Собственный API-ключ

В Cursor указываются ключ и Base URL стороннего OpenAI-совместимого интерфейса, а расходы идут через ваш API-аккаунт. Подходит, если:

  • доступ к официальному интерфейсу из Китая нестабилен;
  • команда хочет единый счёт и лимиты;
  • нужно указывать конкретные модели или переключаться между несколькими;
  • расходы Cursor нужно включить в корпоративный учёт.

Обратите внимание: даже с собственным ключом часть функций Cursor может требовать действующего тарифа. Ориентируйтесь на текущую версию Cursor и правила тарифов.

2. Подготовка API-ключа

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

Используйте Base URL:

https://ai.zhongshangqihang.com/v1

Это OpenAI-совместимый адрес. Функция собственного API в Cursor обычно работает по протоколу OpenAI, поэтому не указывайте корневой адрес Anthropic.

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

Путь в меню немного отличается между версиями, обычно это:

Cursor Settings → Models → OpenAI API Key

Порядок действий:

  1. Откройте настройки Cursor (обычно Cmd/Ctrl + ,).
  2. Найдите раздел Models или OpenAI API Key.
  3. Включите «Override OpenAI Base URL» или аналогичный переключатель.
  4. В поле Base URL укажите https://ai.zhongshangqihang.com/v1.
  5. В поле API Key укажите sk-....
  6. Добавьте в список моделей нужные имена, например gpt-5 или claude-sonnet-4-5.
  7. Сохраните и создайте новый диалог, выбрав собственную модель для проверки.

Если Cursor сообщает «API Key invalid»:

  • проверьте, что ключ скопирован полностью;
  • проверьте, что Base URL заканчивается на /v1;
  • проверьте достаточность баланса;
  • проверьте, доступно ли имя модели текущему аккаунту.

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

Задачи в Cursor обычно делятся на три типа:

Задача Рекомендуемая модель Причина
Повседневное дополнение, мелкие исправления Лёгкая и быстрая модель Низкая задержка и стоимость
Рефакторинг нескольких файлов, сложный агент Claude Sonnet или основная модель GPT Стабильнее понимание кода и вызов инструментов
Трудные рассуждения, проектирование архитектуры Opus или старшая модель Больше возможностей, выше стоимость

Имена моделей должны соответствовать странице цены на модели. Выпадающий список Cursor может показывать только известные ему названия; если собственной модели нет в списке, добавьте её вручную или выберите совместимый псевдоним.

5. Что выгоднее: подписка или собственный ключ

Единого ответа нет — всё зависит от объёма. Оценить можно так:

  1. Посчитайте, сколько запросов в день вы отправляете и какой у них контекст.
  2. Посмотрите цену и квоты тарифа Cursor.
  3. Оцените стоимость токенов для того же объёма по странице цен API.
  4. Учтите стабильность, скорость доступа и удобство управления счетами.

Практические наблюдения:

  • При небольшом объёме и одной модели тариф может быть проще.
  • При большом объёме, частой смене моделей и работе команды собственный ключ со шлюзом обычно управляемее.
  • Если нужен стабильный доступ из Китая, ценность шлюза часто выше разницы в цене.

Конкретные цены смотрите на странице цены на модели и на странице тарифов Cursor.

6. Частые проблемы и диагностика

Симптом Возможная причина Что делать
401 Неверный или просроченный ключ, ошибка в Base URL Скопируйте ключ заново; проверьте /v1
404 Дублирование пути в Base URL Укажите адрес только до /v1, без /chat/completions
Модель недоступна Неверное имя или нет доступа Скопируйте имя со страницы цен
Тайм-аут запроса Сеть или прокси Проверьте сеть, переключите прямое соединение или прокси
Недостаточно средств Не пополнен счёт или исчерпан лимит ключа Пополните баланс; проверьте лимит ключа
Ответ обрезан Ограничение контекста или вывода Сократите контекст или увеличьте лимит вывода

7. Рекомендации по безопасности

  • Создайте для Cursor отдельный ключ, не используйте его совместно с производственными сервисами.
  • Задайте лимит расходов, чтобы фоновые запросы IDE не потребляли слишком много.
  • Не сохраняйте ключ надолго на общем компьютере.
  • При уходе сотрудника или смене машины удаляйте старый ключ.
  • В команде используйте единый шлюз и отдельные ключи по участникам для удобного аудита.

8. Каким командам подходит

  • Аутсорсинговым командам: отдельный ключ на проект и расчёт стоимости по проектам.
  • Стартапам: единый вход, модели меняются в любой момент, нет привязки к одному поставщику.
  • Корпоративной разработке: централизованное управление участниками, лимитами, журналами и счетами.
  • Индивидуальным разработчикам: стабильнее доступ из Китая и удобнее оплата.

Что дальше

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

Похожие материалы: