智谱 Z.ai 官方开源的 AI 编程工作台，桌面 + Web + 终端 Agent 三合一

Claude Code、Codex、Cursor 都很好用，但它们有两个共同点：国外的，而且不给你完整源码。

最近，国产大模型头部玩家智谱（Z.ai）做了一件不一样的事：把自家 coding agent 的整个工作台推上了 GitHub——桌面应用、浏览器界面、终端 Agent，三套形态，连同客户端、后端服务、共享 UI、Agent CLI 的全部源码，一个 monorepo 打包开源，Apache-2.0 协议。

它叫 ZCode。

一句话简介

ZCode 是智谱 Z.ai 官方的 AI 编程工作台，官方一句话定位写着："Z.ai's coding agent harness. Powerful, intelligent, extensible."（Z.ai 的编程 agent 底座：有力、智能、可扩展。）

它最特别的地方是三形态统一：

• 桌面应用：Electron 客户端，双击即用；
• 浏览器界面：zcode --web 起一个本地 Web 服务，任何设备开浏览器接入；
• 终端 Agent：无参数直接进 TUI 交互界面。

三条形态共用同一个 zcode 命令分流：无参进 TUI，--web 起 Web，其余参数交给 Agent CLI 处理。你可以在工位用桌面版、开会投屏用 Web 版、SSH 到服务器用 TUI——同一个后端，同一份会话体验。

核心亮点拆解

亮点 1：把全家桶真的全部开源了

很多开源项目只开源一个 CLI 壳。ZCode 的仓库结构是这样的：

一仓打尽，TypeScript 主力约 34.6M 字节代码。CLI 部分的设计尤其克制：运行时零生产依赖，参数解析和终端控制全用 Node 内置模块，构建产物 zcode.cjs 在任何装了 Node.js 24.14.0 的机器上直接跑；还留了一条 SEA（单文件可执行）的可选打包路径。

亮点 2：插件 + MCP + Hooks 三件套，对齐主流 agent 生态

从 apps/zcode-cli 的文档看，ZCode 不只是一个界面，它有完整的扩展体系：

• 插件系统：插件可以贡献 skills、自定义命令和 MCP server。内置官方插件里，browser-use（浏览器操作）、document-skills（文档技能）、skill-creator（造技能的技能）、zcode-guide 默认启用；ios-simulator、android-emulator 等重运行时插件按需开启；
• MCP 全支持：stdio / http / sse 三种 server 类型，CLI 内 /mcp list、/mcp connect 直接管理；
• Hooks 七种事件：SessionStart、UserPromptSubmit、PreToolUse、PermissionRequest、PostToolUse、PostToolUseFailure、Stop——能在提示词提交前拦截、工具执行前审批、回合结束时追加校验，自动化闭环的原料齐了。

仓库里还有个耐人寻味的细节：.agents/skills/ 目录内置了 architecture-governance（架构治理）、react-best-practices、agent-browser 等约 10 个技能，还有一个叫 dogfood 的——官方在用自己的产品开发自己。

亮点 3：远程开发 + 自托管 + 中文社群

两个对团队很关键的能力：

远程开发：SSH/WSL 直连远程项目，开发资源经 SFTP 上传到远程机器，不访问外部 CDN。你在本地敲代码，agent 在远程机器上跑，桌面/Web/命令行三种形态都能接。

自托管 + 令牌认证：

zcode --web --workspace /path/to/project --port 3030 --no-open
# 局域网访问
zcode --web --host 0.0.0.0

监听非本机地址时自动生成访问令牌（用终端输出的带令牌链接访问），也可 --token 指定、--no-token 关闭。数据全部留在自己机器上。

对国内开发者还有一个加分项：简体中文 README、飞书社群、Discord 三样齐全，文档读起来没有语言折损。

核心原理与架构差异

ZCode 的架构可以概括为一个运行时，三种壳：

底层是一个 Agent 运行时。apps/zcode-cli 包含 TUI、运行时与工具，可以单独作为终端 coding agent 打包发行——这就是为什么 zcode 命令能一个入口分流三种形态：桌面版是 Electron 壳，Web 版是浏览器壳，终端版是 TUI 壳，壳下面是同一套 Agent 与 RPC 协议。

通信走统一 RPC。packages/rpc 提供 RPC 框架，packages/client 是 Agent 客户端 SDK，Web 后端（默认端口 3030）通过 /ws WebSocket 和 /api 与前端通信。这意味着不管你从哪个壳进来，交互协议是同一套。

模型层是 Provider 抽象。 值得注意的一个事实修正：虽然大家都说 ZCode深度绑定智谱生态，但从仓库内置的 provider 图标看，它预置了智谱 GLM 之外的一长串供应商——Anthropic、OpenAI、DeepSeek、Moonshot Kimi、MiniMax、阿里云、小米 MiMo、xAI、OpenRouter 等。多模型支持是设计就绪的，不过官方主推的当然是自家 GLM，其他供应商的实际体验还需要你亲自验证。

安装与配置

先把门槛说清楚：ZCode 目前没有一行命令的安装脚本（安装脚本 install.sh 是你自建发行包时生成的），主流玩法是从源码构建：

# 环境要求：Git + Node.js 24.14.0 + pnpm 10.33.2（版本以仓库 mise.toml 为准）
git clone https://github.com/zai-org/ZCode.git
cd ZCode
pnpm bootstrap          # 装 workspace 依赖 + 准备桌面运行资源

# 桌面版
pnpm dev:desktop

# Web 版（前端 5173 + 后端 3030）
pnpm dev:web

想得到一个可分发的命令行发行包：

pnpm build:zcode --base-url https://downloads.example.com/zcode/
# 产物：dist/zcode/releases//zcode-.tar.gz + install.sh

本地调试可以解压直跑，不必上传：

node dist/zcode/debug/zcode/bin/zcode.mjs                    # 默认进 TUI
node dist/zcode/debug/zcode/bin/zcode.mjs --web \
  --workspace "$PWD" --port 3030 --no-open                   # 起 Web

macOS 本地构建未签名，首次打开被拦时按官方文档执行 sudo xattr -rd com.apple.quarantine /Applications/ZCode.app 放行。

团队落地建议

试点：选 1-2 个内部工具项目，用 zcode --web --workspace 在一台内网机器起服务，团队成员浏览器接入，零安装成本先体验。

限制：用 Hooks 里的 PreToolUse（工具执行前审批）+ PermissionRequest 给危险操作上闸，先收敛权限再放开效率。

规范：把团队的架构约定写进自定义技能和自定义命令（插件体系原生支持），配合内置的 architecture-governance 思路沉淀自己的工程规范。

推广：确认价值后自托管常态化——--host 0.0.0.0 + 自动令牌做局域网准入，数据不出内网，这一点对合规敏感团队是实打实的需求。

适用场景自查表

优缺点与避坑

优点：三形态统一是真差异点；monorepo 全开源（含 UI 和后端）；插件 + MCP + Hooks 扩展体系完整；中文文档 + 飞书社群对国内用户友好；Apache-2.0 商用友好。

不足与避坑：

1. 太新了。 仓库创建于 2026-09-20，最后一次代码推送停在 09-29（GitHub API 实测，约一周前），open issues 仅 11 个。
2. 构建门槛不低。 Node.js 24.14.0 + pnpm 10.33.2 是精确到小版本的硬要求（以 mise.toml 为准），版本不对直接卡在初始化；建议用 mise 或 nvm 对齐版本再动手；
3. 绑定智谱要辩证看。 多 provider 图标确实内置了，但官方主推 GLM，第三方模型的工具调用质量、上下文长度适配，README 没有给承诺，换模型前先小规模验证；
4. 对比对象都很能打。 Claude Code、Codex、Cursor 的生态和讨论度远在它之上，ZCode 当前的价值主张是国产生态 + 全开源 + 三形态，而不是全面替代。

最后说几句

尽管这个是国产的AI工作台，我还是要说点自己的看法。生态极新，与 Claude Code/Codex/Cursor 正面竞争但讨论度远不如；深度绑定 Z.ai/智谱生态，换其他模型供应商体验待验证；需 Node.js 24.14.0 + pnpm 10.33.2 较新版本；因此，个人认为它接下来还有很多的路要走。

GitHub 仓库：

github.com/zai-org/ZCode