ZCode

ZCode — агент для программирования от Z.ai, построенный вокруг моделей GLM. Z.ai опубликовала его исходный код под Apache-2.0; команда zcode запускает в терминале ту же среду выполнения агента, что и десктопное приложение ZCode. В NeuroSquad каждый агент ZCode — карточка, внутри которой работает настоящий zcode.

Измерено на среде выполнения ZCode 0.16.9 (zcode-app-cli 3.14.4-32).

Установка

Установите команду zcode

Готовой загрузки для терминала Z.ai не выпускает, поэтому команда zcode берётся из npm:


npm install -g zcode-app-cli@latest

zcode-app-cli — неофициальный клиент, который поставляет среду выполнения Z.ai без изменений. Settings → Setup в NeuroSquad может поставить его за вас. zcode, собранный из собственного репозитория Z.ai, тоже подойдёт.

Настройте провайдера

Настройте провайдеров и модель по умолчанию в ZCode так, как вы делаете это обычно, — карточки начинают с ваших провайдеров. Карточку можно запустить и на OpenRouter или на вашем сервере.

Добавьте карточку ZCode

Добавьте карточку агента и выберите ZCode. NeuroSquad проверяет, что найденный zcode — действительно ZCode: посторонние программы с тем же именем не используются.

Что работает

Точный статус. Собственные хуки ZCode сообщают карточке, когда агент работает, закончил или ждёт вас — с вызовом, который он хочет сделать (ZCode needs your permission: Bash rm -rf dist), или с его вопросом. См. Закончил / ждёт вашего ответа.
Стрелки. MCP-сервер NeuroSquad прописан в настройках карточки, и его собственные инструменты не спрашивают разрешения. ZCode читает инструменты сервера один раз, поэтому карточка сразу получает все инструменты NeuroSquad, а стрелки решают в момент вызова. Навыку или установленному MCP-серверу нужен следующий запуск карточки.
Режим карточек. Bash, его фоновые оболочки и веб-инструменты убраны из того, что видит модель, даже в опасном режиме. См. Режим карточек.
Сессии. После перезапуска карточка продолжает тот же разговор (zcode --resume). Удалённая сессия заменяется новой.
Долгие сессии. Счётчик контекста, Compact (команда ZCode /compact), очередь промптов, журнал и передача.
Расход. Каждый запрос читается из собственного журнала расхода ZCode — с заголовками, сжатием и субагентами, субагенты помечены — в Расходе и стоимости, Run Stats и Agent Pulse.
Модели и провайдеры. Модель выбирается для каждой карточки; ведущий агент может сменить её через agent_set_model. OpenRouter и ваши серверы работают, а ключ не попадает ни в один файл.
Смена CLI. Перенесите разговор в Claude Code и обратно.
Плагины. Память, Context7, Caveman и Graphify доходят до ходов ZCode; экономия токенов работает в опасном режиме.
С телефона. В удалённом доступе карточка работает как любая другая.

Опасный режим

Карточка ZCode запускается в опасном режиме с --mode yolo. Включение и выключение перезапускают карточку с тем же разговором; после выключения она продолжает в вашем обычном режиме. См. Опасный режим.

Полезно знать

Ваш ~/.zcode только читается. У каждой карточки своя копия ваших настроек плюс настройки NeuroSquad, своя база сессий и, когда нужно, свой файл провайдеров. Ключи и токены никогда не пишутся на диск.
Останавливайте ход клавишей Esc. Ctrl+C в простаивающем ZCode закрывает его, поэтому NeuroSquad его никогда не отправляет — бюджет-тормоз и ряд клавиш на телефоне используют Escape.
Память проекта ZCode в карточке выключена, если её не включает ваш собственный setting.json. Её фоновые вызовы нигде не записываются, так что расход не смог бы их учесть; если вы её включите, этих вызовов в расходе не будет.
Разговоры хранятся в базе карточки. zcode --resume в вашем терминале найдёт их, только если ZCODE_SESSION_DB_PATH указывает на этот файл. Удаление карточки базу не удаляет.
После Escape терминальный интерфейс ZCode проглатывает следующее нажатие.

Карточки ZCode работают только на этом компьютере — пока не в воркспейсах WSL или SSH.