ZCode: рабочее место для ИИ-агента в терминале, браузере и на компьютере

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

Три интерфейса ZCode и один репозиторий

Авторы называют ZCode рабочим местом для ИИ-программирования. В репозитории лежат клиентские приложения, сервер, общие компоненты интерфейса, командная строка агента и код, который отвечает за его запуск. README объясняет, как разрабатывать и собирать эти части, но почти не показывает повседневный диалог с агентом.

Настольная версия запускается через Electron — платформу для приложений с веб-интерфейсом. Браузерная версия состоит из страницы и локального сервера: страница показывает интерфейс, а сервер обрабатывает запросы. Терминальная версия предлагает TUI — текстовый интерфейс внутри терминала. Во всех случаях речь идёт о способах работать с ZCode, а не о трёх независимых инструментах.

В репозитории есть Agent CLI — командная строка агента — и его среда выполнения. Есть также общие компоненты для интерфейсов и код для связи клиента с агентом. Если вы выбираете среди ИИ-агентов, важное различие такое: ZCode — самостоятельный проект для работы с кодом, а не описанный в README навык или MCP-сервер. Инструкций по подключению его как дополнения к Claude или ChatGPT здесь нет.

Разработчикам доступны настройки рабочего каталога, адресов сервисов и файла конфигурации провайдера. README не перечисляет поддерживаемые модели и не даёт пошаговой настройки конкретного провайдера. Поэтому по одному этому документу нельзя обещать, что ваш аккаунт в Claude, ChatGPT или другом сервисе подключится к ZCode без дополнительных действий.

Кому пригодится ZCode, а кому достаточно текущего агента

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

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

Третий сценарий — ваш проект находится в удалённой рабочей среде по SSH или WSL. README описывает подготовку ресурсов для подключения к такому проекту: файлы берутся из локальных сборочных результатов и передаются в удалённую среду по SFTP. Это инструкция для разработки удалённых функций, а не обещание, что любое удалённое окружение заработает без настройки.

Если вам нужен лишь навык для Claude и других агентов или MCP-сервер для уже привычного чата, ZCode вам, вероятно, не нужен. Если вы довольны Claude Code и не планируете менять рабочий интерфейс или изучать исходники другого агента, README не даёт причины переходить ради отдельной функции. Проект полезнее тем, кто готов устанавливать зависимости, собирать приложение и разбираться с конфигурацией.

Как подготовить исходники и запустить интерфейс

Для работы с репозиторием README требует Git, Node.js 24.14.0 и pnpm 10.33.2. Версии сверяются с файлом mise.toml. Заберите исходники со страницы ZCode на GitHub и выполняйте приведённые команды в корне репозитория. Отдельно скачивать Agent CLI не нужно: он входит в каталог apps/zcode-cli/ и не оформлен как Git submodule.

Основная команда подготовки устанавливает зависимости рабочего пространства, готовит локальные ресурсы настольной версии и выполняет начальную сборку:

pnpm bootstrap

После этого для разработки настольного приложения README предлагает следующие варианты. Обычный запуск использует конфигурацию производственного сервиса; вариант :test выбирает тестовую среду. Это разные настройки запуска, поэтому не подменяйте одну команду другой без необходимости.

pnpm dev:desktop
pnpm dev:desktop:test

Если работаете над веб-интерфейсом или сервером, запускайте их вместе. По умолчанию страница откроется через сервер разработки на http://localhost:5173, а серверная часть слушает http://localhost:3030. Для выбора каталога проекта в macOS или Linux README приводит отдельный вариант команды:

pnpm dev:web
ZCODE_SERVER_WORKSPACE=/path/to/project pnpm dev:web

Здесь /path/to/project — место для пути к вашему проекту, а не готовый каталог. Запросы веб-страницы к /ws и большей части /api направляются локальному серверу. Исключение в README — /api/v1/oauth/token: этот запрос направляется на настроенный продуктовый сервис. Если рассчитываете на полностью автономную работу браузерного интерфейса, проверьте нужную вам схему входа и конфигурацию до начала работы.

Для удалённых проектов по SSH или WSL порядок другой. Сначала подготовьте удалённые ресурсы, затем запускайте настольную разработку и при подключении проекта выбирайте вариант «локальная загрузка с последующей отправкой». README указывает, что в этом режиме ресурсы передаются по SFTP и не загружаются с CDN.

pnpm bootstrap:with-remote
pnpm dev:desktop

Что именно вводить в терминале: примеры из README

README приводит примеры команд запуска, а не готовые текстовые запросы агенту. Поэтому по нему можно показать, как открыть ZCode для проекта, но нельзя добросовестно пообещать конкретный ответ агента на запрос вроде «исправь ошибку». Ниже — действия с предсказуемым результатом, которые описаны авторами.

Если у вас уже собрана и доступна команда zcode из командного дистрибутива, ввод без аргументов открывает текстовый интерфейс в терминале. Ключ --web вместо него запускает браузерный режим. Оба режима работают на вашем компьютере без Electron; сборка дистрибутива описана отдельно в README.

zcode
zcode --web

Для браузерной работы с конкретным каталогом авторы дают команду с рабочей папкой и портом. Флаг --no-open запрещает автоматически открывать браузер: после запуска вы сами переходите по адресу, который напечатает терминал. Остановить сервер можно сочетанием Ctrl+C.

zcode --web --workspace /path/to/project --port 3030 --no-open

Ещё один пример подходит тем, кто меняет код самого агента. Команда запускает исходный CLI напрямую и не проходит через переключение между терминальным и браузерным режимами готового дистрибутива. Для разработки браузерной части README вместо неё направляет к pnpm dev:web.

pnpm --filter @zcode/cli dev

Сборка командного дистрибутива — отдельный шаг, а не результат pnpm bootstrap. Перед pnpm build:zcode нужно задать ZCODE_DIST_BASE_URL или передать --base-url; адрес https://downloads.example.com/zcode/ в README указан как заглушка, которую заменяют реальным адресом размещения файлов. Сам pnpm build:zcode создаёт архивы в dist/zcode/, но не заменяет команду zcode, уже найденную через PATH.

Доступ к проекту, ограничения и состояние репозитория

ZCode работает с рабочей папкой проекта, а его сервер принимает запросы от интерфейса. При запуске вы доверяете инструменту доступ к выбранным файлам; если собираетесь дать агенту проект с секретами, сначала разберитесь, какие каталоги и настройки вы ему передаёте. Мы не проверяли код и не называем его безопасным.

Веб-режим командного дистрибутива по умолчанию слушает 127.0.0.1 и не включает токен доступа. При прослушивании адреса вне локального компьютера README описывает автоматическое создание токена и ссылку с ним. Токен можно задать через --token или отключить через --no-token; перед открытием доступа из сети проверьте эти параметры. Для прямого запуска серверного HTTP-интерфейса предусмотрена переменная ZCODE_SERVER_AUTH_TOKEN.

Лицензия репозитория — Apache-2.0, основной язык — TypeScript. На момент обзора у проекта 7596 звёзд и 2312 форков; он создан 20 сентября 2026 года, последний коммит в карточке датирован 29 сентября 2026 года. Проекту по этим датам меньше двух недель, поэтому число звёзд не стоит принимать за свидетельство длительной эксплуатации.

Для сборки нужны указанные версии Node.js и pnpm; для настольной сборки под целевую платформу README также предупреждает о необходимости соответствующих инструментов и настроек подписи. Обязательный API-ключ или подписка в README не указаны, но приведены конфигурация провайдера и обращение к продуктовому сервису для OAuth-запроса. Если вам нужен готовый инструмент без сборки и выяснения условий подключения модели, сначала уточните эти вопросы в репозитории.

Источник: репозиторий zai-org/ZCode на GitHub.