Примечание: материал описывает возможности ZCode на август 2026 года. Продукт быстро развивается — сверяйтесь с официальной документацией.
ZCode — это ИИ-агент для разработки, который работает прямо в вашем проекте: читает кодовую базу, редактирует файлы, запускает команды в терминале и доводит задачу от формулировки до работающего результата. В отличие от обычного чата с ИИ, агент не просто советует — он выполняет, а вы управляете и проверяете. Курс — для первого знакомства.
Урок 1. Чем агент отличается от чата
В чате вы копируете код туда-обратно сами. В ZCode вы описываете задачу, а агент сам находит нужные файлы, предлагает изменения, показывает разницу и запускает проверки. Вы остаётесь руководителем: принимаете план, подтверждаете действия, смотрите результат. Рабочая папка проекта — его рабочий стол.
Практический совет с первого дня: начинайте работу в ZCode только в проекте под контролем версий (Git). Тогда любое изменение можно откатить, а смелость экспериментов ничего не стоит.
Урок 2. Постановка задачи и план-режим
Главный навык в ZCode — тот же, что и везде: чёткая постановка задачи. Для большой работы используйте план-режим: агент сначала изучит проект и предложит план — какие файлы затронет, в каком порядке, как проверит результат. План можно править до начала выполнения: дешевле согласовать подход, чем переделывать готовый код.
Для маленьких задач план не нужен — просите сразу. Ориентир: задача больше «одного обозримого изменения» — сначала план.
Урок 3. Работа с файлами и терминалом
Агент умеет: искать по всему проекту, читать и редактировать файлы, запускать команды (сборка, тесты, линтер) и видеть их вывод. Это меняет стиль запросов — можно опираться на то, что уже есть в проекте:
Найди, где у нас валидируется email, и добавь такую же
проверку для телефона. Запусти тесты после изменения.Чем чище проект — тем точнее агент: понятные названия файлов и модулей, тесты, README. Это не требование ZCode, а общее свойство агентов: они опираются на контекст, который вы им оставили.
Урок 4. Подтверждения и безопасность
ZCode построен вокруг контролируемой автономии: значимые действия — редактирование файлов, команды терминала — проходят через подтверждения, а уровень самостоятельности агента можно настраивать. Новичкам рекомендуем средний режим: читать и анализировать агент может свободно, но изменения и команды — с вашего согласия. По мере доверия и опыта можно ослаблять контроль на безопасных операциях.
Три правила безопасности:
- Работайте в Git — всегда есть точка возврата.
- Не кладите секреты и ключи в проект — агент читает всё, что видит.
- Просите агенту запускать тесты после изменений — пусть проверяет себя сам.
Ключевые выводы
- Агент выполняет сам: находит файлы, правит, запускает команды — вы управляете и проверяете.
- Большая задача начинается с плана, маленькая — сразу.
- Git обязателен: откат дороже предупреждений.
- Подтверждения — не помеха, а управление автономностью агента.
- Чистый проект с тестами = точный агент.
Что дальше
Расширенные возможности — план-режим подробнее, навыки, субагенты и автоматизации — в курсе «ZCode: план-режим, навыки и автоматизации». Общие принципы работы с ИИ в коде — в «ИИ-грамотности для разработчиков» и «Плейбуке ИИ-нативной разработки».