ZCode: как начать пользоваться агентной IDE от Z.ai

ZCode -- это официальная агентная среда разработки (Agentic Development Environment, ADE) от Z.ai, компании стоящей за моделью GLM-5.2. Это приложение объединяет в одном окне AI-агента, файловый менеджер, встроенный терминал, Git-панель и браузерный предпросмотр. Вы пишете задачу на естественном языке, а ZCode сам разбирается, какие файлы изменить, какие команды запустить и как проверить результат.

ZCode появился в 2026 году как ответ Z.ai на успех Cursor, Claude Code и GitHub Copilot. Ключевое отличие: ZCode изначально построен вокруг GLM-5.2 -- модели от китайской компании Zhipu AI с контекстным окном в 1 миллион токенов и сильными показателями в задачах программирования. При этом у ZCode есть бесплатный пробный период -- 5 дней с 5 миллионами токенов в день, что позволяет реально оценить инструмент без каких-либо вложений.

Zhipu AI была основана в 2019 году как спин-офф Университета Цинхуа, одного из ведущих технических вузов Китая. Компания сосредоточилась на разработке больших языковых моделей и постепенно вышла на уровень, конкурентный западным фронтирным моделям. GLM-5.2, лежащий в основе ZCode, стал первой их моделью, которая заняла заметное место в международных рейтингах качества кода.

Для кого ZCode будет полезен:

ZCode -- не просто чат с кодом, как ранние версии GitHub Copilot. Это полноценная рабочая среда, где AI-агент имеет доступ к вашему файловому дереву, терминалу и браузеру. Агент может прочитать ошибку в консоли, открыть нужный файл, внести правку, запустить тесты и сообщить вам о результате -- всё в рамках одной сессии. Подобный подход называют «agentic coding» -- в отличие от простого автодополнения, агент самостоятельно планирует последовательность шагов и выполняет их.

Установка ZCode занимает несколько минут. Вот пошаговый алгоритм:

Шаг 1. Скачайте ZCode. Перейдите на официальный сайт zcode.z.ai и скачайте установщик для вашей операционной системы. Поддерживаются macOS и Windows (полная поддержка), Linux находится в стадии бета-тестирования. Размер установщика -- около 200 МБ. Для macOS скачайте .dmg файл и перетащите ZCode в папку Applications. Для Windows запустите .exe установщик и следуйте инструкциям мастера.

Шаг 2. Создайте аккаунт на Z.ai. Если у вас нет аккаунта Z.ai -- зарегистрируйтесь на z.ai. Можно использовать email или войти через Google-аккаунт. Если у вас уже есть аккаунт на платформе Zhipu BigModel (bigmodel.cn) -- его тоже можно использовать. Третий вариант: просто вставить API-ключ напрямую в настройках ZCode, если вы уже работаете с API GLM-5.2 через BigModel.

Шаг 3. Первый запуск и активация. После установки откройте ZCode. На приветственном экране выберите способ подключения:

После авторизации ZCode автоматически активирует пробный период: 5 дней, 5 миллионов токенов в день (3 миллиона для GLM-5.2 и 2 миллиона для более быстрого GLM-5-Turbo). Никакой банковской карты для пробного периода не требуется.

Шаг 4. Откройте или создайте проект. ZCode работает с папками-проектами, как любой современный редактор кода. Нажмите «Open Folder» и выберите папку с вашим проектом, или нажмите «New Project» для создания нового. После этого файловое дерево проекта появится в боковой панели слева, а в правой части откроется чат с агентом. ZCode автоматически проиндексирует файлы проекта, чтобы агент мог ориентироваться в структуре кода.

Шаг 5. Проверьте подключение. Напишите в чате простой вопрос -- например, «Какие файлы есть в этом проекте?» или «Что делает функция main?». Если агент отвечает связно и ссылается на реальные файлы -- всё настроено правильно.

После открытия проекта вы увидите панель чата с агентом справа. Начните с простых задач, чтобы понять, как ZCode работает.

Базовый запрос к агенту. Напишите в чате что-то конкретное -- например: «Добавь функцию валидации email в файл utils.js» или «Найди все места, где используется переменная userToken, и объясни их назначение». Агент прочитает нужные файлы, выполнит изменения и покажет diff прямо в интерфейсе. Перед применением правок ZCode показывает предпросмотр изменений -- вы можете принять их одним кликом или отклонить.

Использование @ для указания контекста. Нажмите @ в поле ввода, чтобы явно указать агенту, какие файлы читать. Например: @src/api/auth.ts @src/types/user.ts. Это помогает агенту сосредоточиться на нужных файлах, а не сканировать весь проект. Особенно полезно в больших монорепозиториях, где файлов сотни.

Goal Mode -- для многошаговых задач. Введите /goal в начале сообщения, чтобы задать проверяемую цель сессии. Например: /goal Реализовать авторизацию через JWT: регистрация, вход, обновление токена, тесты для каждого endpoint. Агент самостоятельно разбивает цель на шаги, выполняет их последовательно и продолжает до завершения или до точки, где требуется ваше решение. Это удобно для задач, которые обычно занимают несколько часов -- вы можете поставить задачу и вернуться к результату.

Терминал и браузер. В нижней части интерфейса есть встроенный терминал -- агент может запускать команды (npm install, python manage.py migrate, pytest и т.д.) напрямую и читать их вывод. Если ваш проект -- веб-приложение, нажмите «Browser Preview» -- ZCode запустит локальный сервер и покажет результат прямо внутри приложения, без необходимости открывать отдельный браузер.

История разговоров. Используйте # в поле ввода, чтобы сослаться на предыдущий разговор: #прошлая-сессия-с-авторизацией. Это позволяет агенту учесть контекст предыдущих сессий без повторного объяснения задачи. Каждая сессия автоматически сохраняется с автоматически сгенерированным именем.

Пять режимов выполнения. ZCode предлагает пять уровней автономности агента: от «спрашивать разрешения перед каждым действием» до «полный доступ без подтверждений». Переключаться между ними можно прямо в процессе работы через Shift+Tab. Для экспериментов с новым проектом удобно начать с максимального контроля и постепенно давать агенту больше свободы по мере того, как вы убеждаетесь в качестве его работы.

1M токенов контекста. GLM-5.2 работает с окном контекста в 1 миллион токенов -- это примерно 750 тысяч слов или несколько сотен файлов кода одновременно. Агент может охватить целый монорепозиторий или большой сервис без необходимости разбивать его на части. Для сравнения: Cursor и аналоги часто работают с контекстом 100-200K токенов и вынуждены выборочно читать файлы, что иногда приводит к «слепым пятнам» при рефакторинге.

Встроенный Git-агент. Git-панель в ZCode позволяет агенту не просто редактировать файлы, но и управлять версиями: создавать коммиты, просматривать историю изменений, работать с ветками. Агент видит diff с последним коммитом и может сам написать осмысленное сообщение коммита на основе внесённых правок. Для команд это означает более чистую историю Git без «fix» и «misc changes» коммитов.

Параллельная работа: GLM-5.2 + GLM-5-Turbo. ZCode автоматически распределяет задачи между двумя моделями: GLM-5.2 для сложных задач с планированием и GLM-5-Turbo для быстрых операций (форматирование, поиск по коду, короткие ответы). Это позволяет экономить токены и ускорять отклик в простых случаях, сохраняя мощность GLM-5.2 для действительно сложных задач.

Подключение внешних API-ключей. Помимо GLM-5.2, ZCode позволяет подключить другие модели через собственный API-ключ -- например, Claude или GPT-серию от OpenAI. Это делает ZCode универсальной оболочкой для агентного кодирования, а не только инструментом для работы с GLM. Особенно полезно для команд, которые хотят сравнить качество разных моделей на одних и тех же задачах.

Автоматическая кросс-файловая правка. Одно из ключевых отличий ZCode от простых AI-ассистентов -- способность агента вносить изменения одновременно в несколько файлов в рамках одного запроса. Переименование функции обновит все её вызовы по всему проекту. Добавление нового поля в схему базы данных повлечёт за собой обновление миграции, типов, контроллеров и тестов -- всё в одном действии.

ZCode предлагает несколько уровней подписки. Актуальные цены всегда нужно проверять на z.ai/subscribe, так как условия периодически меняются, особенно во время акций.

Бесплатный пробный период: 5 дней, 5M токенов в день (3M GLM-5.2 + 2M GLM-5-Turbo). Доступен для новых пользователей сразу после регистрации, банковская карта не требуется. Этого достаточно, чтобы поработать с небольшим проектом и понять, подходит ли инструмент.

Lite: Базовый платный план для индивидуального использования. Подходит для разработчиков, использующих AI-агент несколько часов в неделю.

Pro: В 5 раз больше квоты, чем в Lite. Для активных разработчиков, работающих с ZCode ежедневно как с основным инструментом.

Max: В 20 раз больше квоты, чем в Lite. Для команд и разработчиков, использующих ZCode как главную рабочую среду для крупных проектов.

Важный момент: в период действия акции использование GLM-5.2 через Coding Plan считается с коэффициентом 0.67, то есть реальная квота примерно в 1.5 раза выше номинальной. Следите за актуальными условиями на сайте.

Ограничения, о которых стоит знать:

ZCode и Z.ai -- продукт китайской компании Zhipu AI. В отличие от многих западных сервисов (OpenAI, Anthropic, Google), китайские AI-инструменты в России обычно доступны без VPN. Сайт zcode.z.ai и платформа z.ai открываются из большинства российских регионов напрямую.

Тем не менее есть практические нюансы, о которых стоит знать:

Вывод для российских пользователей: ZCode работает без VPN. Основная сложность -- оплата подписки. Начните с бесплатного 5-дневного пробного периода (карта не нужна), чтобы оценить инструмент перед покупкой. Если решите платить -- заранее подготовьте способ оплаты через зарубежный банк или крипту.

ZCode 3.2.2 и GLM-5.2: технические детали и важное предупреждение

Актуальная версия ZCode – 3.2.2. Архитектура GLM-5.2, лежащей в основе ZCode, – это Mixture-of-Experts с 753 миллиардами параметров суммарно, из которых активируется около 40 миллиардов на каждый токен. Такая конфигурация объясняет сочетание высокого качества вывода с относительно умеренными требованиями к вычислительным ресурсам при API-вызовах. Актуальные тарифы ZCode после окончания бесплатного пробного периода – на официальном сайте zcode.z.ai; на момент написания доступны тарифы Lite, Pro и Max с различными лимитами токенов.

Важно для корпоративных пользователей. По данным TechTimes (июль 2026), китайский закон о данных (Data Security Law и Personal Information Protection Law) применяется к каждому API-запросу GLM-5.2, обрабатываемому через облачную инфраструктуру Z.ai, поскольку серверы расположены в КНР. Это означает, что данные, передаваемые в API-запросах, подпадают под юрисдикцию китайского законодательства. Корпоративным пользователям, работающим с конфиденциальным или регулируемым кодом, следует проконсультироваться с юридическим отделом перед использованием облачного API ZCode. Для таких случаев Z.ai предлагает on-premise решение.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.