ZCode FAQ: частые вопросы по AI-агенту на GLM-5.2
На этой странице собраны ответы на популярные вопросы о ZCode: продуктовое позиционирование, ценообразование и технические проблемы, с которыми можно столкнуться в работе.
1. Какое продуктовое позиционирование у ZCode?
ZCode — это новая Agentic Development Environment (ADE). В отличие от традиционной IDE, центрированной на ручном кодинге, ZCode ставит AI-агентов в центр процесса. Вы описываете задачу естественным языком, а агент ведёт полный цикл — от написания и отладки кода до предпросмотра и итераций.
- ADE-платформа: центрирована на первопартийном ZCode Agent, со встроенным управлением файлами, терминалом, Git-коммитами и live-предпросмотром в браузере.
- Полное понимание контекста: агенты понимают структуру проекта, содержимое файлов и визуал интерфейса без необходимости помнить сложные CLI-флаги.
- Текущий фокус: усиление исполнения и стабильности длинных задач вокруг самописного ZCode Agent, объединение контекста воркспейса, инструментов, моделей, полномочий и ревью в единый непрерывный поток разработки.
2. ZCode бесплатный?
Само приложение ZCode полностью бесплатно. Как разработчик, вы используете собственный API-ключ или тариф модели. Текущие поддерживаемые опции:
- Семейство Zhipu: GLM Coding Plan, пакеты ресурсов BigModel или баланс аккаунта, и Z.ai.
- Модельные сервисы: тарифы и сервисы моделей, подключённые для ZCode Agent.
- Корпоративные каналы: модельные каналы под управлением команды для ZCode Agent.
- Самохостинговые сервисы: приватные модельные сервисы, одобренные вашей командой.
3. В терминале уже настроен GLM API. Нужно ли настраивать его заново в ZCode?
Да. Переменные окружения терминала и настройка модели в десктопном ZCode — это раздельные точки входа, поэтому конфигурация не синхронизируется автоматически. Можно выбрать любой из способов:
- Quick Connect: подключить аккаунт BigModel / Z.ai с экрана приветствия или из меню аватара; если у аккаунта активный тариф — подключение произойдёт автоматически.
- Ручная настройка: добавить Base URL и API Key через
Manage Models.
4. Почему Connect бесконечно грузится?
Если подключение модели остаётся в состоянии Loading, проверьте две вещи:
- Сетевое окружение: убедитесь, что машина может достучаться до выбранного модельного сервиса.
- Доступность аккаунта: убедитесь, что у залогиненного аккаунта или API-ключа есть квота и доступ к модели.
5. Почему при добавлении контекста через @ можно выбирать только файлы, а не папки?
Пикер @ в поле ввода заточен под быстрый выбор отдельных файлов; он также умеет ссылаться на навыки (skills) и агентов — но папки не показывает. Чтобы добавить целую папку как контекст для агента, перетащите её прямо в поле ввода.
Поддерживаемые варианты:
- Перетащить папку из дерева файлов ZCode в поле ввода.
- Перетащить папку из Finder, Проводника или иного системного файлового менеджера в поле ввода.
После попадания папки в поле ввода ZCode использует её как контекст — агент сможет анализировать структуру директории и работать с файлами внутри.
6. В чём разница между эндпоинтом Coding Plan, Anthropic и общим OpenAI?
BigModel и Z.ai предоставляют три типа эндпоинтов в режиме API Key (см. Connect Models → BigModel / Z.ai API Endpoints):
| Эндпоинт | Пример (BigModel) | Когда использовать |
|---|---|---|
| Только Coding Plan | https://open.bigmodel.cn/api/coding/paas/v4 | У вас есть GLM Coding Plan и вы подключаетесь его API-ключом для кодинга |
| Общий OpenAI | https://open.bigmodel.cn/api/paas/v4 | Пакеты ресурсов / предоплата через OpenAI-совместимый API |
| Anthropic | https://open.bigmodel.cn/api/anthropic | Те же пакеты/баланс через Anthropic-протокол (значение по умолчанию в ZCode) |
Типичные ошибки:
- Подписаны на Coding Plan, но поставили OpenAI-URL на общий эндпоинт
/api/paas/v4→ квота тарифа не будет учитываться корректно. - Используете только пакеты ресурсов / баланс, но вписали Coding-эндпоинт
/api/coding/paas/v4→ Coding-эндпоинт предназначен только для кодинга, а не для общего API-использования. - Подключились через авторизацию аккаунта Coding Plan (не через API Key) → ручная настройка URL не требуется, ZCode маршрутизирует автоматически.
Для Z.ai замените хост на api.z.ai; правила путей те же.
Заметка практика: самый частый «грабли» у новых пользователей ZCode в России — путаница с эндпоинтами. Если вы купили GLM Coding Plan, не указывайте общий
/api/paas/v4— будет расходоваться баланс по дорогому тарифу вместо включённых в план лимитов. И обратите внимание: ZCode по умолчанию использует Anthropic-протокол, что удобно, если вы мигрируете с Claude Code и уже привыкли к этой семантике ответов. Лично я для чисто кодовых задач держу Coding Plan, а для «общих» разговоров и аналитики — отдельный баланс на OpenAI-эндпоинте.
Локализованный гайд по официальной документации ZCode. Оригинал на английском.
