
一份可以照抄的 WorkBuddy 辅助部署实录 · 含 9 个真实踩坑、4 段可复制提示词、1 张安全清单
说明:文中所有机器名、域名、授权码、访问码都是占位符,请替换成你自己的。版本号与活动规则截至 2026 年 11 月 9 日,工具和平台更新很快,动手前以官方文档为准。
00 先看看最后能得到什么
一台 4 核 8G 的 Debian 云电脑,桌面上跑着 ZCode(智谱的 AI 编程 IDE);一个公网可访问的 3000 工作台,带访问码;以及一条最关键的通道——你对 AI 说一句话,它就能直接在那台机器上派活、装软件、查日志、存快照。
整个过程你本人只需要点三下:批准一次授权、登录一次 ZCode、输入一次访问码。其余都是 AI 在命令行里跑完的。
这不是概念演示,是我在一台真实免费机器上一步步跑通、并把每个坑都记下来的实录。下面按「你做什么 / 对 AI 说什么 / AI 做什么 / 怎么验收」四段来写,照着做即可。
01 先把三个容易混的概念对齐
| 名字 | 它到底是什么 | 常见误解 |
|---|---|---|
| InstaBox | 给 Agent 用的云电脑。免费档 1 台,4 核 8G、Debian、带桌面;只有 /data 持久,空闲 30 分钟自动暂停 | 以为暂停会丢文件和进程(不会,访问页面 / 发命令 / SSH 都会自动唤醒) |
| ZCode | 智谱的桌面版 AI 编程 IDE,能在图形界面里让 Agent 读写文件、跑命令 | 以为「模板预装了 Claude Code 和 Codex」就等于装了 ZCode(不是一回事,那两个是独立的命令行工具) |
| 3000 端口 | 一条网络通道,不等于网页 | 以为「我建了 3000 端口」就该有页面。必须有进程监听 3000,链接才不是空白 |
还有个常被问到的:官方模板确实预装了 Claude Code、Codex、Node,但它们是三套独立的东西,各自要单独登录,跟 ZCode 的账号不通用。
02 让 AI 接管,其实有三条路
| 路径 | 你要做的 | AI 能做的 | 适合谁 |
|---|---|---|---|
| A. 浏览器控制 | 在客户端设置里打开「浏览器控制」并装对应浏览器扩展 | 直接在你打开的网页里点按钮、填表单、截图 | 想看 AI 在网页里操作、或要操作某个后台 |
| B. Agent 授权 + 官方 CLI(推荐) | 点一次 Approve | 装 CLI、体检、装软件、起服务、发布端口、存快照,全部命令行完成 | 绝大多数人 |
| C. 完全不给权限 | 把 AI 写好的脚本整段粘进网页的 TERMINAL 标签回车 | 只负责写脚本 | 对授权有顾虑的人 |
重点说 B:很多人以为「让 AI 接管浏览器」是唯一办法,其实不是。InstaBox 官方 CLI 有一个专为无人值守 Agent 设计的授权模式,批准后 AI 本地保存凭证,之后用 instabox exec <机器名> -- <命令> 就能直接在云机器的 shell 里跑命令。比在网页里点鼠标更快、更稳、可复现。
而授权这一步 AI 替不了:平台要求账户所有者本人批准,AI 手上只有一个「待批准请求」,拿不到你的 GitHub / Google 登录态。这是防误授权的设计,不是能力不够。
03 实操七步
第 1 步 · 注册并建好机器
你做:用 GitHub 或 Google 注册 InstaBox,创建一台免费机器,模板选带桌面的(如 agent-browser),记下机器名。
两个提醒:
- 记住你用的是 GitHub 还是 Google——这两个在平台上是两套独立账号,后面授权登错入口会看到一个空账号,卡在这儿的人最多。
- 只有
/data下的文件是持久的,系统盘改动在重建后会没;重要东西放/data,并定期存快照。
第 2 步 · 让 AI 装 CLI 并发起授权
对 AI 说:
帮我查一下 InstaBox 官方 CLI 的用法,在这台电脑上装好,然后发起一个 Agent 授权请求,把认领链接和授权码给我。权限只要机器读 / 写和镜像读,不要账单和密钥权限。
AI 会做:Windows 用 npx instabox@latest(或 npm i -g instabox),然后跑:
instabox login --agent --name "WorkBuddy on this PC" --no-wait --json
返回一个形如 https://dashboard.instabox.sh/dashboard/claim?code=XXXX-XXXX 的链接。
你做:
- 把整条链接复制到浏览器地址栏回车;
- 用注册时同一个入口登录;
- 页面上会显示 Agent 名和权限列表,核对无误后点 Approve;
- 回来对 AI 说一句「批了」。
授权码通常 24 小时内有效,别转发给别人;用完可以在 Dashboard → API keys 里撤销。
验收:instabox whoami 能看到你的账号,instabox ls 能看到那台机器。
第 3 步 · 先体检,别急着装
这是我觉得最值钱的一条经验:让 AI 先只读检查,再动手改。
对 AI 说:
连上我的机器,先别装任何东西。输出:系统版本、架构、桌面是否在跑(DISPLAY)、已装的 AI 命令行工具及版本、Node 版本、3000 端口有没有进程监听、
/data剩余空间、/dev/fuse是否存在、Electron 图形依赖齐不齐。
AI 会做:instabox exec <机器名> --timeout 120 -- bash -lc '...',把一堆 command -v、ldconfig -p、ss -ltnp、df -h 的结果汇总给你。
为什么:我这次就是靠体检发现机器缺了 libgtk-3、libnss3、libgbm、libasound 等全部 Electron 图形依赖,如果直接下 AppImage 双击,必然失败。先体检,能省掉一整轮返工。
第 4 步 · 装 ZCode 桌面版
对 AI 说:
用官方 Linux
.deb包在这台机器上装 ZCode 桌面版,装完确认动态库没有缺口、桌面图标已注册,并把它启动到桌面上。遇到依赖问题先自己查仓库里的真实包名,别硬来。
AI 会做:下载官方 deb → 检查依赖 → 补齐 → dpkg -i → ldd 验证 → 带 DISPLAY 等环境变量拉起图形界面。
这里有个真坑:Debian 13 把 libgtk-3-0、libatspi2.0-0 这类包改名成了 *-0t64,而官方 deb 的依赖声明还写着老名字,直接 dpkg -i 会报依赖不满足。稳妥做法是「先遍历候选包名,只装仓库里真实存在的那些,再用 --force-depends 安装」,装完 ldd 全部解析成功才算数。
验收:dpkg -l 能看到版本号,/usr/share/applications/ 有桌面入口,Xfce 应用菜单里能找到图标,Computer 标签里能看到窗口。
第 5 步 · 点亮 3000 端口(并加访问码)
对 AI 说:
我建了一个 3000 端口但打开是空的。帮我查出已发布的公网地址,起一个只读的状态页,再加一个固定访问码,没输码的人只能看到输入框。
AI 会做:instabox port ls <机器名> 查到形如 https://3000-<机器ID>.instabox.tech 的地址;写一个监听 3000 的小服务;把页面做成「未登录只显示输入框,验证后下发 HttpOnly cookie」的形式;访问码存在机器上的文件里,不写进页面源码。
三个原则:
- 端口只是通道,服务才是内容;
- 发布出来的链接默认是 public,别在页面上放 API Key、别开放远程派任务接口;
- 访问码要能一条命令改掉,改完所有旧登录立即失效。
验收:浏览器无痕窗口打开只看到输入框;输错码报错;输对后能看到实时状态;curl -I 返回 200。
第 6 步 · 登录 ZCode(这一步只能你本人做)
打开 Dashboard → 你的机器 → Computer → Take control → ZCode,用 BigModel API Key 或 Z.ai 账号登录。
账号安全:API Key 只粘贴到机器里,不要发到聊天窗口、不要写进公众号文章、不要放进任何 public 页面。AI 需要用 Key 时,可以让它直接在机器本地读取配置文件,不需要你把明文贴出来。
两个常见坑:
- 国内 BigModel 的登录页在这台机器的内置浏览器里可能打不开,换国际站 Z.ai 登录通常就行;登录态会持久化,重启客户端不会再要求登录。
- 如果调用报
1113 余额不足或无可用资源包,多半是选了「Coding Plan」模板、默认模型要单独订阅套餐,不是 Key 失效。换成平台长期免费的GLM-4.7-Flash就能跑通(附录 A 有详细额度说明)。
第 7 步 · 开始派任务
装好之后有三条用法,按场景挑:
| 用法 | 怎么操作 | 适合 |
|---|---|---|
| 桌面 GUI | Computer 标签里直接在输入框说任务、回车,右侧看文件改动 | 想自己盯着它干活 |
| 命令行 headless | 对 AI 说「在 <机器名> 上让 ZCode 做 XX」;或自己在 TERMINAL 里跑 ztask "任务" | 让 AI 接管、批量任务、定时跑 |
| 手机派活 | 配置 ZCode 的远程控制 / 微信·飞书 Bot | 出门在外 |
为什么命令行能驱动桌面版:ZCode 桌面版内置了一个 headless 运行时,跟图形界面共享同一份凭证和会话库。所以 AI 不用点鼠标,走命令行就能派任务,还能用 --resume 续接会话、--mode 控制权限(只读 / 全自动 / 需批准)。
让 AI 顺手做的一件事:把每次任务的结果写进一个历史文件,工作台就能显示「最近任务」,回看 Agent 到底干了什么。这一步很便宜,但排查问题时特别有用。
04 踩坑对照表(都是真实发生过的)
| 现象 | 原因 | 解法 |
|---|---|---|
授权后 instabox ls 是空的 | 授权时登录的 OAuth 入口和注册时不是同一个 | GitHub / Google 是两套独立账号,换回注册时的入口重新批准 |
| 3000 链接打开一片空白 | 只发布了端口,没有进程监听 | 起一个监听 3000 的服务 |
dpkg -i 报依赖不满足 | Debian 13 把 libgtk-3-0 / libatspi2.0-0 改名成 *-0t64 | 按仓库真实包名装齐,再 --force-depends |
| AppImage 双击没反应 | 缺 Electron 全套图形库 | 改用 deb 让包管理器补依赖,或手动装齐后重试 |
ZCode 报 1113 余额不足 | Coding Plan 模板默认模型需订阅套餐 | 换免费模型 GLM-4.7-Flash;先单独测一下 Key 本身是否有效 |
| 重启后又出现 Welcome 登录页 | 首次登录态尚未落盘 / 启动瞬间的过渡画面 | 等几秒;凭证持久化后重启不再出现 |
| 「保存快照」提示权限不足 | Agent 授权只有 images:read,存快照要 images:write | 不用重新授权,在 Dashboard 点一下 Save snapshot 就行 |
| 上传脚本到绝对路径失败 | 本机路径被终端工具改写 | 用默认推送到 HOME,再在远端 cp |
| 界面是英文 | 配置文件里 locale 是 en-US | ~/.zcode/v2/setting.json 里 locale 和 localePreference 都改成 zh-CN,重启生效 |
05 安全清单(发之前对照一遍)
- ☐ 授权码只在自己浏览器里用,不转发;用完在 Dashboard → API keys 撤销
- ☐ 给 AI 的授权只要「机器读 / 写 + 镜像读」,不碰账单与密钥
- ☐ API Key 不进聊天记录、不进文章、不进 public 页面
- ☐ public 端口加访问码;更严格的场景直接设成 private
- ☐ 工作台只读展示,不开放「远程派任务」接口
- ☐ 要求 AI 先体检再改动、每一步回显验证结果,避免一把梭
- ☐ 重要配置存快照;文件只放
/data - ☐ 记住免费档空闲 30 分钟自动暂停,这是正常行为
06 四段提示词,复制就能用
① 起步
我刚注册了 InstaBox 并建了一台免费机器(机器名
<机器名>,带桌面模板)。请查官方文档,帮我装好官方 CLI,发起一个最小权限的 Agent 授权请求,把认领链接和授权码给我。我批准后你再继续,先别改动机器。
② 体检
连上机器后先只读体检:系统版本、桌面环境、已装 AI 工具及版本、3000 监听情况、
/data空间、图形依赖是否齐全。把结果整理成一张表,并告诉我还缺什么。
③ 部署
基于体检结果,用官方 Linux 安装包装好 ZCode 桌面版并启动;把 3000 端口做成一个带固定访问码的只读状态页。每一步都做幂等处理,重跑不要重复下载,失败要给出回退方案,最后把公网链接和验收结果给我。
④ 日常派活
在
<机器名>上让 ZCode 帮我做:<任务描述>。用--mode plan先看方案再决定要不要执行,把结果和历史记录写回工作台。
一个小技巧:在提示词里加「先告诉我你打算怎么做,等我确认再动手」,能挡掉绝大多数误操作;等熟悉了再放开。
07 附录 A · 智谱「每天领额度」到底怎么领
先把三件容易混的事分开:
| 类型 | 要不要每天领 | 关键点 |
|---|---|---|
| GLM-4.7-Flash 等免费模型 | 不用领 | 注册 + 实名 + 建 API Key 就能调,长期 0 元,有限速,适合兜底 |
| 新用户资源包 | 一次性 | 注册送的一笔 Tokens,有有效期,不是每日福利 |
| ZCode 每日 3 亿 GLM-5.3-Flash Tokens | 每天要领 | 客户端内的夜间波谷算力活动,规则最复杂 |
大家口口相传的「每天领额度」,指的是第三项。四步操作(时间均为北京时间):
- 更新客户端到最新版,老版本没有活动入口;国内账号走 BigModel,海外账号走 Z.ai,入口一致。
- 每天 19:00 后打开 ZCode,在左下角活动卡片点领取(Claim)。
- 领完不能马上用:可用窗口是 23:00 到次日 09:00,共 10 小时,额度当天清零、不累积。
- 用之前必须做两个切换:通道切到 Global Building,模型手动选成 GLM-5.3-Flash。漏了这一步,额度挂在账户里用不上,跑起来还是扣自己的。到「设置 → 使用统计」可以确认计量是否走赠送额度。
三个必须知道的坑:
- 这不是通用 API 额度:不分发独立 Key、导不出来,只在 ZCode 客户端里有效,别的工具接不进去。
- 只支持 GLM-5.3-Flash 这一个模型,且官方没公布结束日期,「每天都能领」不等于永久。
- 官方海报写的是 UTC(11:00 领取、15:00–次日 01:00 使用),媒体常换算成北京时间。云服务器终端里
date往往是 UTC,别拿它当北京时间算,以客户端内卡片出现为准。
正确姿势:19 点领完不用守着,睡前把批量重构、补测试、生成文档这类不需要实时反馈的长任务排好队交出去,早上看结果;白天要即时问答,继续用长期免费的 GLM-4.7-Flash。有读者反馈夜间速度会降、偶发断连,所以长任务最好设一个「跑到几点自动收工」的终点,别设成无限循环。
08 常见问题
Q:AI 会不会把我机器上的文件删了? 权限上可以,所以用 --mode 控制、重要目录先备份、让它先出方案再执行。默认全自动只适合你确认过的工作目录。
Q:机器「暂停」了怎么办? 访问 3000 链接、发命令或 SSH 都会自动唤醒,/data 里的文件和已装软件都在,不用重装。
Q:一定要开浏览器控制吗? 不必。走 Agent 授权 + CLI 这条路,浏览器控制完全用不上;只有你想让 AI 操作某个网页后台时才需要。
Q:快照存不上,要不要重新发授权? 不用。Agent 密钥通常只有镜像读权限,在 Dashboard 手动点一下 Save snapshot 就行。
Q:能不能换更强的模型? 可以,但要先确认账号有对应套餐或额度。普通开放平台 Key 直接选旗舰模型容易报「余额不足」,先用免费模型跑通再升级,是最省心的顺序。
写在最后
这套流程真正省时间的,不是「AI 帮我敲了几条命令」,而是它把「查资料 → 体检 → 试错 → 回退 → 验收」这条链一口气跑完了。你要做的只有三件必须由人完成的事:批准授权、登录账号、决定要不要让它动手。
如果你也刚注册了一台,建议从第 2 步的授权开始试。第一次跑通之后,以后只要说一句「在机器上让 ZCode 做 XX」,这台云电脑就真的开始替你干活了。
本文基于一次真实部署整理,涉及的版本、命令与活动规则可能随时变化;平台活动以官方公告和客户端内实时状态为准。文中不含任何账号、密钥或访问码,请自行替换占位符。
浏览器打开本页 → 全选复制 → 粘贴到公众号编辑器,样式会一并带过去。封面图可直接截取顶部横幅。
576



被折叠的 条评论
为什么被折叠?



