ZCode:Z.ai 开源的 AI 编程工作台,桌面/Web/CLI 三端覆盖

ZCode:Z.ai 开源的 AI 编程工作台,桌面/Web/CLI 三端覆盖

ZCode(zai-org/ZCode)是 Z.ai 于 2026 年开源的 AI 编程工作台,采用 TypeScript 编写,以 Apache-2.0 许可证发布。它提供三种使用入口:Electron 桌面应用、Web 界面 和 终端 Agent CLI,一套后端服务打通所有入口,开发者可以根据工作习惯自由选择。

目前 ZCode 在 GitHub 上已获得 3,600+ 星标,最近更新于 2026 年 9 月 21 日。


核心功能

1. 三端统一入口

ZCode 最大的亮点是同一套 Agent 运行时可以同时跑在三个入口上:

入口方式适用场景
Desktoppnpm dev:desktop,Electron 应用日常开发、重度编码
Webpnpm dev:web,浏览器访问远程协作、无桌面环境
CLI / TUIzcode 或 zcode --web终端党、SSH 远程操作

三种入口共享同一个后端服务和 Agent 运行时,工作区、会话历史、配置完全同步。

2. 终端 TUI 与 Agent 命令行

在终端中直接运行 zcode 即可进入 TUI(终端用户界面),无需打开浏览器。对于习惯命令行操作的开发者来说,这是最轻量级的接入方式。Agent CLI 同时也为 Desktop 和 Web 提供后端运行时支持。

3. SSH / WSL 远程开发支持

ZCode 支持通过 SSH 或 WSL 连接到远程项目,开发态资源取自本地构建产物,经 SFTP 上传到远程执行,不依赖外部 CDN。这对需要在远程服务器或容器环境中工作的开发者非常友好。

4. 完整的桌面打包能力

可以通过 pnpm bundle:desktop 构建各平台的桌面安装包,支持 macOS arm64/x64、Windows x64、Linux x64 等目标。构建脚本自动生成 DMG / MSI / AppImage 等格式,开箱即用。

5. 规范的 UI 设计系统

ZCode 内置了一套完整的 Design System(见 DESIGN.md),定义了从字体尺度(text-ui-*)、语义化颜色变量到主题模式的完整规范,界面风格冷静、信息密度高,适合长时间编码场景。


适用人群

  • 追求多端统一的开发者:希望桌面、Web、终端三端体验一致,随时切换工作入口。
  • 远程/服务器开发者:需要 SSH 或 WSL 远程连接进行编码,ZCode 的远程模式正好匹配。
  • 终端爱好者:喜欢 TUI 操作,不想频繁切换图形界面。
  • Z.ai 生态用户:如果你已经在用 Z.ai 的其他产品(如 Z.ai Chat),ZCode 可以无缝衔接。

与同类工具对比

维度ZCodeCursorWindsurfContinue
开源✅ Apache-2.0❌ 闭源❌ 闭源✅ MIT
三端支持✅ Desktop + Web + CLI✅ Desktop✅ Desktop✅ VS Code 插件
远程开发✅ SSH/WSL❌❌部分支持
Agent CLI✅ 独立 CLI❌❌❌
自托管✅ 可本地部署❌❌✅
后端架构monorepo + Electron + React闭源闭源VS Code 生态

ZCode 在开源程度和多端覆盖上优势明显,尤其是 SSH/WSL 远程开发支持,在同类工具中较为少见。


如何使用

环境准备

ZCode 要求以下基础环境(版本以仓库 mise.toml 为准):

  • Git
  • Node.js 24.14.0+
  • pnpm 10.33.2+

安装与启动

# 克隆仓库
git clone https://github.com/zai-org/ZCode.git
cd ZCode

# 初始化依赖(安装 workspace 依赖 + 准备桌面资源 + 构建)
pnpm bootstrap

# 启动桌面应用
pnpm dev:desktop

# 或使用测试数据目录
ZCODE_DATA_BASE_DIR="$HOME/.zcode-dev-home" pnpm dev:desktop:test

# 启动 Web 模式
pnpm dev:web
# 访问 http://localhost:5173

CLI 模式

# 直接进入 TUI
zcode

# 启动 Web 界面
zcode --web

# 指定项目和端口
zcode --web --workspace /path/to/project --port 3030 --no-open

构建发行包

# 桌面版
pnpm bundle:desktop -- --os mac --arch arm64

# 命令行发行包(TUI + Web + Agent)
pnpm build:zcode --base-url https://your-cdn.com/zcode/

总结

ZCode 是 Z.ai 在 AI 编程工具领域的一次重要开源尝试。它的核心竞争力在于三端统一的架构设计——无论是桌面端重度用户、Web 远程协作者还是终端极简主义者,都能找到适合自己的入口,且体验一致。加上对 SSH/WSL 远程开发的原生支持和开源自由,ZCode 在 2026 年的 AI 编程工具赛道中是一个值得关注的选手。

如果你已经熟悉 Z.ai 的生态,或者正在寻找一款可以自托管、支持远程开发的开源 AI 编程工作台,ZCode 非常值得一试。

推荐指数:⭐⭐⭐⭐☆(4/5)

扣分点:Node.js 24.x 版本要求较新,部分老旧系统可能暂时无法适配;Web 模式的文档相对精简,完整功能仍需探索。