还在为不同场景切换各类 AI 编程工具而头疼吗?上线不到一个月狂揽 7700+ 星的 ZCode 将桌面客户端、浏览器 Web 界面与轻量终端 Agent 深度融合,为开发者打造了一体化的多模态编程环境。
它是什么
ZCode 是由 Z.ai 开源的 AI 编码智能体运行平台与工作台。项目基于 TypeScript 开发,涵盖了客户端、后端服务、共享 UI 以及核心 Agent CLI 运行时源码。它既支持通过 Electron 桌面端提供完整开发体验,也支持通过 Web 界面或纯终端 TUI 进行交互。此外,ZCode 还内置了对 SSH/WSL 远程开发工作区的原生支持。
为什么值得关注
- 多端形态统一:支持 Electron 桌面端、无桌面依赖的 Web 界面,以及纯终端 TUI 交互,适应各类服务器与本地环境。
- 开箱即用的远程开发:针对 SSH 和 WSL 场景提供无缝的远程工作区支持与资源同步机制。
- 高度模块化的 Agent 架构:基于 Monorepo 构建,Agent CLI 与运行时源码完全开源解耦,方便二次开发与扩展。
- 开源协议友好:采用 Apache-2.0 许可证,代码透明且便于企业与个人深度集成。
安装与使用步骤
- 环境准备:确保本地安装了 Git、Node.js 24.14.0 和 pnpm 10.33.2。
README:安装与使用说明 - 克隆仓库后在根目录执行初始化:
pnpm bootstrap(如需远程资源支持可执行pnpm bootstrap:with-remote)。 发布页:版本记录 - 启动桌面端开发模式:
pnpm dev:desktop(或测试环境pnpm dev:desktop:test)。 提交记录:项目活跃度 - 若进行 Web/后端开发,可执行:
pnpm dev:web(默认访问前端localhost:5173与后端localhost:3030)。 - 使用命令行版运行时,通过
zcode启动 TUI 模式,或执行zcode --web启动浏览器界面。
注意事项
- 运行与构建对环境版本要求较严,需要 Node.js 24.14.0 和 pnpm 10.33.2,建议配合 mise 等版本管理工具使用。
- 远程功能(SSH/WSL)依赖本地 mock-cdn 资源准备,在连接远程项目前需要先执行
pnpm bootstrap:with-remote。 - 命令行构建命令
pnpm build:zcode仅产出发行包,不会自动软链覆盖系统PATH中的旧zcode指令,需手动检查路径。
项目数据
⭐ 7766 星(创建 23.2 天,平均约 335 星/天;核实期间 0.2h 内 +0),许可证 Apache-2.0,语言 TypeScript,主页 zcode.z.ai
