Cursor умеет обращаться к OpenAI-совместимому адресу, а Guard такой адрес отдаёт. Ключ вставляется в штатные настройки редактора, и встроенный агент начинает работать через Guard.
- Cursor → Settings → Models.
- Прокрутите список моделей вниз и разверните раздел API Keys.
- В поле OpenAI API Key вставьте свой
gd-…и включите переключатель справа. - Включите Override OpenAI Base URL и укажите адрес ниже.
https://api.guardrelay.ai/v1В поле Add or search model впишите нужный id и добавьте его. Затем убедитесь, что переключатель у добавленной модели включён.
| id для Cursor | Контекст | Когда брать |
|---|---|---|
claude-sonnet-5-5 | 1M | по умолчанию |
claude-sonnet-5 | 1M | явная версия Sonnet 5 |
claude-opus-5-5 | 1M | новейший Opus: сложный код и агентные задачи |
claude-opus-5 | 1M | сложный код и агентные задачи |
claude-opus-4-8 | 1M | предыдущий флагман |
claude-haiku-5-5 | 1M | новейший Haiku: быстро и дёшево |
claude-haiku-4-5 | 200K | предыдущая версия Haiku |
claude-fable-5 | 1M | отдельная модель |
claude-fable-5-1 | 1M | отдельная модель |
Свободные написания вроде sonnet-5, opus-5 или Claude-Sonnet-5 тоже принимаются: сервер приводит их к рабочему id.
| id для Cursor | Контекст | Когда брать |
|---|---|---|
k3 | 1M | по умолчанию: длинная история или крупный документ |
k3-256k | 256K | окно 262 144 токена; базовая ставка как у k3 |
kimi-for-coding | 1M | K2.8 Preview: код и работа инструментами |
kimi-for-coding-highspeed | 256K | отдельная K2.7 Code HighSpeed |
Id вписывается точно, без сокращений и без своего написания: короткие формы Cursor не подставит.
У Grok 4.7 восемь id: уровни low, medium, high, xhigh и вариант Fast входят в полную строку; окно Guard — 256K. Восемь id Grok 4.6 остаются доступны; Grok 4.5 удалён. У Composer два id. Копируйте полную строку со страницы Модели.
Полная таблица всех семейств лежит на странице Модели.
New Chat → выберите добавленную модель в списке у поля ввода → отправьте запрос. Перезапускать Cursor не нужно.
Встроенный агент работает в полную силу: ведёт длинный диалог, читает и ищет по файлам проекта, правит и создаёт код, выполняет команды в терминале и показывает результат, принимает картинки и вложения, отвечает строго заданным форматом. Ответ идёт потоком, его можно остановить и продолжить. Поддержка изображений, вложений и строгого формата зависит от выбранного семейства и API; например, Composer не принимает изображения.
Поиск в интернете и открытие страниц по ссылке Cursor выполняет сам, своими средствами и присылает результат модели — отдельной платы за это нет.
Cursor отправляет вместе с каждым сообщением большую служебную часть — описание инструментов и правила работы агента. При подтверждённом попадании в кэш этот повторяющийся вход считается по пониженной ставке чтения.
Первый достаточно большой запрос может записать кэш, а следующие совпадающие запросы — прочитать его дешевле. Попадание и экономия не гарантируются: проверяйте cached tokens, тариф и итоговую стоимость в истории запроса.
Подписка Cursor оплачивает сам редактор. Запросы через ваш gd-… списываются с баланса Guard и в лимиты Cursor не входят — их видно в личном кабинете.
| Что видно | Что делать |
|---|---|
The model you chose is not available | Такого id нет в каталоге Guard. Сверьтесь с таблицей выше или страницей Модели. |
| Ошибка «ресурс не найден» | Проверьте, что в адресе есть /v1 на конце и нет лишнего пути. |
| Ошибка авторизации | Ключ скопирован не целиком или переключатель у OpenAI API Key выключен. |
| Отвечает встроенная модель Cursor | В списке у поля ввода выберите именно ту модель, которую добавили. |
| Старый чат ведёт себя по-прежнему | Настройки применяются к новым чатам — откройте New Chat. |
- Установите Cursor, войдите в свой аккаунт и откройте через File → Open Folder отдельную тестовую папку без секретов.
- Получите ключ Guard. Возможность Use OpenAI API Key зависит от условий вашего плана Cursor; документация Guard не требует покупать новый план.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Откройте Cursor Settings → Models. Нажмите Add Custom Model, введите
glm-5.3в Custom model name и нажмите Add. При необходимости отдельно добавьтеglm-5.3-flash. - Раскройте API Keys, вставьте
gd-…в OpenAI API Key и включите Use OpenAI API Key. - Включите Override OpenAI Base URL и укажите
https://api.guardrelay.ai/glm/v1без/chat/completions. - Откройте New Chat и выберите
glm-5.3у поля ввода.
| Поле Cursor | Значение |
|---|---|
| Custom model name | glm-5.3 |
| OpenAI API Key | gd-… |
| Use OpenAI API Key | включено |
| Override OpenAI Base URL | включено |
| Base URL | https://api.guardrelay.ai/glm/v1 |
| Итоговый запрос | POST https://api.guardrelay.ai/glm/v1/chat/completions |
- В новом чате без файлов отправьте:
Ответь ровно GLM_OK и запомни слово СОСНА. - В том же чате отправьте:
Какое слово нужно было запомнить?ОжидаетсяСОСНА. - Если нужна проверка проекта, откройте тестовый
README.md, попросите прочитать одну строку и не разрешайте других действий.
| Model ID | Что использовать |
|---|---|
glm-5.3 | Основная модель; текст и задачи с кодом. |
glm-5.3-flash | Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions. |
- Cursor с GLM пока не проверен; работа Agent, инструментов и продолжения здесь не заявлена.
- Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
- Chat API допускает MP4 с
glm-5.3-flash, но загрузка PNG, PDF или MP4 через интерфейс Cursor не подтверждена. - Профиль использует OpenAI-compatible Chat Completions. Серверный промпт GLM для обычного API выключен по умолчанию; настройка клиента сама его не включает.
- Native TXT, DOCX и XLSX не входят в подтверждённый GLM-контракт. Для документов используйте PDF; для изображений — PNG и модель
glm-5.3-flash.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID равен ровно glm-5.3 или glm-5.3-flash; старые GLM ID, aliases, Turbo и FlashX не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/glm/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля. |
402 insufficient_balance | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Настройки API key недоступны | Это ограничение плана или аккаунта Cursor. Не покупайте новый план ради этой инструкции; используйте подтверждённый Cline или VS Code Claude Code. |
- Установите Cursor, войдите в свой аккаунт и откройте через File → Open Folder отдельную тестовую папку без секретов.
- Получите ключ Guard. Возможность Use OpenAI API Key зависит от условий вашего плана Cursor; документация Guard не требует покупать новый план.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Откройте Cursor Settings → Models. Нажмите Add Custom Model, введите
gemini-4-argonв Custom model name и нажмите Add. При необходимости отдельно добавьте остальные ID из таблицы ниже. - Раскройте API Keys, вставьте
gd-…в OpenAI API Key и включите Use OpenAI API Key. - Включите Override OpenAI Base URL и укажите
https://api.guardrelay.ai/v1без/chat/completions. - Откройте New Chat и выберите
gemini-4-argonу поля ввода.
| Поле Cursor | Значение |
|---|---|
| Custom model name | gemini-4-argon |
| OpenAI API Key | gd-… |
| Use OpenAI API Key | включено |
| Override OpenAI Base URL | включено |
| Base URL | https://api.guardrelay.ai/v1 |
| Итоговый запрос | POST https://api.guardrelay.ai/v1/chat/completions |
- В новом чате без файлов отправьте:
Ответь ровно GUARD_GEMINI_OK и запомни слово СОСНА. - В том же чате отправьте:
Какое слово нужно было запомнить?ОжидаетсяСОСНА. - Если нужна проверка проекта, откройте тестовый
README.md, попросите прочитать одну строку и не разрешайте других действий.
| Model ID | Вход и окно |
|---|---|
gemini-4-argon | Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ. |
gemini-3.8-flash | Текст, изображения, PDF; окно 1 048 576 токенов на вход. |
- Файлы и команды в Cursor обрабатывает сам клиент; историю чата он передаёт в каждом запросе.
- Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI-compatible Chat Completions. Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя gemini; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Настройки API key недоступны | Это ограничение плана или аккаунта Cursor. Не покупайте новый план ради этой инструкции; используйте Cline или VS Code с Claude Code. |
- Установите Cursor, войдите в свой аккаунт и откройте через File → Open Folder отдельную тестовую папку без секретов.
- Получите ключ Guard. Возможность Use OpenAI API Key зависит от условий вашего плана Cursor; документация Guard не требует покупать новый план.
Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
- Откройте Cursor Settings → Models. Нажмите Add Custom Model, введите
muse-wonder-1.0в Custom model name и нажмите Add. При необходимости отдельно добавьте остальные ID из таблицы ниже. - Раскройте API Keys, вставьте
gd-…в OpenAI API Key и включите Use OpenAI API Key. - Включите Override OpenAI Base URL и укажите
https://api.guardrelay.ai/v1без/chat/completions. - Откройте New Chat и выберите
muse-wonder-1.0у поля ввода.
| Поле Cursor | Значение |
|---|---|
| Custom model name | muse-wonder-1.0 |
| OpenAI API Key | gd-… |
| Use OpenAI API Key | включено |
| Override OpenAI Base URL | включено |
| Base URL | https://api.guardrelay.ai/v1 |
| Итоговый запрос | POST https://api.guardrelay.ai/v1/chat/completions |
- В новом чате без файлов отправьте:
Ответь ровно GUARD_MUSE_OK и запомни слово СОСНА. - В том же чате отправьте:
Какое слово нужно было запомнить?ОжидаетсяСОСНА. - Если нужна проверка проекта, откройте тестовый
README.md, попросите прочитать одну строку и не разрешайте других действий.
| Model ID | Вход и окно |
|---|---|
muse-wonder-1.0 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.3 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.2 | Текст, изображения, PDF; окно 1 048 576 токенов. |
- Файлы и команды в Cursor обрабатывает сам клиент; историю чата он передаёт в каждом запросе.
- Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI-compatible Chat Completions. Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя muse; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /chat/completions; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
| Настройки API key недоступны | Это ограничение плана или аккаунта Cursor. Не покупайте новый план ради этой инструкции; используйте Cline или VS Code с Claude Code. |
Установите Cursor, войдите в свой аккаунт и откройте проект. Ключ gd-… получите в боте Guard. Cursor направляет запросы к GPT-модели через OpenAI API Key и общий для OpenAI-моделей Override Base URL; этот способ использует Chat Completions.
Для проверки можно использовать обычный чат без файлов: отправьте «Ответь: связь установлена». Чтобы проверить работу с проектом, создайте в Проводнике или Finder отдельную папку guard-test, откройте её в редакторе и создайте файл README.md с текстом «Это тестовый проект Guard». Дальнейший пример чтения относится к этой папке.
| Model ID | Название |
|---|---|
gpt-6-astra | GPT-6 Astra |
gpt-6.1-sol | GPT-6.1 Sol |
gpt-6-sol | GPT-6 Sol |
gpt-6-luna | GPT-6 Luna |
gpt-5.6-sol | GPT-5.6 Sol |
gpt-5.6-terra | GPT-5.6 Terra |
gpt-5.6-luna | GPT-5.6 Luna |
- Через File → Open Folder откройте тестовую папку без секретов с
README.md. Затем откройте Cursor Settings → Models. Нажмите Add Custom Model, введите ровноgpt-6-astraв Custom model name и нажмите Add. Если ID уже есть, повторно добавлять его не нужно. - Ниже раскройте API Keys. В поле OpenAI API Key вставьте
gd-…из бота. После сохранения Cursor скрывает ключ и показываетSecret saved; это нормально. Включите Use OpenAI API Key. - Включите Override OpenAI Base URL и укажите в появившемся Base URL ровно
https://api.guardrelay.ai/codex/v1без завершающего/. Выйдите из поля, чтобы сохранить значение. - Откройте New Chat, выберите
gpt-6-astraу поля ввода и отправьте:Прочитай README.md и объясни в двух предложениях, о чём этот тестовый проект. Ничего не меняй. Если Cursor попросит разрешение, разрешайте только чтение файла. - Для продолжения отправьте в этом же чате:
Назови один факт из README.md, на котором основано объяснение. Для другой задачи откройте новый чат.
| Поле Cursor | Значение |
|---|---|
| Custom model name | gpt-6-astra |
| OpenAI API Key | gd-… |
| Use OpenAI API Key | включено |
| Override OpenAI Base URL | включено |
| Base URL | https://api.guardrelay.ai/codex/v1 |
| Итоговый запрос | POST https://api.guardrelay.ai/codex/v1/chat/completions |
После проверки чтения можно поручить изменение: «Добавь в README.md раздел Проверка и одну строку описания». Просмотрите предложенную правку и подтвердите её, если она соответствует задаче. Команды, доступ к файлам и инструменты разрешаются в самом клиенте; для подключения Guard не нужно заранее выдавать неограниченный доступ ко всему компьютеру.