ZCode с нуля.
Настрой. Создай. Проверь.

К концу Уровня 0 у тебя будет не просто «изученная программа», а рабочая среда для ИИ-разработки и проверенный первый мини-проект. Я проведу тебя по маршруту: установка → вход → интерфейс → модель → безопасные разрешения → инструкции и память → первый проект. Не нужно включать все функции в первый же день.

Что такое ZCode

Это рабочее приложение для ИИ-агента: проектные папки, задачи и диалоги, инструменты для изменения файлов, браузер и расширения. ZCode — не название одной модели. Модель — подключаемый «мозг», а ZCode — среда, через которую она работает. Можно подключать Z.ai/GLM и внешних провайдеров при наличии нужного доступа.

Какой проект возьмём?

Одна сквозная задача: сделать небольшую страницу «Мой проект» с названием, описанием, тремя преимуществами и кнопкой. Мы будем использовать её для проверки модели, прав, файлов, браузера, результата и сохранения контекста. Можешь заменить её на собственную полезную мини-задачу.

Что понадобится

Компьютер macOS или Windows, браузер, личная почта, папка для проекта и доступ к модели. Оплата и VPN нужны не всем: сначала проверь законные и официальные способы подключения в своей стране.

Шаг 1. Скачай под свою систему

Открой официальную страницу установки ZCode. Выбери macOS Apple Silicon/Intel или Windows x64/ARM64 в соответствии с компьютером. Не скачивай установщики из случайных Telegram-архивов, неизвестных зеркал или «предактивированных» пакетов.

Шаг 2. Правильный вход

На приветственном экране существуют два провайдера: Continue with Z.ai (глобальная платформа) и Continue with BigModel (китайская платформа), а также вход по API-ключу. В видео я выбираю глобальный Z.ai и авторизацию Google. Конкретные варианты входа зависят от текущей версии и региона.

Если вход не удался, проверь сеть, время системы и статус учётной записи, затем воспользуйся официальной документацией. Не проси куратора войти вместо тебя и не пересылай ему пароль или одноразовый код.

Актуальная установка: ZCode Docs / Install. Проверено по официальному источнику 19.10.2026. Названия кнопок могут поменяться.

Открой ZCode и посмотри на экран. Если слева не видно список, нажми кнопку показа боковой панели. Это не ошибка и не потеря проектов: панель просто скрыта.

Не путай четыре понятия

Первая проверка без риска

Выбери свою учебную папку и отправь агенту небольшой запрос без изменения файлов. Убедись, что он понял путь к проекту, прежде чем разрешать любые действия.

ZCode умеет работать с моделями через Z.ai или других совместимых провайдеров. В видео я показываю варианты подключения GLM, Claude, MiniMax и других моделей через внешних провайдеров, включая OpenRouter. Это варианты подключения, а не одна общая бесплатная подписка. Доступ зависит от владельца ключа, подписки и региона.

Маршрут А: подключить Z.ai

1. Открой Settings → Model Settings или выбор модели из окна чата.
2. Выбери Z.ai и официальный вход.
3. Убедись, что подключение активно и у выбранной модели есть доступ по твоему плану.
4. Выбери модель в новом диалоге и отправь короткое тестовое сообщение.

Маршрут Б: OpenRouter — если он тебе нужен

1. Создай отдельный ключ в своём личном аккаунте OpenRouter.
2. В Model Settings → Add Provider выбери подключение внешнего сервиса.
3. Укажи имя OpenRouter и URL, указанный в официальной документации ZCode для OpenRouter; интерфейс может ожидать базовый URL или шаблон.
4. Вставь ключ в секретное поле самого приложения, не в чат, скриншоты, GitHub или чужую таблицу.
5. Добавь одну совместимую модель, активируй провайдера и проверь простым запросом.

По официальной документации ZCode для OpenRouter указан базовый адрес https://openrouter.ai/api. Проверяй актуальную инструкцию: Connect Models.

Как отличить цену от лимита

В видео упоминаются конкретные модели, промо-токены и годовые тарифы. Эти цифры и наличие бесплатных лимитов быстро меняются — **не ориентируйся на услышанную стоимость без проверки тарифа в день оплаты**. Не используй чужие аккаунты или ключи без разрешения владельца.

Coding Mode, а не Office Mode

В записи я открываю Settings → General → Interface Mode. Для создания программ и проектов выбирай Coding Mode: так доступен кодовый рабочий сценарий. Office Mode — упрощённый вариант для документов и обычных офисных задач. Если названия отличаются в твоей версии, ищи режим, связанный с разработкой.

Настройки из видео: что с ними делать

В видео я показываю много настроек сразу. Здесь сделаю важное уточнение для новичка: не включай права на управление компьютером, браузером и автоматические действия только ради совпадения с моим экраном. Сначала разберись, зачем нужна функция. К потенциально опасным разрешениям мы вернёмся отдельно.

Когда агент уже выполняет задачу, твоё новое сообщение может либо встать в очередь, либо скорректировать текущий план. В своём видео я сравниваю режимы Queue и Guide/Steer. Название переключателя может отличаться по версии приложения.

Пример на нашей странице

Агент собирает страницу «Мой проект». Тебе пришла новая идея: добавить блок отзывов.

• Queue: попроси добавить отзывы после проверки базовой страницы.
• Steer: вмешайся сейчас, если агент выбрал неверную аудиторию и надо менять направление работы.

Не отключай проверки на автомате

В видео обсуждаются продолжение работы без вопросов, параллельные агенты и поведение при блокерах. Но новичку полезнее начать с Ask before changes или другого подтверждаемого режима, если он доступен. Дай агенту автономию внутри учебной папки, а удаление данных, публикацию, расходы и доступы требуй согласовывать.

Код — ещё не доказательство. Browser Use позволяет агенту открыть страницу во встроенном браузере, нажимать элементы, заполнять формы и делать снимки. В записи я показываю включение браузера и импорт данных Chrome.

Первый безопасный тест

1. В Settings → Browser включи Enable built-in browser control только если собираешься проверять страницу агентом.
2. Открой публичную тестовую страницу без входа в аккаунты либо локальный файл своего мини-проекта.
3. Попроси агента найти заголовок и кнопку, сделать скриншот и сообщить, что он реально увидел.
4. Сравни полученную проверку с тем, что видишь сам.

Импорт Chrome — дополнительный, НЕ обязательный шаг

В записи импортируется состояние Chrome: cookies и разрешения. Это даёт агенту доступ к сайтам, где ты уже вошёл в систему. Но cookies могут играть роль токенов авторизации, поэтому по умолчанию не импортируй личный Chrome в учебный профиль. Для теста достаточно публичных страниц. Импорт допускается только осознанно, на личном устройстве, когда у тебя есть разрешение на автоматизацию этих аккаунтов.

Официальный источник: Browser Automation / ZCode (проверено 19.10.2026).

Computer Use — возможность управлять элементами рабочего стола: мышью, окнами, приложениями. Это мощнее проверки одного сайта. В записи я показываю переключатель Computer Use и настройки Accessibility и Screen Recording на macOS.

На macOS

1. Открой Settings → Computer Use в ZCode.
2. Если действительно хочешь разрешить управление, используй Open Accessibility Settings и Open Screen Recording для перехода в «Системные настройки».
3. Проверь, что разрешаешь доступ именно установленному тобой ZCode, а не постороннему приложению.
4. После изменения разрешений перезапусти нужную задачу, если приложение не увидело новые права.

Когда НЕ включать

Если тебе нужно создать HTML-файл, а ZCode и так умеет работать с файлами проекта — не обязательно давать полный контроль над компьютером. Работай по принципу минимально необходимых прав.

Тест без риска

Открой пустую заметку с надписью «ТЕСТ ZCODE». Разреши агенту только её найти и сообщить текст. Следи за его действиями и проверь кнопку остановки.

Хочу, чтобы ты с самого начала понял важное отличие: инструкции — это то, что ты осознанно задаёшь агенту, а память — то, что он накапливает сам. В ZCode есть два уровня инструкций AGENTS.md: глобальный для всех твоих проектов и отдельный для каждого проекта. Покажу на конкретном примере.

1. Глобальные инструкции — твои правила для всех проектов

Представь, что ты каждый день создаёшь сайты, ботов и CRM. Ты не хочешь объяснять в каждом новом проекте одно и то же: «Общайся со мной на русском», «Не меняй файлы без плана», «Не говори “готово” без проверки». Такие требования я советую вынести в глобальный файл:

Вот пример простых глобальных правил, которые можешь взять за основу:

# Мои общие правила работы с ИИ
- Общайся со мной на русском языке, понятно и без лишнего жаргона.
- Перед крупными изменениями кратко объясни план.
- Работай только с разрешёнными файлами и инструментами.
- Не публикуй код, не удаляй данные и не трать деньги без согласования.
- После работы реально проверь результат, а не просто сообщай «готово».
- Если чего-то не знаешь, уточни; не выдумывай факт или команду.

Эти правила будут актуальны, когда ты откроешь новый проект в ZCode. Например, и при разработке Telegram-бота, и при создании сайта агент должен сначала планировать и проверять результат.

2. Инструкции проекта — правила только для открытой папки

А теперь представим конкретный проект: мы делаем страницу «Мой проект». Здесь уже важны её файлы, технология, способ проверки и ограничения. Для этого положи отдельный AGENTS.md в корень текущего Workspace, например zcode-first-project/AGENTS.md.

# Правила проекта «Мой первый сайт»
Цель: создать простую HTML-страницу для моей идеи.
Стек: HTML, CSS и минимальный JavaScript без сложных фреймворков.
Рабочая папка: только текущий проект.
Файлы: index.html и при необходимости style.css, script.js.
До редактирования: сначала предложи план.
После редактирования: открой страницу и проверь заголовок,
три карточки и работу кнопки; покажи скриншот.
Нельзя: менять чужие проекты или публиковать сайт без разрешения.

Эти правила не должны автоматически переноситься в другой проект. Для Telegram-бота будет другой язык программирования, другая структура и свои проверки, но твои глобальные принципы — те же.

3. Как ZCode объединяет оба файла

По официальной документации ZCode, при запуске задачи агент сначала получает глобальные инструкции, затем проектные. Проектный файл считается основным источником проектных правил. Поэтому не стоит писать в файлах противоречащие друг другу команды. Общие требования размещай глобально, а детали технологии и продукта — в проекте.

4. Настроим оба файла на твоём компьютере

1. Глобальный: открой домашнюю папку и создай каталог .zcode, если его ещё нет. В нём создай текстовый файл AGENTS.md и вставь общие правила. На macOS папка с точкой может быть скрыта: в Finder нажми Cmd + Shift + .. На Windows удобнее открыть домашнюю папку пользователя в проводнике и создать там .zcode.
2. Проектный: открой папку zcode-first-project, которую мы создали в начале гайда. Прямо в ней создай другой файл AGENTS.md и вставь правила проекта.
3. Проверь различие: глобальный и проектный файлы должны находиться в разных папках и содержать разные задачи. Оба называются одинаково — это правильно.
4. Открой новый диалог в Workspace: спроси у агента, какие правила доступны. Попроси указать оба пути и пересказать по одному правилу из каждого файла. Не верь только словам: сам проверь, что оба файла существуют и содержат то, что ты написал.

5. А где здесь Memory и почему это не AGENTS.md?

AGENTS.md пишешь и редактируешь ты. Он фиксирует договорённости, которым агент должен следовать. Memory формирует сам агент — например, запоминает, что проект использует определённую сборку, и в следующей сессии учитывает эту информацию. Эти заметки не заменяют правила проекта и не должны быть единственным источником критически важной информации.

1. Открой Settings → General → Memory.
2. Прочитай предупреждение о расходе дополнительных токенов и том, что память создаётся локально.
3. Если функция нужна — включи её и начни новый диалог: изменение не задним числом применяет память к текущей беседе.
4. Не сохраняй в Memory, AGENTS.md и чате пароли, API-ключи или платёжные данные.

Проверено по ZCode Agent → Project Instructions File / Project Memory (октябрь 2026). Правила хранения и наследования инструкций в других инструментах, например Codex и Claude Code, могут отличаться.

Subagent — дочерний агент, которому основной ИИ поручает отдельный кусок задачи: проверить код, написать тесты или оценить интерфейс. В видео я показываю создание субагента: имя, модель, описание, инструменты и инструкции.

Первый полезный субагент

1. Перейди в Settings → Subagents.
2. Создай «Контролёр качества» (или попроси ZCode оформить его).
3. Опиши задачу: только читать файлы проекта, проверять страницу и дать отчёт об ошибках.
4. Не давай ему лишние инструменты удаления, публикации, сети и выполнения опасных команд.
5. Проверь, что главный агент получил от него конкретный список проверок.

Не запускай сразу десять агентов

Параллельность может ускорить работу, но также повышает расход токенов и число потенциальных конфликтов. Для первого проекта хватает одного основного агента и одного проверяющего. Если инструкция «унаследовать AGENTS.md» существует — уточняй по версии, что именно будет передано, и проверяй фактический результат.

В видео показан Plugin Marketplace и возможность добавлять собственные источники расширений. Плагин может приносить сразу несколько функций: Skills, команды, субагентов, MCP и Hooks.

Безопасный первый проход

1. Открой Settings → Plugins.
2. Найди официальный или хорошо проверенный плагин, необходимый твоему проекту.
3. Прочитай состав: какие команды, MCP-серверы, Hooks и разрешения он устанавливает.
4. Если есть системные скрипты или доступ к переменным окружения — не устанавливай без проверки исходников.
5. Подключи один плагин, проверь нужный эффект, при отсутствии пользы отключи.

Почему установка по ссылке на GitHub требует проверки

Плагин — это не просто текст, он может запускать программы с правами твоего пользователя. Не стоит бездумно ставить десятки случайных плагинов или давать им доступ к API-ключам.

Официальный источник: Plugin / ZCode (проверено 19.10.2026).

В видео я открываю MCP Servers и объясняю, как подключать к агенту инструменты внешних сервисов. MCP (Model Context Protocol) — способ описать доступные действия и данные по общему протоколу. Это не обещание, что любой сервис подключится сам без ключей и подтверждения доступа.

Практика без подключения личных аккаунтов

На нулевом уровне просто открой Settings → MCP Servers, найди список уже подключённых серверов и посмотри описания инструментов. Не добавляй CRM, почту и банк ради эксперимента.

В записи я показываю Skills, Commands и Hooks. Эти слова похожи на «автоматизацию», но работают по-разному. Не нужно ставить 200 навыков ради обучения: сначала достаточно одного хорошего навыка и понятного процесса проверки.

Skills — правила работы

Например, Skill «Проверить мини-сайт» описывает: открыть страницу, проверить кнопку, сделать скриншот, перечислить ошибки и только после этого сообщать «готово». Такой навык можно переиспользовать в других проектах.

Commands — повторяемый вызов

Например, команда /review (если ты её создал) каждый раз просит проверить текущий результат по фиксированному чек-листу. Название команды зависит от установки; нельзя предполагать, что команда существует автоматически.

Hooks — исполняемый код по событию

В видео приведены сценарии сохранения контекста и блокирования опасных действий. Hook запускает локальный процесс, поэтому его нужно проверять как обычную программу. Пример в учебной системе: после изменений HTML запускать тест и сохранять лог.

Рабочий пример: чек-лист страницы

Составь небольшой текстовый Skill, который не имеет побочных эффектов: он просит найти заголовок, проверить кнопку, сделать скриншот и сверить фактический результат с заданием. Сначала используй его просто как промпт — на следующем уровне можно оформить в настоящий Skill-пакет.

Источники: Skills и Hooks (проверено 19.10.2026).

В записи я показываю экран Usage Stats: распределение нагрузки по дням, модели и токены. Но число токенов не равно счёту за оплату. Для подписки учитываются лимиты и правила Z.ai; для внешнего API — тарифы конкретного провайдера.

Проверь расход осмысленно

1. Открой Settings → Usage Stats.
2. Сравни, какая модель использовалась в разные дни.
3. Если подключён внешний API, открой кабинет провайдера и проверь фактическую сумму и лимит бюджета.
4. Поставь небольшой лимит на тесты, если сервис поддерживает.
5. Не публикуй ключи и финансовые детали в скриншотах.

Что делать, если токены расходуются слишком быстро

Сокращай лишние файлы в контексте, прекращай ненужные циклы, используй модель подходящего уровня для задачи, проверяй фоновые задачи и подключённые инструменты. В Hard Coding PRO я учу тебя сначала добиваться одного проверенного результата, а не расходовать как можно больше токенов.

В видео я показываю Mobile Remote Control в ZCode и объясняю, как подключаться с телефона. Идея простая: агент выполняет задачу на твоём компьютере, а телефон позволяет смотреть процесс и добавлять указания. Телефон не становится самостоятельным сервером для выполнения кода.

Пробное подключение

1. На компьютере открой ZCode → Mobile Remote Control.
2. Проверь, что ты на доверенном устройстве и никто не видит экран с QR-кодом.
3. Сканируй QR с собственного телефона.
4. Посмотри текущую учебную задачу; добавь безопасное уточнение.
5. После теста нажми Stop на компьютере и проверь закрытие доступа.

А Telegram-бот?

В моей записи среди мобильных каналов действительно виден Telegram наряду с Weixin, Feishu и Lark. Возможность подключения зависит от версии ZCode и условий самого сервиса: прежде чем следовать этому пути, проверь актуальную документацию, необходимость создания своего бота и разрешения доступа. Для базового Уровня 0 этот шаг необязателен. Я не буду обещать тебе работающего Telegram-бота «в один клик», пока мы не проверим его на твоей версии ZCode.

Источники: Remote Control и Bot Channel. Проверено 19.10.2026.

Сейчас соберём сквозную учебную задачу — страницу «Мой проект». Это минимальный, но настоящий результат: файл, работающий интерфейс и проверка поведения. Главное: агент должен показать что конкретно он сделал, а не просто написать «готово».

Что строим

1. В папке zcode-first-project создать index.html и, если нужно, отдельный файл стилей.
2. Заголовок страницы: «Мой первый проект».
3. Короткое понятное описание для кого и зачем эта идея.
4. Три карточки преимуществ.
5. Кнопка «Связаться» с безопасным тестовым действием, не отправляющим личные данные.
6. Проверить в настоящем браузере, включая узкий мобильный экран.

Порядок работы

Шаг 1. Вставь промпт ниже. Шаг 2. Прочти краткий план агента. Шаг 3. Одобри изменения только в учебной папке. Шаг 4. Попроси показать файлы и открыть страницу. Шаг 5. Сравни результат с требованиями. Шаг 6. Если найден дефект — исправь и повтори тот же тест.

Что считается результатом

В моём видео я показываю простой приём: когда что-то не получается, сделать снимок ошибки и отправить его самому агенту. Ему часто легче разобраться с контекстом, чем новичку угадывать точные слова для поисковика.

Три правила восстановления

1. Скопируй точную ошибку. Оставь время, название инструмента и действие, которое её вызвало. Закрой на снимке ключи, почту, личные кабинеты.
2. Попроси агента проверить причину самостоятельно. Сначала он может посмотреть логи, документацию и текущие настройки; он не должен сразу предлагать тебе 15 произвольных команд.
3. Выполняй только одно неизбежное действие. Если нужна системная кнопка или пароль, пусть объяснит, где и зачем, и подождёт твоего подтверждения.

Типовые сбои

Теперь собери учебный результат. Ты не обязан знать все параметры ZCode наизусть — важно, чтобы ты мог повторить последовательность действий, безопасно попросить помощь и проверить сделанное.

Мини-экзамен без оценок

1. ZCode открывается, выбран Coding Mode.
2. Ты знаешь, какая модель/провайдер подключены и как проверить расходы.
3. Работаешь в отдельной учебной папке, знаешь назначение AGENTS.md.
4. Можешь отменить опасное действие агента.
5. Открыл собственный HTML-проект в браузере и проверил кнопку.
6. Знаешь, какие разрешения Browser Use, Computer Use и Remote Control необязательны.
7. Можешь показать куратору только безопасный скриншот и конкретную ошибку.

Что показать куратору

Краткий отчёт из четырёх строк: **ОС · модель · ссылка или скриншот первого проекта · что пока не работает**. Никаких ключей, cookie-файлов, личных документов и кодов входа.

Дальше

После готового мини-проекта продолжай по Уровню 1: вайбкодинг от А до Я. Этот ZCode-гайд — полноценная третья ветка, рядом с Codex и Claude Code, а не замена другим маршрутам.