前两篇讲清楚了 ZCode 是什么、和 Claude Code / Cursor 比怎么样。这篇直接动手装——从下载到跑通第一个任务全程不跳步常见坑一次性标注。ZCode 3.0 是智谱推出的桌面端 Agent 驱动开发环境目前支持 macOS 和 Windows。安装流程比终端 Agent 工具Claude Code、openCode更简单——下载一个安装包安装后登录账号就能用不需要配 npm、不需要设 API Key。系统要求macOSmacOS 12Monterey或更高版本Apple SiliconM1/M2/M3/M4原生支持Intel 芯片也兼容。安装包约 300MB磁盘占用小于 1GB。WindowsWindows 10 版本 19041 或更高2020 年 5 月后的版本Windows 11 完全兼容。支持 x64 架构安装包约 250MB。不需要独立显卡不需要大内存只要能流畅跑 VS CodeZCode 就能跑。下载与安装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欢迎分享给也在装机器的朋友。你装的过程中有没有遇到什么奇怪的报错评论区聊聊~