给 ZCode 一句话：GLM-5.2 三分钟写完一个会下五子棋的 AI

当 Claude Code 被装进一个可视化桌面，再喂上智谱最新的 GLM-5.2，会发生什么？我把官网那个"一句话做出五子棋人机对战"的演示复刻了一遍，顺便把这台"可视化 Agent"拆给你看。

🙋蹲队友拼智谱 Coding Plan！

🧩国内顶流编程大模型，20+主流工具全适配，性价比拉满，

👉立即参与「拼好模」：https://www.bigmodel.cn/glm-coding?ic=TWUO6H4KLG

Zcode 官方：https：//zcode.z.ai/cn

---

一、为什么我又折腾起一个新编程工具

先说结论：我不是来吹的，主要是体验一下新工具。

过去半年，我的 AI 编程主力是命令行那一套——Claude Code、Codex、Gemini CLI。它们很强，真的强。但每次用我都像在跟一个黑盒对暗号：

• 门槛高：纯文字交互，一句提示词写不好，它就跑偏给你看。上下文一长，我自己都忘了刚才让它干嘛。

• 黑盒，且不可视：它啪啪改了一堆文件，我只能在终端里看一串 diff，到底动了哪、为什么动，得自己拼。

• 多 Agent 切换累：一个项目里我想同时跑"写代码的""写测试的""查文档的"，命令行里切来切去，心累。

• 行为不可回滚：它手一抖删错文件，我得去翻 git 找回来。

我想要的东西其实很简单——让我能"看着"Agent 干活，能随时插话、随时回滚、手机上也能接，而不是盯着黑乎乎的终端猜它在想啥。

然后智谱 6 月连放了两枪：GLM-5.2（号称智谱迄今最强开源编程模型，真正可用的 1M 上下文）+ ZCode 3.0（全面切到自研 Agent 内核，围绕 GLM-5.2 深度联调）。圈子里有句评价很戳我："ZCode 就是把 Claude Code / Codex 彻底桌面化、可视化了。"

这话要是真的，那正好治我的病。于是我打开官网，看到首页挂着一个活生生的演示：一句话让 ZCode 做个五子棋人机对战，它 3 分钟写完 733 行代码，还能自己跑通。我决定就照着这个 demo，亲手复刻一遍，看看这台"可视化 Agent"到底几分真。

---

二、先搞清楚：ZCode 到底是什么

很多人第一反应："这不又是一个 Cursor / Copilot 吗？"

不是。 这是最容易误解的地方，值得花两分钟掰扯清楚。

类型	代表	你在干嘛	AI 在干嘛
传统 IDE	VS Code	手写代码	不参与
代码补全	Copilot、Tab 补全	手写，它补字	补全片段
桌面 AI IDE	Cursor	半自动，你主导	按你的指令改
CLI Agent	Claude Code、Codex	下指令	自主跑，但黑盒
ADE	ZCode	下指令 + 盯着 + 随时插话	自主跑全程，且过程全可视、可回滚

ZCode 官方给自己的定位叫 ADE（Agentic Development Environment，智能体开发环境）。核心理念一句话：让 AI Agent 当开发的主角，你用自然语言指挥它。 它不以"手写代码"为核心，而是以"让 Agent 端到端把活干完"为核心。

它面向的是一个新概念：Long Horizon Task（长程任务）。意思是——别让 Agent 只干"改个函数"这种一锤子买卖，而是让它把"理解需求 → 拆计划 → 写代码 → 跑测试自验证 → Review 改动"这一整条链路，在同一个上下文里一口气走完，中间不用你频繁切换、喂上下文。

这件事的底气，一半来自自研的 ZCode Agent 内核（3.0 版全面切换），一半来自GLM-5.2——1M 无损长上下文，专门针对长程 Coding Agent 场景训练了几个月。

ZCode 官网： https：//zcode.z.ai/cn
文档： https：//zcode.z.ai/cn/docs/welcome

---

三、动手前先装好：下载、注册、绑定 Coding Plan

讲再多概念，不如先把它跑起来。这一章手把手带你装好 ZCode、登录、绑定 GLM Coding Plan——三步搞定，后面就能直接用上 GLM-5.2。

3.1 第一步：下载安装

打开官网 全部下载 页，按系统挑安装包（当前版本 v3.1.5）：

平台	安装包
macOS（Apple 芯片）	.dmg
macOS（Intel 芯片）	.dmg
Windows（64 位）	.exe
Linux	Beta（x64 / ARM64 的 .deb 和 .AppImage 都有,需进内测群拿包）

macOS / Windows 双击安装就行，跟装普通软件没区别。Linux 还是 Beta，得先加官方内测群（官网首页有飞书群入口）才能拿到包，主力 Linux 的同学留意一下。

小提示：ZCode 桌面端是 Electron 套壳，内存占用不算轻，老机器建议先关掉别的吃内存大户再开。

3.2 第二步：注册 / 登录

Zcode账号可以电子邮箱注册（这里是Zcode账号，和质谱GLM账号不是一个）

装好打开，用 Z.ai 或 BigModel 账号登录（智谱体系内账号通用）。没有就手机号注册一个，一分钟的事。

3.3 第三步：绑定 GLM Coding Plan（关键一步）

这步决定你能不能用上 GLM-5.2。进 设置 → API Key 配置（或「连接 GLM Coding Plan」入口），绑定你已开通 Coding Plan 的 BigModel / Z.ai 账号。绑定后 ZCode 就能直接调用 GLM-5.2 等内置模型——不用自己去申请 API Key、不用额外折腾，开箱即用。

ZCode 里还有 Coding Plan 专属权益

1. 订阅用户专享 1.5 倍配额 已开通 GLM Coding Plan 编程套餐的用户，登录 ZCode 即可享受 150% 使用额度，套餐更耐用。平台还支持用量可视化，你随时能在「使用统计」里看到 Coding Plan 额度、模型消耗和工具调用明细——后面我们跑五子棋到底烧了多少 token，就是在这儿看。

2. 新用户 5 天免费体验 首次使用 ZCode 可享 5 天免费权益，每日合计 500 万免费 Token（GLM-5.2 300 万 + GLM-5-turbo 200 万），产品开箱即用，无需额外配置。换句话说，哪怕你先不订阅，这 5 天也够把官网那个五子棋 demo 照着跑好几遍，先体验再决定要不要掏钱。

四、动手前，先认识它的三件套：Agent / Goal / Bot

打开 ZCode，你会被一堆概念砸中。别慌，真正常用的就三件套，搞懂这三个，剩下的都是它们的延伸。

3.1 Agent —— 干活的那个"人"

Agent 是执行体。你给它一句话，它就会自己去：读文件、跑终端命令、看 Git 状态、改代码、装依赖、起预览。官网那个五子棋 demo，Agent 就是这样干的：

你："创建一个五子棋人机对战"
Agent：让我先看看当前目录……（跑 pwd / git status）
Agent：哦，空项目，那我从零写。
Agent：写 index.html + app.js + styles.css（733 行）
Agent：我自检一下……（跑 node --check ai.js）通过。
Agent：咦，页面里引用了在线字体，我把它去掉，这样离线也能跑。
Agent：完成。

重点在最后两步：它不是写完就撂挑子，而是会自验证（node --check），甚至会自我优化（主动去掉外部依赖让游戏离线可跑）。这正是"长程任务"该有的样子——它对"完成"的标准，比你以为的更高。

3.2 Goal —— 长目标的"项目经理"

Agent 会干活，但活儿一多就容易乱。Goal 就是来治这个的。

你给一个大目标（比如"做个五子棋人机对战"），ZCode 会用 Goal 模式把它拆成若干子任务，每个子任务带状态（待办/进行中/完成），逐个推进、逐个验证。官网那个五子棋，就被拆成了 5 步，Goal 面板显示 5/5 全部完成、核心生成约 2 分钟、消耗 89K tokens：

Goal： 五子棋人机对战 — 使用启发式 AI 算法实现电脑落子   5/5 · 2m · 89K tokens
  ✓ 初始化棋盘、棋子渲染和 15×15 网格布局
  ✓ 实现玩家落子交互和胜负判定逻辑
  ✓ 接入启发式 AI 算法实现电脑自动落子
  ✓ 适配移动端棋盘缩放和横竖屏布局
  ✓ 补一版规则说明、重开入口和空状态引导

你随时能看到"它干到哪一步了、还剩几步、整体进度多少"。Agent 行为可视、可追踪，这就是它跟命令行黑盒最大的区别。

3.3 Bot Channel + Remote —— 手机/飞书/微信远程唤起

这是我觉得最"未来"的功能。ZCode 接了飞书、微信 Bot 和手机端 Remote——你出门在外，@一下飞书机器人，或者掏出手机，就能远程让 Agent 干活、看进度、补指令。

官方管这叫 Vibeworking（氛围办公）。翻译成人话：你能在地铁上让电脑里的 Agent 帮你改 bug，回家直接看结果。 对我这种内容创作者，出差路上 @ 它写个脚本抓数据，很实用。

三件套之外，ZCode 还有 子 智能体 （Subagents）、 MCP 服务器、Skill、Plugin、安全操作确认、Git 分支图谱等。这些进阶玩法本文先不展开，先把主线跑通。

---

五、30 分钟实战：一句话复刻五子棋人机对战

概念讲完，开始真刀真枪。我把官网那个五子棋 demo，用同样的提示词，在自己机器上复刻一遍，记录全过程。

4.0 准备：提示词就一句话

很多人觉得用 AI 编程工具要写很长的提示词。ZCode 这个 demo 厉害就厉害在——一句话就够：

创建一个智能五子棋游戏，让玩家与能够进行策略性落子并准确判断胜负的算法对战。

就这一句。注意它里面其实埋了三个验收标准，这也是为什么它生成的 AI 不平庸：

1. "策略性落子" → 不是随机下，要有评估

2. "准确判断胜负" → 四个方向连五判定必须对

3. "对战" → 人机回合流程要闭环

💡 提示词技巧①：哪怕一句话，也要把"验收标准"塞进去。ZCode 会把这些当成硬约束去实现，而不是随便糊一个能跑的。

4.1 它是怎么动手的

下面是官方 demo 里 Agent 的真实执行流程，我原样还原给你看——这就是一台长程 Agent 该有的工作姿态：

第一步：先摸底，不盲目写

Agent 没有上来就写代码，而是先探索环境：

已运行  pwd
已搜索  List in ~/ryan/gomoku-ai   ← 先看目录里有什么
已运行  git status --short         ← 确认是不是空项目

发现是空仓库，于是判断："没有现成应用，我从零做一个自包含实现。"——它会先理解现状，再决定策略，而不是无脑输出。

第二步：从零生成三件套

已写入  index.html   （+106）
已写入  ai.js       （+216）   ← 核心逻辑在这
已写入  styles.css   （+414）
                      +846 行

它生成的 ai.js 里，那个 AI 不是随机落子，而是启发式评分：搜索附近候选点 → 给自己的进攻棋型打分 → 给阻挡你的防守点打分 → 叠加中心区域偏好 → 选最高分那一步。下面这个评分思路是它实际采用的结构（简化示意）：

// 启发式落子评分（结构示意，非完整代码）
function evaluateMove（point， board） {
  const attackScore  = scorePattern（point， board， AI）；   // 我下这步能形成的进攻棋型分
  const defendScore  = scorePattern（point， board， HUMAN）； // 我堵这步能挡掉你的多少分
  const centerBias   = CENTER_WEIGHT / （distToCenter（point） + 1）；
  return attackScore + defendScore * DEFEND_RATIO + centerBias；
}
// 选所有候选点里分数最高的一步

这就是为什么官网敢说"策略性落子"——它真的在做攻防评估，而不是 rand（）。

第三步：自验证

已运行  node --check ai.js   ← 自己跑语法检查

无报错，通过。它写完会自己验，这点很关键——意味着交付给你的代码至少是"能解析、没低级语法错"的。

第四步：自我优化

Agent 主动发现：index.html 里原来拉了一个在线字体。它判断："这会导致离线打不开"，于是自己把字体依赖去掉，改成完全本地运行，直接双击 index.html 就能玩，不依赖网络。

💡 提示词技巧：让它"自包含、能离线跑"。我没明说，但 Agent 主动优化掉了外部依赖。这种"超额完成"，是长程 Agent 和"补全工具"的本质区别。

最终战绩：

指标	数值
耗时	约 3-5 分钟
生成代码	8 个文件，+649 行
拆解子任务	5 个，5/5 全部完成
Token 消耗	89K
自验证	node --check 通过
额外优化	主动移除在线字体依赖

4.2 复刻效果：真能下，而且下得有来有回

我自己拿同一句提示词，在 ZCode 里跑了一遍，代码跑通了，且实测效果感觉很不错啊（我自己的五子棋水平不是很好，业务玩家来说绰绰有余了）

我中盘想用一个'双活三'套路设陷阱，它居然识破了，直接堵在关键点。几局下来互有胜负，这个水平的启发式 AI，对业余玩家已经够玩了。

---

六、让它干得更好的几个提示词技巧

复刻完，我总结了让 ZCode + GLM-5.2 出活更稳的 4 个技巧。这些是通用的，五子棋只是载体。

1. 一句话也要塞验收标准。 别只说"做个五子棋"，要说"能策略落子 + 准确判胜负"。ZCode 会把形容词当成硬约束。模糊输入 = 糊弄输出，这条在哪都成立。

2. 显式要求它自验证。 提示词里加一句"完成后用 node --check / npm test 自检，报错就修"。GLM-5.2 长上下文的好处在这里——它能把"改→验→再改"的循环放在一个上下文里闭环，不用你反复喂。

3. 让它拆成 Goal，而不是一坨。 复杂任务，开头加一句"先列出实现步骤，确认后再逐步执行"。你会得到那个 5/5 的子任务面板，每一步可追踪、可回滚——这是 ZCode 相对命令行最大的体验红利。

4. 给"完成定义"（Definition of Done）。 比如"完成后我要能双击 html 直接玩，不联网"。这一句逼出了 Agent 主动去掉在线字体依赖的"超额完成"。

附：可以参考的完整提示词

创建一个智能五子棋游戏，让玩家与能够进行策略性落子并准确判断胜负的算法对战。
要求：15×15 棋盘、四向连五判定并高亮、玩家执黑先手、AI 用启发式评分落子、
支持重开、适配移动端。完成后用 node --check 自检，并确保双击 index.html 离线可玩。
先列出实现步骤，确认后逐步执行。

---

七、说点实在的：它好在哪、坑在哪

体验了下来，优点缺点我都说一说，带 ⚠️ 的是我自己还没充分压测、可以自发体验验证的点，别照单全收。

好的地方

• 过程全可视、可回滚：Agent 改了啥、为啥改、终端跑了啥，全在面板里看得见，不满意一键撤销。这是它对命令行 Agent 最大的体验升级，治好了我的"黑盒焦虑"。

• 长任务一个上下文跑完：得益于 GLM-5.2 的 1M 上下文 + 自研 Agent 内核，五子棋这种"规划→编码→验证→优化"能在一个任务里闭环，不用我中途反复喂上下文。

• 安全操作确认：高危命令、删文件、高权限操作会先问你一句，不会偷偷搞破坏。

• GLM-5.2 开源（MIT）+ 真长上下文：模型下周开源、API 已上线，想自己部署或走 API 也行，不被锁死。

坑 / 待观察（⚠️ 需实测）

• ⚠️ 长任务稳定性需压测：官方 demo 是 3 分钟的小项目。换成几百个文件的真实工程，Agent 会不会中途跑偏、上下文会不会丢，我只测了玩具级，真实项目建议你自己压一遍。

• ⚠️ GLM-5.2 能力边界：有评论说"GLM-5 的技术报告不能自动证明 GLM-5.2 的最终能力"。官方说 SWE-Bench Pro 从 58.4 提到 62.1，但你自己的业务场景到底行不行，得拿你自己的代码测，别只信榜单。

• 生态成熟度 vs Claude Code：ZCode 还很新（3.0 刚全面切自研内核）。Plugin、MCP、社区模板的丰富度，短期跟 Claude Code 那套成熟生态比有差距。如果你重度依赖某套现成 MCP/Skill，先确认 ZCode 那边有没有。

• 客户端偏重 / 平台覆盖：桌面端是 Electron，内存占用不算轻；Linux 还是 Beta（得加内测群拿包），主力 Linux 的同学注意。

• 免费额度有时限：新用户 5 天免费（每日 500 万 token：GLM-5.2 三百万 + GLM-5-turbo 二百万）。长期用得开 GLM Coding Plan（订阅用户有 1.5 倍配额）。体验够，重度用要花钱。

---

八、踩坑记录（候选，实测后保留或替换）

坑1：一句提示词太短，偶尔拆解过粗。 官方 demo 一句话能成，是因为任务边界清晰。如果你的需求模糊（比如"做个好看的官网"），它拆的 Goal 可能不是你想要的。解法：先让它列步骤、你确认，再执行，别让它闷头跑。

坑2：移动端适配这种"软需求"，一轮不一定到位。 五子棋 demo 里"移动端棋盘缩放"那步是最容易返工的——审美和交互是主观的。解法：给具体约束（比如"棋盘最小 320px、横屏居中"），而不是"适配移动端"这种模糊词。

坑3：token 烧得比你以为的快。 长任务 + 长上下文 = token 消耗大。一个五子棋就 89K token，真实工程可能上百万。解法：勤看「使用统计」页，别等账单吓一跳。

---

九、写在最后

折腾完这一通，我对 ZCode 的判断是：它不是"又一个 Cursor"，而是一次把 CLI Agent "桌面化、可视化、可控化"的认真尝试。

CLI 时代的 AI 编程，强是强，但门槛高、黑盒、不可回滚，把一大批"会写需求、但不爱折腾命令行"的人挡在了门外。ZCode + GLM-5.2 干的事，是把那套强大的 Agent 能力，装进一个你能看得见、插得上话、随时能回滚的桌面环境里，再配上手机和飞书/微信远程——让"指挥 AI 干活"这件事，从极客专属变成普通人也能上手。

五子棋那个 demo 最打动我的，不是 3 分钟 733 行这个数字，而是 Agent 写完会自验证、还会主动优化掉外部依赖那种"对完成有更高标准"的姿态。这才是"长程 Agent"该有的样子，也是 GLM-5.2 那几个月专项训练的价值所在。

当然，它还很新，长任务稳定性、生态成熟度、Linux 覆盖这些坑都还在填。如果你是重度 Claude Code 用户，现在不一定要立刻全切；但如果你跟我一样受够了命令行黑盒、想要一个可视可控还支持远程的 Agent 环境，ZCode 值得你花一个下午认真试一下——新用户 5 天免费额度，够你把五子棋这个 demo 照着跑三遍还有找。

下载与文档： https：//zcode.z.ai/cn

最后给同样在折腾 AI 编程的朋友一句：别只盯着模型榜单，工具的"可控性"和"可视性"，往往比模型多两分聪明更影响你每天的工作体验。 ZCode 这次，至少把"可视可控"这件事，做明白了。

---