ZubrIQ Code (zq) — кодинг-агент

ZubrIQ Code (zq) — кодинг-агент для терминала: правит код в вашем репозитории, запускает команды и тесты, объясняет чужой код. Модели — на платформе ZubrIQ, в контуре Республики Беларусь; телеметрия наружу не уходит. Форк Qwen Code.

Установка

Одна команда. Ставится самодостаточный архив (Node внутри) — npm, Node и права администратора не нужны.

# macOS, Linux, WSL
curl -fsSL https://zubriq.by/install.sh | bash

# Windows, PowerShell
irm https://zubriq.by/install.ps1 | iex

:: Windows, CMD
curl -fsSL https://zubriq.by/install.cmd -o install.cmd && install.cmd && del install.cmd

Скрипт кладёт агента в ~/.zubriq (Windows — %USERPROFILE%\.zubriq), делает zq доступным через ~/.local/bin и прописывает PATH. Проверьте (если команда не найдена — откройте новый терминал):

zq --version

Обновление

zq update

zq сверяется с указателем последней версии в хранилище платформы и обновляется на месте — npm и Node в системе для этого не нужны. Проверка делается и при запуске: если вышла новая версия, агент скажет об этом сам (отключается настройкой general.enableAutoUpdate). Повторный запуск установочной команды тоже сработает — архив заменится целиком, настройки и вход останутся.

Правила проекта: AGENTS.md

Инструкции для агента — стек, соглашения, что нельзя трогать — лежат в файле правил в корне проекта. zq читает AGENTS.md, CLAUDE.md и QWEN.md: это общеупотребимые имена, поэтому проект, размеченный для другого агента, работает у нас сразу, а размеченный у нас — у него. Файлы читаются и в подпапках, и глобально в ~/.qwen/; если их несколько, подхватываются все.

/init создаёт файл по содержимому репозитория, /memory add дописывает в него заметку. Пишут они в тот файл, который в проекте уже есть; если нет ни одного — создаётся AGENTS.md.

Вход

При первом запуске zq предложит войти через браузер — откроется страница подтверждения на zubriq.by (та же учётка, что в чате), после подтверждения ключ выпустится и подставится сам. Второй способ — готовый ключ из кабинета:

export ZUBRIQ_API_KEY=sk-zq-…   # ключ из my.zubriq.by → API-ключи
zq

Ключ действует на те же модели, что и API платформы: по умолчанию агент работает на zubr-coder, сменить можно командой /model внутри zq. Расход списывается с кошелька организации, как и любой запрос по ключу.

Как работать

Запускайте zq в каталоге проекта — агент читает его как рабочую папку.
Пишите задачу словами: «почини падающий тест», «добавь эндпоинт», «объясни, что делает этот модуль». Правки файлов агент показывает диффом, команды оболочки — спрашивает перед запуском.
/help — список команд, Esc — прервать ход, Ctrl+C дважды — выйти.

Команды в сессии

Полный список — /help; вот те, что нужны почти сразу.

Команда	Что делает
`/init`	Создаёт `ZQ.md` по содержимому репозитория
`/memory`	Показать и дописать правила проекта
`/model`	Сменить модель (по умолчанию `zubr-coder`)
`/permissions`	Что агенту можно без спроса
`/tools`, `/mcp`	Доступные инструменты и MCP-серверы
`/skills`, `/agents`	Навыки и субагенты
`/diff`	Показать текущие правки
`/resume`, `/rewind`	Вернуться к прошлой сессии или откатить ход
`/export`	Выгрузить переписку в файл
`/stats`	Токены и расход за сессию
`/update`	Проверить обновление и поставить

Разрешения

По умолчанию агент спрашивает перед запуском команд и записью файлов — режим виден внизу окна и переключается Shift + Tab. Тонкая настройка (что разрешено без вопроса, что запрещено совсем) — /permissions; правила сохраняются в настройках проекта, так что команда из вашего Makefile спрашивается один раз.

Инструменты и MCP

Агент умеет подключать внешние инструменты и данные по MCP:

zq mcp add <имя> <команда-или-URL> [аргументы…]   # добавить сервер
zq mcp list                                       # что подключено
zq mcp remove <имя>

Внутри сессии состояние серверов показывает /mcp, инструменты — /tools.

Редакторы

VS Code — расширение-компаньон: агент видит открытые файлы и выделение.
Zed — расширение из репозитория форка.
JetBrains — через ACP-мост.

Каналы: агент в мессенджере

zq channel поднимает агента как бота — задачи ставятся из мессенджера. Готовые каналы: Telegram, GitHub, GitLab, DingTalk, Feishu, WeCom, WeChat, QQ-бот. Список и настройка — zq channel --help.

Свой раннер: код на вашей машине, управление из чата

Как Remote Control у Claude Code: агент работает на вашем сервере или ноутбуке, а вести сессию можно из чата — с телефона, из другого места. Зайдите в папку проекта и запустите:

zq remote

Первый раз попросит войти через браузер (или возьмёт сохранённый ключ), затем поднимет daemon на этой машине (только loopback, входящих портов не нужно), сам подключится исходящим соединением к платформе и напечатает ссылку вида zubriq.by/sandbox/<id> — откройте её в чате: лента, разрешения на команды, диффы — как у обычной сессии, только файлы остаются у вас. Работает за NAT. Ctrl+C — остановить. Подробно: Свой раннер.

Агент в чате, без терминала

Тот же агент есть в zubriq.by/chat — раздел «Код»: выбираете репозиторий на git.artcloud.by, ставите задачу, а агент работает в изолированном окружении и присылает ветку. Подробно — Сессии кода в чате.

Если что-то не так

zq: command not found после установки — откройте новый терминал (PATH прописывается в rc-файл) или добавьте ~/.zubriq/zubriq-code/bin в PATH вручную.
На минимальных Linux не стартует встроенный Node — не хватает libatomic.so.1; установщик пытается поставить пакет libatomic1 сам.
Ответ 403 key not allowed to access model — ключ выпущен на уровень без этой модели; проверьте уровень ключа в кабинете или выберите zubr-coder.