Что такое курсор?
Cursor — это редактор кода, ориентированный на искусственный интеллект, со встроенным чатом, рабочими процессами агентов, редактированием кода и функциями разработки на основе моделей.
Текущая документация Cursor не устанавливает общий маршрут для индивидуального поставщика. В этом руководстве TokenHub рассматривается как условный: настраивайте его только в том случае, если установленный клиент явно предоставляет пользовательское переопределение базового URL-адреса, а затем тестируйте каждую функцию независимо. Cursor не документирует универсальный путь стороннего поставщика для каждой версии, учетной записи и функции. Считайте маршрут TokenHub условным для видимых элементов управления API-ключом и базовым URL-адресом и тестируйте стандартные функции Chat, Agent, Apply и Tab Completion независимо, поскольку функции, специфичные для курсора, могут продолжать использовать отдельные службы.
Cursor может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Use https://us-api.tokenhub.com/v1 as the OpenAI Base URL override. Depending on the Cursor version and selected model, Cursor may use Chat Completions or Responses-style requests, so do not assume a single endpoint path.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Cursor для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
# open the tool, then open its model or provider settingsПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
Cursor officially supports BYOK for specific providers and standard chat models. A custom OpenAI-compatible endpoint is currently a limited Base URL override, not a first-class custom provider.
| Поле | Значение |
|---|---|
| Settings | Cursor Settings → Models → API Keys |
| API key field | OpenAI API Key |
| Base URL option | Override OpenAI Base URL |
| Base URL | https://us-api.tokenhub.com/v1 |
| Модель | A TokenHub model compatible with the request format Cursor sends |
Расположение настроек
| Поле | Значение |
|---|---|
| macOS | ~/Library/Application Support/Cursor/User/settings.json |
| Windows | %APPDATA%\Cursor\User\settings.json |
| Linux | ~/.config/Cursor/User/settings.json |
Если schema принадлежит extension, сначала используйте UI настроек. Он сохранит те же значения на уровне пользователя и не требует угадывать внутренние ключи, которые могут меняться.
Custom keys apply only to standard chat models. Tab Completion and Cursor-owned models continue through Cursor. Some current Cursor versions can also send a Responses-shaped body to a Chat Completions path through the override, so verify a read-only chat before relying on Agent mode. If the Base URL override is absent or the request format is rejected, that Cursor version cannot connect to TokenHub reliably.
Do not map Chat, Agent, Composer, Apply, Fast, or Tab as if they were equivalent custom-provider slots. Start with one standard chat model and treat every other feature as unsupported until its requests appear successfully in TokenHub logs.
Временные переменные только для диагностики
Если schema принадлежит extension, сначала используйте UI настроек. Он сохранит те же значения на уровне пользователя и не требует угадывать внутренние ключи, которые могут меняться.
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы о совместимости пользовательского API курсора
Почему в курсоре нет настройки «Переопределить базовый URL-адрес OpenAI»?
Настройка зависит от версии Cursor и учетной записи. Без видимых элементов управления переопределением эта страница не устанавливает прямой маршрут настройки TokenHub.
Почему функция Tab Completion по-прежнему может использовать Cursor после настройки TokenHub?
Пользовательский ключ API или переопределение базового URL-адреса не обязательно применяются к дополнению табуляции и другим возможностям, специфичным для курсора.
Означает ли успешный чат, что Cursor Agent тоже совместим?
Нет. Функции курсора могут использовать разные форматы запросов и пути к модели. Тестируйте чат, изменения и агента отдельно и просматривайте журналы запросов TokenHub.
Как устранить неполадку курсора 404 специальной модели?
Убедитесь, что базовый URL-адрес заканчивается на /v1, а идентификатор модели принимается текущим пользовательским интерфейсом. Если TokenHub не получает запроса, эта функция курсора не может использовать переопределение.
Какие функции Cursor следует протестировать отдельно?
Независимо протестируйте стандартные функции «Чат», «Агент», «Применить» и «Заполнение табуляции». Пользовательская настройка поставщика может влиять только на некоторые пути запросов.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。
