前两篇讲清楚了 ZCode 是什么、和 Claude Code / Cursor 比怎么样。这篇直接动手装——从下载到跑通第一个任务，全程不跳步，常见坑一次性标注。
ZCode 3.0 是智谱推出的桌面端 Agent 驱动开发环境，目前支持 macOS 和 Windows。安装流程比终端 Agent 工具（Claude Code、openCode）更简单——下载一个安装包，安装后登录账号就能用，不需要配 npm、不需要设 API Key。
系统要求
macOS：macOS 12（Monterey）或更高版本，Apple Silicon（M1/M2/M3/M4）原生支持，Intel 芯片也兼容。安装包约 300MB，磁盘占用小于 1GB。
Windows：Windows 10 版本 19041 或更高（2020 年 5 月后的版本），Windows 11 完全兼容。支持 x64 架构，安装包约 250MB。
不需要独立显卡，不需要大内存，只要能流畅跑 VS Code，ZCode 就能跑。
下载与安装
macOS 安装：
打开智谱开放平台，进入 ZCode 产品页，点”下载 macOS 版”。页面自动识别系统并提供 .dmg 安装包。
下载完成后双击 .dmg，把 ZCode 图标拖进 Applications 文件夹，安装即完成。首次打开时 macOS 会弹出安全提示”ZCode 是从互联网下载的应用”，点”打开”继续。
如果公司 Mac 有 MDM 管控策略拦截安装，联系 IT 放开即可。安装后在 Launchpad 搜索”ZCode”就能看到图标。
Windows 安装：
同一页面选择”Windows 版”，下载 .exe 安装包。双击运行安装向导，按默认设置一路”下一步”即可。安装路径建议保持默认（%LOCALAPPDATA%\Programs\ZCode），不要改成中文路径。
安装完成后桌面自动创建快捷方式。如果公司安全软件拦截安装包，需要联系 IT 将 ZCode 加入白名单——ZCode 有正规数字签名，属于误拦。
账号注册与登录
打开 ZCode，进入登录界面。支持两种方式：
手机号注册：国内用户最直接的方式。输入手机号 → 获取验证码 → 设置密码或微信扫码绑定。建议同时绑定微信，后续多端登录更方便。
微信扫码登录：如果你已经有智谱账号且绑定了微信，直接微信扫码即可登录。第一次使用的话需要先通过手机号注册。
登录成功后，300 万 Token/天的免费额度自动激活——不需要额外操作、不需要绑卡、不需要申请。在界面左下角或设置页面能看到当前周期的用量和剩余额度。这个额度对绝大多数个人开发者来说完全够用。
首次配置
登录后进入 ZCode 主界面。做三件事完成初始配置：
一、确认任务工作区：ZCode 默认会把你的”文档”或”用户目录”作为工作区根目录。建议改成你的项目文件夹——在设置里指定你的代码仓库所在的父目录，这样之后创建新任务时能快速定位到项目。
二、熟悉分组任务面板：ZCode 界面的核心区域是分组任务面板。左边是项目文件树，中间是任务对话区，右边是 Git 图谱和状态看板。花一分钟点击各个区域了解布局——第一篇讲过 ZCode 是 Agent 驱动的开发环境，不是传统 IDE，理解布局才能高效使用。
三、确认自动审批设置：ZCode 默认对文件修改和命令执行都需要你审批。如果信任当前工作区，可以在设置中将审批模式从”手动确认每次操作”调整为”工作区内自动审批”。初期建议保持手动——先了解 ZCode 会做哪些操作，再考虑放宽。
跑通第一个任务
别一上来就搞复杂项目。先用一个简单任务验证安装正确、权限正常。
推荐的首个任务：创建一个网页计数器。这个任务够简单、够直观，不涉及复杂的项目配置和外部依赖，几分钟跑完，结果能在浏览器里看到。
在任务对话框中输入：
“帮我创建一个简单的网页计数器。要求：一个 HTML 文件、一个计数器按钮，点击按钮数字加 1，样式简洁。文件创建在 workspace 下，完成后告诉我文件路径。”
ZCode 不会立刻动手——它先生成一份执行计划，展示给你看：创建哪个文件、写什么代码、文件放在哪个目录。你审批通过后它才开始执行。
执行过程中你能看到它自动完成以下操作：
- 创建 HTML 文件
- 写入计数器代码（包含按钮和计数器逻辑）
- 保存文件到指定目录
- 汇报结果
任务完成后，在文件管理器里打开它创建的 HTML 文件，用浏览器打开，点击按钮测试计数器。如果数字能正常增加，说明 ZCode 安装和配置完全正确。
跑通第一个带 Git 的任务
网页计数器验证了 ZCode 创建文件的能力。接下来验证 Git 集成能力——这是 ZCode 的差异化功能之一。
“帮我在 workspace 下初始化一个 Git 仓库，把刚才创建的 counter.html 加入版本控制，做一次初始提交。然后创建一个 README.md 文件，说明这个项目的用途和运行方式。最后提交 README 并展示 Git 分支图谱。”
执行完成后，在界面右边的 Git 图谱区域能看到两个 commit 节点和分支线——这就是 ZCode 的可视化 Git 分支图谱功能。这个任务同时验证了：文件创建、Git 操作、代码提交，三个核心能力一切正常。
常见安装问题速查
Q：安装后打不开，一直闪退？
macOS 上检查系统版本是否 >= macOS 12。Windows 上检查是否有安全软件拦截，暂时关闭安全软件再启动确认。如果仍闪退，去智谱开放平台的用户支持页面提工单。
Q：登录后提示”免费额度未激活”？
检查网络连接。如果开了代理，尝试关闭代理后重新登录。免费额度是自动发放的，不需要额外操作。如果持续不激活，退出账号重新登录通常能触发额度刷新。
Q：第一次任务一直卡在”分析需求”？
常见原因是网络波动。取消任务，重新发送一次相同的描述即可。如果持续卡住，检查代理设置——ZCode 需要直连智谱的服务端，代理可能干扰通信。
Q：任务执行时提示”没有文件写入权限”？
检查 ZCode 的工作区设置——当前操作的目标目录是否在允许的范围内。去设置 → 工作区确认已授权的目录列表，确保目标路径在授权范围内。
Q：安装时 Windows 报”不是有效的 Win32 应用程序”？
你下载的是 arm64 版本但你的 Windows 是 x64（或相反）。ZCode 3.0 目前只支持 x64，确认下载的是正确的安装包。
总结
ZCode 3.0 的安装三步到位：下载安装包 → 登录激活免费额度 → 跑通一个简单任务验证。
不需要配 Node.js、不需要申请 API Key、不需要绑定信用卡——这一点对国内开发者非常友好。300 万 Token/天的免费额度让你有充分的时间慢慢熟悉，不用担心用了几天就开始收费。
装好后，下一篇带你深入分组任务工作区——多个任务如何并行、任务之间如何隔离上下文、Git 图谱怎么辅助多人协作。
如果这篇安装指南帮你顺利装好了 ZCode，欢迎分享给也在装机器的朋友。你装的过程中有没有遇到什么奇怪的报错？评论区聊聊~
