Содержание
Z AI Cursor: как подключить модель GLM
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 16 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
GLM 5.3 добавляется в Cursor через Cursor Settings > Models и обслуживается партнёрами Cursor с биллингом Cursor. Ручной доступ через собственный Z.ai endpoint в обсуждении GLM-4.7 назван официально неподдерживаемым: работа ответа сама по себе не подтверждает использование вашего ключа. Мы скачали подборку результатов веб-поиска по запросу «Z AI Cursor: как подключить модель GLM»: текст отдали 9 из 10.
Проверить Custom API в Cursor
Cursor поддерживает подключение сторонних моделей через настройки. В документации проекта на странице GLM 5.3 указано, что модель добавляется в список выбора из раздела Cursor Settings > Models. Это штатный путь для моделей, которые Cursor обслуживает через своих партнёров по инференсу: в документации сказано, что GLM 5.3 — открытая модель от Z.ai, а Cursor подаёт её через inference-партнёров.
Практический порядок проверки:
- Откройте настройки Cursor и найдите раздел Models.
- Посмотрите, есть ли GLM в списке доступных моделей — если да, добавление идёт штатным способом.
- Если модели в списке нет, переходите к разделу Custom API и проверяйте поля Base URL и имени модели.
- Убедитесь, что провайдер OpenAI-совместим: опция Override OpenAI Base URL рассчитана именно на такие сервисы.
Разделение важно, потому что от выбранного пути зависит и биллинг, и то, какие инструменты агента окажутся доступны. В документации Cursor отмечено, что GLM 5.3 — сторонняя модель и не входит в лимиты тарифов Cursor: на подписке The X она тарифицируется по ставкам из предоплаченного баланса, а на прежних тарифах списывается из пула Other Models. Все цены указаны за миллион токенов.
GLM 5.3 тарифицируется по тем же ставкам за токен, что и GLM 5.2: надбавки за длинный контекст и отдельной платы за запись кэша нет. Ставка одинакова по всему окну; итоговая стоимость зависит от количества токенов.
Различить API и Coding Plan
Путаница между обычным API и Coding Plan — источник большинства ошибок при подключении. Разберём, чем они различаются на уровне того, что вы вписываете в настройки.
Обычный API Z.ai — это доступ к модели по стандартному OpenAI-совместимому протоколу. Coding Plan — отдельная подписка, ориентированная на работу с кодом, и у неё свой endpoint. На форуме Cursor пользователь описывает ситуацию: он оформил подписку GLM coding Pro plan и использует адрес https://api.z.ai/api/coding/paas/v4. То есть Coding Plan обслуживается по пути с сегментом coding, и этот путь отличается от того, что подставляют при обычном доступе.
Что это значит на практике:
| Путь | Что подтверждено источником |
|---|---|
| Встроенная GLM 5.3 | Выбор в Cursor Settings > Models, биллинг Cursor |
| Z.ai Coding Plan через custom endpoint | Пользователь сообщил адрес coding/paas/v4; поддержка Cursor не гарантирует работу |
Правила выпуска и совместимости ключей Z.ai этот корпус не подтверждает.
Таблица описывает различие на уровне конфигурации; конкретные адреса и условия берите в кабинете Z.ai, потому что они привязаны к вашему аккаунту.
Поэтому при подключении через Custom API проверяйте не только то, что модель отвечает, но и то, чей ключ реально используется. Если цель — расходовать собственный баланс Z.ai, нужен именно ваш endpoint и ваш ключ, а имя модели должно совпадать с тем, что ждёт провайдер.
Получить нужный ключ
Ключ берётся в кабинете Z.ai. Cursor в этой схеме выступает клиентом, который отправляет запросы на ваш endpoint. Порядок такой:
- Зарегистрируйтесь или войдите в аккаунт Z.ai.
- Оформите доступ: обычный API или Coding Plan — в зависимости от задачи.
- Создайте ключ в разделе управления ключами.
- Скопируйте ключ и сохраните его в надёжном месте: повторно он может не отобразиться.
В обсуждении пользователь Coding Pro указывает endpoint https://api.z.ai/api/coding/paas/v4. Прочитанный форум не устанавливает правила совместимости ключей между обычным API и Coding Plan. Такие правила и причины ошибок авторизации следует сверять по документации Z.ai.
На форуме Cursor пользователь описывает похожую ситуацию с Coding Plan: подключение работало, затем начало выдавать сообщение о трудностях соединения с провайдером модели, при этом квота подписки израсходована не была. В ответе сотрудника проекта подчёркнуто, что такой способ подключения не является официально поддерживаемым в Cursor. Это объясняет, почему сбои возможны даже при верных ключах: вы работаете в режиме, который проект не гарантирует.
Практический вывод по ключу: держите отдельно ключ Z.ai и не полагайтесь на то, что Cursor подставит его автоматически. Проверяйте, что в настройках Custom API стоит именно ваш ключ.
Задать endpoint и модель
Это шаг, где чаще всего ломается подключение. В настройках Cursor есть поля для базового адреса и имени модели. Опция Override OpenAI Base URL, по ответу сотрудника проекта на форуме, предназначена для OpenAI-совместимых провайдеров.
Порядок действий:
- В настройках Cursor откройте раздел для кастомных моделей.
- Включите переопределение базового адреса.
- Впишите адрес Z.ai, соответствующий вашему продукту: для Coding Plan это путь с сегментом coding, для обычного API — базовый адрес провайдера.
- Укажите имя модели так, как его ждёт провайдер.
- Сохраните настройки и перезапустите чат, чтобы конфигурация применилась.
По имени модели есть отдельная тонкость. На форуме Cursor разбирают случай GLM-4.7: пользователю помог вариант имени в нижнем регистре — glm-4.7 вместо GLM-4.7. Но там же уточняется, что такой вариант запускает встроенную маршрутизацию Cursor.ai. То есть регистр имени влияет на то, куда уйдёт запрос.
Отсюда практическое правило: если вы хотите работать через свой ключ Z.ai, имя модели должно совпадать с тем, что принимает провайдер, и запрос должен уходить на ваш адрес. Если ответ приходит, а списание идёт по линии Cursor, значит, сработала встроенная маршрутизация, и конфигурация Custom API фактически не задействована.
Ещё одна деталь из документации Cursor: GLM 5.3 поддерживает контекстное окно на 1M токенов и три уровня рассуждений — Low, High и Max, где High стоит по умолчанию. Эти параметры задаются на стороне клиента и влияют на то, как модель обрабатывает запрос.
Проверить чатовый запрос
После сохранения настроек нужен простой тест, который покажет, что подключение работает. Начните с короткого вопроса в чате — например, попросите объяснить одну строку кода из открытого файла. Такой запрос проверяет сразу три вещи: дошёл ли запрос до модели, вернулся ли ответ и корректно ли отображается результат в интерфейсе.
Проверка по шагам:
- Задайте вопрос по открытому файлу — убедитесь, что модель его видит.
- Попросите внести правку — проверьте, применяется ли она.
- Попросите выполнить команду в терминале — посмотрите, приходит ли вывод.
- Задайте уточняющий вопрос — проверьте, продолжает ли модель работу в фоне.
Если на каком-то шаге ответа нет, вернитесь к настройкам endpoint и имени модели. Частая причина — несовпадение имени модели с тем, что ждёт провайдер, или ключ от другого продукта.
Для повторяющихся задач удобно держать готовый промпт. Ниже — заготовка для проверки подключения и типовой работы с кодом.
Ты работаешь как ассистент в редакторе кода. Прочитай открытый файл [имя файла] и кратко опиши, что он делает. Затем предложи одну правку по стилю [ваш стиль] и покажи её диффом. После этого задай мне один уточняющий вопрос по логике файла.
В квадратных скобках подставьте имя файла и желаемый стиль. Вариации той же задачи: попросить разобрать ошибку из терминала и предложить исправление; попросить написать тест на функцию из файла; попросить найти все места, где используется конкретная функция; попросить объяснить незнакомый фрагмент построчно; попросить предложить рефакторинг с сохранением поведения.
Объяснить ограничения агента
Главное ограничение — статус поддержки. В ответе сотрудника проекта на форуме Cursor сказано, что GLM-4.7 через endpoint Z.ai не является официально поддерживаемой конфигурацией, а опция Override OpenAI Base URL рассчитана на OpenAI-совместимых провайдеров, и гарантий работы с кастомными endpoint вроде Z.ai нет. Это относится к ручному подключению через Custom API.
Второе ограничение — биллинг. В документации Cursor отмечено, что GLM 5.3 — сторонняя модель и не входит в лимиты тарифов Cursor. На подписке The X она тарифицируется по ставкам из предоплаченного баланса, на прежних тарифах списывается из пула Other Models. Цены указаны за миллион токенов.
Третье — маршрутизация. В обсуждении на форуме Cursor отмечено, что при имени модели в нижнем регистре запросы идут через встроенную маршрутизацию Cursor, а логи подтвердили, что BYOK-запросы GLM-4.7 уходят через API-ключ Cursor. Это значит, что часть конфигураций работает, но расходует не ваш ключ Z.ai.
Четвёртое — стабильность. На форуме Cursor пользователи описывают внезапные сбои соединения с провайдером при подключении через Coding Plan, причём квота остаётся неизрасходованной. В том же обсуждении упоминается ошибка о превышении максимальной длины контекста модели при обработке большого файла. Такие ситуации стоит учитывать при работе с крупными проектами.
Пятое — доступность инструментов. В документации Cursor перечислены инструменты, доступные GLM 5.3 при работе с Cursor: поиск файлов, чтение содержимого, правки, терминал, браузер, генерация изображений, уточняющие вопросы и получение правил. Набор инструментов зависит от того, как именно подключена модель.
Частые вопросы
Как подключить Z AI Cursor к модели GLM?
Подтверждённый маршрут GLM 5.3 — Cursor Settings > Models: добавьте модель в список выбора и проверьте чат. Он использует партнёров и биллинг Cursor. Ручной Z.ai endpoint для GLM-4.7 в форуме назван официально неподдерживаемым; ответ не доказывает расход вашего ключа.
Чем отличается обычный API от Coding Plan?
В обсуждении пользователь Coding Pro указывает endpoint https://api.z.ai/api/coding/paas/v4. Правила совместимости ключей обычного API и Coding Plan в прочитанных источниках не описаны. Подключение GLM-4.7 через Z.ai endpoint Cursor официально не гарантирует.
Почему модель отвечает, но списывается не мой ключ?
При имени модели в нижнем регистре может сработать встроенная маршрутизация Cursor. В обсуждении на форуме Cursor отмечено, что логи подтвердили уход BYOK-запросов через API-ключ Cursor. Проверьте регистр имени модели и адрес endpoint.
Какие инструменты доступны агенту с GLM?
В документации Cursor перечислены поиск файлов, чтение содержимого, предложение правок, выполнение команд терминала, управление браузером, генерация изображений, уточняющие вопросы и получение правил. Набор зависит от способа подключения модели.
Что делать при ошибке соединения с провайдером?
Проверьте ключ и endpoint, убедитесь, что продукт ключа совпадает с адресом. На форуме Cursor пользователи описывают внезапные сбои при Coding Plan с неизрасходованной квотой. Если ошибка касается длины контекста, разбейте задачу на части.
Для смежных задач пригодятся материалы блога: как установить llama-cpp-python, где скачать ИИ Copilot, подключение n8n через MCP к Claude и запуск Qwen локально через Ollama и LM Studio.