📌 项目：zai-org/ZCode | 星数：6,290（2026-09-23） | 协议：Apache-2.0 | 语言：TypeScript | GitHub
一句话定位："一个仓库，三种入口——桌面、浏览器、终端，同一个AI编码Agent。" ZCode 是智谱 Z.ai 开源的 AI 编程工作台，把 TUI、Web、后端和 Agent 运行时组装成独立运行包，桌面端用 Electron，终端里用 zcode 命令。它不是单一形态的编码助手，而是"三端一核"的完整工作台。
和站内已有的 Open Code Review（专注代码审查）不同，ZCode 覆盖的是"写代码"全流程；和 Claude Code 自定义 Skill 相比，ZCode 自带后端服务和共享 UI，更像一个可自托管的完整产品。
ZCode 的仓库包含客户端、后端服务、共享 UI，以及 Agent CLI 与运行时源码。三个入口各自独立运行：
| 入口 | 用途 | 开发命令 |
|---|---|---|
| Desktop | Electron 桌面应用 | pnpm dev:desktop |
| Web / 命令行版 | 终端与浏览器工作台，组装为独立运行包 | pnpm dev:web |
| Agent CLI | 终端中使用 zcode，也为桌面和 Web 提供 Agent 运行时 | pnpm --filter @zcode/cli dev |
值得注意的是 Agent CLI 与运行时源码位于 apps/zcode-cli/，作为普通目录随仓库克隆，无需单独拉取或初始化 Git submodule——这个设计降低了上手门槛。
ZCode 对工具链版本要求明确：Node.js 24.14.0 + pnpm 10.33.2（以 mise.toml 为准），所有命令在仓库根目录执行。
# 一键初始化：安装依赖 + 准备桌面资源 + 构建
pnpm bootstrap
# 启动桌面版
pnpm dev:desktop
# 启动 Web 版（默认 http://localhost:5173 + 后端 3030）
pnpm dev:web初始化入口有多个可选：pnpm install（仅装依赖）、pnpm prepare:desktop-runtime（准备桌面运行资源）、pnpm prepare:remote-assets（单独准备远程资源）、pnpm bootstrap:with-remote（含远程资源+串行构建）。默认 bootstrap 跳过远程资源准备，适合本地桌面开发。
ZCode 支持连接远程项目（SSH/WSL）。流程是：先 pnpm bootstrap:with-remote 准备远程资源（mock-cdn），再 pnpm dev:desktop，连接远程项目时资源选择"本地下载后上传"。
开发态资源取自本地 packages/desktop/mock-cdn 和本地构建产物，经 SFTP 上传到远程，不访问 CDN——这对内网/离线环境友好。需要独立开发数据目录时，可设置 ZCODE_DATA_BASE_DIR 环境变量隔离数据。
和 kev 决策模型 这类轻量工具相比，ZCode 是重量级工作台：适合团队自托管统一的 AI 编码环境，而不是个人快速试玩。
| ✅ 优点 | ⚠️ 不足 |
|---|---|
| 智谱官方开源，品牌背书强 | 版本要求严格（Node 24.14.0+pnpm 10.33.2） |
| 桌面/Web/终端三端覆盖 | 依赖体积大，初始化耗时 |
| Apache-2.0协议，商用友好 | Electron桌面端资源占用高 |
| 自带后端服务，可自托管 | 项目新（2026-09-20创建），文档待完善 |
| 远程SSH/WSL工作流完善 | 需要自建后端，部署成本高于纯CLI工具 |
Cursor 是闭源 IDE、Claude Code 是闭源 CLI；ZCode 是智谱开源的完整工作台，包含桌面应用、Web 界面和终端 Agent 三端，且自带后端服务可自托管，Apache-2.0 协议可商用。
官方以 mise.toml 为准要求 Node.js 24.14.0 + pnpm 10.33.2。版本不符可能出现构建错误，建议用 mise 或 nvm 精确锁定版本。
可以。用 pnpm --filter @zcode/cli dev 只跑 Agent CLI，或用 pnpm dev:web 跑 Web+后端组合，无需构建 Electron 桌面包。