ZCode

ZCode 是什么

ZCode 是 Z.ai 推出的 AI 编程工作台，官方定位为「coding agent harness」——一套强大、智能且可扩展的编程 Agent 运行框架。它同时提供桌面应用、浏览器界面和终端 Agent 三种使用形态，本仓库包含客户端、后端服务、共享 UI，以及 Agent CLI 与运行时的完整源码。

项目采用 TypeScript 编写，基于 Apache-2.0 许可开源，当前在 GitHub 上已获得约 7.9k Star。

核心能力

• 多端统一：桌面版基于 Electron，Web 版提供浏览器界面，命令行版通过 zcode 命令进入 TUI 或启动 Web 服务，三者共享同一套 Agent 运行时。
• 远程开发：支持 SSH / WSL 远程工作区，开发态资源经 SFTP 上传到远程，无需访问 CDN。
• UI Plugin 扩展：提供插件安装更新、页面 API 与宿主联调入口，官方以 Excalidraw 画布协作作为示例。
• Provider 抽象：packages/provider 与 packages/provider-node 提供 Provider 公共能力与 Node 实现，便于接入不同模型服务。

仓库结构概览

快速上手

环境要求以仓库根目录的 mise.toml 为准，需要 Git、Node.js 24.14.0 与 pnpm 10.33.2。

# 初始化依赖与本地运行资源
pnpm bootstrap

# 启动桌面版开发模式
pnpm dev:desktop

# 启动 Web 开发模式（前端 5173，后端 3030）
pnpm dev:web

命令行发行包统一使用 zcode 启动：无参数进入 TUI，第一个参数为 --web 时启动 Web 界面。

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

打包与发行

• 桌面版：pnpm bundle:desktop，默认目标为 macOS arm64，输出到 packages/desktop/dist/。
• 命令行版：pnpm build:zcode，需先设置下载根地址 ZCODE_DIST_BASE_URL，产物包含运行包、校验摘要、latest.json 与 install.sh。

本地构建的 macOS 应用未签名，首次打开若被拦截，可执行：

sudo xattr -rd com.apple.quarantine /Applications/ZCode.app

适合谁使用

如果你希望在本地、远程服务器或容器中统一使用 AI 编程助手，或者想研究 AI 编程 Agent 的运行时、RPC 与 Provider 架构，ZCode 提供了完整且可扩展的开源实现。项目提供中文文档与飞书社群，国内开发者上手较为顺畅。