Перейти к содержимому
ZuBrIQ · Docs

ZubrCode — кодинг-агент

ZubrCode (zubrcode) — кодинг-агент: правит код в вашем репозитории, запускает команды и тесты, объясняет чужой код. Модели — на платформе ZuBrIQ: по умолчанию Zubr Pro (zubr-coder) — он работает у внешнего провайдера. Если код не должен покидать РБ, выберите zubr (Zubr Local) — он на наших GPU в Минске. Телеметрия наружу не уходит. Основа — opencode.

ZubrCode 2.x — текущая и единственная версия: сервер, чат и облачные раннеры принимают только её. Обновляетесь с 1.x — см. Переход с 1.x.

Установка

Заголовок раздела «Установка»

Одна команда. Ставится один файл zubrcode — Node, npm и права администратора не нужны.

Окно терминала
# Linux, macOS, WSL
curl -fsSL https://zubriq.by/install.sh | sh
Окно терминала
# Windows (PowerShell)
irm https://zubriq.by/install.ps1 | iex

Скрипт сам выбирает сборку под систему и процессор (в том числе для виртуальных машин без AVX2), сверяет архив с контрольной суммой и кладёт zubrcode в ~/.local/bin (на Windows — zubrcode.exe в %LOCALAPPDATA%\Programs\zubrcode\bin, эту папку скрипт сам добавит в PATH). Проверьте:

Окно терминала
zubrcode --version

Если команда не найдена — добавьте ~/.local/bin в PATH (скрипт подскажет строку для ~/.profile) и откройте новый терминал. В cmd.exe вместо PowerShell: powershell -c "irm https://zubriq.by/install.ps1 | iex".

Через Homebrew

Заголовок раздела «Через Homebrew»

На macOS (Apple Silicon) и Linux x64 ZubrCode можно ставить из нашего Homebrew-тапа:

Окно терминала
brew tap zubriq/tap https://gitlab.com/artcloud/zubriq/homebrew-tap.git
brew install zubriq/tap/zubrcode

Указывайте полное имя zubriq/tap/zubrcode: Homebrew 7 не ставит короткое имя из стороннего тапа без brew trust. Приложение для Mac — brew install --cask zubriq/tap/zubrcode-desktop (ZubrCode Desktop). Обновление — brew upgrade zubriq/tap/zubrcode (Обновление).

Вход

Заголовок раздела «Вход»
Окно терминала
zubrcode auth login zubriq

Выберите «Войти через zubriq.by»: команда покажет ссылку на страницу подтверждения zubriq.by — та же учётка, что в чате. Открыть её можно на любом устройстве, в том числе с телефона, если вы работаете на сервере по SSH. После подтверждения ключ выпустится и сохранится сам.

Второй способ — готовый ключ из кабинета:

Окно терминала
export ZUBRIQ_API_KEY=sk-zq-…   # ключ: zubriq.by/chat → Настройки → API-ключи
zubrcode

Ключ действует на те же модели, что и API платформы: по умолчанию агент работает на Zubr Pro — zubr-coder, у внешнего провайдера, — сменить можно командой /models, например на zubr (Zubr Local), чтобы код не покидал РБ. Список моделей приходит с платформы — там только те, что умеют работать агентом. Расход списывается с кошелька организации, как и любой запрос по ключу.

Первый запуск

Заголовок раздела «Первый запуск»
  • Запускайте zubrcode в каталоге проекта — агент работает с ним как с рабочей папкой.
  • Пишите задачу словами: «почини падающий тест», «добавь эндпоинт», «объясни, что делает этот модуль». Правки файлов агент показывает диффом, команды оболочки — спрашивает перед запуском.
  • Shift+Tab — переключить агента (build — правит код, plan — только планирует), Ctrl+P — все команды, Esc — прервать ход.
  • Без окна, одной командой: zubrcode run "почини падающий тест". Спрашивать разрешения здесь не у кого, поэтому для скриптов и CI заранее разрешите команды в opencode.json или запускайте с --auto (см. Разрешения).

Правила проекта — стек, соглашения, что нельзя трогать — лежат в AGENTS.md в корне проекта: ZubrCode читает его и дополнительно QWEN.md, так что проект, размеченный для zq, работает сразу. /init создаёт AGENTS.md по содержимому репозитория. Подробнее — Инструкции.

Где работать

Заголовок раздела «Где работать»
  • В терминале (TUI) — основной режим: сессии, слеш-команды, клавиши.
  • CLI — без интерфейса, одной командой: для скриптов и CI (run, session, stats, serve и другие).
  • ZubrCode Desktop — то же в настольном приложении.
  • Сессии кода в чате — раздел «Код» на zubriq.by: агент работает с репозиторием в изолированном окружении платформы.
  • Свой раннер — агент на вашей машине, управление из чата (zubrcode remote).
  • В редакторах — VS Code и форки расширением, JetBrains и Zed через Agent Client Protocol.
  • В CI — агент в любом CI: установка скриптом, ключ секретом, run --standalone; для GitHub Actions есть готовый workflow.
  • В GitLab CI — ревью merge request’ов и разбор упавших пайплайнов готовыми шаблонами.

Агент и настройка

Заголовок раздела «Агент и настройка»