ZCode智谱ADE桌面端安装使用完整指南：从下载到跑通第一个任务

这篇文章发布于2026年7月，核心信息围绕ZCode v3.5.2版本展开，覆盖macOS和Windows桌面端，Linux版本则处于内测阶段。ZCode的定位非常明确：它不是一个简单的AI聊天框，而是一个将GLM-5.2大模型深度嵌入真实编程工作流的桌面端智能体开发环境。

一、ZCode 是什么？和 Claude Code、Cursor 有什么本质区别？

ZCode 是智谱推出的桌面端智能体开发环境（ADE），其核心设计理念是将“围绕一个单一开发目标持续推进长任务”作为基本工作单元，而不是将其视为一个加强版的聊天界面。这一点，是它与市面上其他工具最根本的不同。

为了更直观地理解它的定位，不妨把它与几款主流工具做个对比：

工具	类型	核心定位	模型策略	国内访问
ZCode	ADE 桌面客户端	长任务、GLM-5.2 深度联调	绑定 GLM-5.2 / GLM-5-turbo	直接访问（BigModel）
Claude Code	CLI Agent	终端内的 Agent 编程	绑定 Claude 系列	需海外账号
Cursor	IDE 编辑器	在 IDE 内 AI 辅助编码	多模型切换	需海外账号
Codex CLI	CLI Agent	终端代码任务	OpenAI 模型	需海外账号

ZCode 的差异化优势集中体现在三个层面：

• 自研 ZCode Agent：任务、权限、上下文、工具调用、代码提交流程都围绕 Agent 这一核心来组织，尤其针对长周期任务（Long Horizon Task）进行了专项优化。
• 多端协同：桌面端、手机端 Remote、甚至飞书或微信 Bot 都可以共同参与到同一个工作区的任务推进中，这一点在团队协作场景下很有想象力。
• 安全可控：关键命令、文件修改、高权限操作在执行前都会进入确认流程，给你留足“踩刹车”的空间。

二、安装：支持哪些系统？装哪个版本？

ZCode 当前稳定版本 v3.5.2 提供 macOS 与 Windows 双端安装包，Linux 则处于内测阶段。

1. 下载地址

平台	架构	安装包
macOS	Apple Silicon（M 系列）	ZCode-3.5.2-mac-arm64.dmg
macOS	Intel	ZCode-3.5.2-mac-x64.dmg
Windows	x64	ZCode-3.5.2-win-x64.exe
Windows	ARM64	ZCode-3.5.2-win-arm64.exe
Linux	—	通过飞书内测群获取

下载入口统一在 ZCode 中文官网 zcode.z.ai/cn，安装包托管于官方 CDN cdn-zcode.z.ai。

2. macOS 安装三步

1. 打开下载的 ZCode.dmg 安装镜像
2. 将 ZCode.app 拖动到 Applications 文件夹
3. 在启动台中找到 ZCode 并启动

M 系列芯片务必下载 arm64 版本，否则会以 Rosetta 模式运行，在执行长任务时性能会有明显下降，得不偿失。

3. Windows 安装三步

1. 下载 ZCode-3.5.2-win-x64.exe 安装程序
2. 双击运行，按照安装向导完成安装
3. 从开始菜单或桌面快捷方式启动 ZCode

4. Linux 安装（内测）

加入飞书内测群获取安装包，按发行版常规方式安装，或为安装文件添加可执行权限后直接运行。部分发行版需要额外安装 fuse 依赖。

三、首次启动：三步完成初始化配置

第一次启动时会进入“首次启动设置”页面，整个流程并不复杂，两分钟内可以搞定。

第 1 步：选择直接进入或数据迁移

• 直接使用：点击“开始使用 ZCode”直接进入
• 迁移历史数据：选择“数据迁移向导”

需要留意的是，迁移向导当前仅支持导入 Claude Code 和旧版 ZCode 中 ZCode Agent 的对话记录，其他工具的数据目前还无法迁移。

第 2 步：选定项目目录作为工作区

进入主界面后，选择一个本地项目目录作为 Agent 的工作区。ZCode 会持续读取该目录下的文件、终端、浏览器、执行模式和 Git 状态，为后续的任务执行提供上下文。

第 3 步：发一条简单指令验证

在对话框输入一句简单指令，比如让 Agent 列出当前目录的文件，确认模型响应正常。如果回复正常，说明安装与模型接入都已就绪。

四、连接模型：三种接入方式选哪种？

ZCode 支持三种模型接入路径，适配不同类型的用户：

1. 连接 Z.ai 账号

适合海外用户或已有 Z.ai 国际站账号的开发者。在登录页选择“连接 Z.ai”，使用账号密码登录即可调用 GLM-5.2 等内置模型。

2. 连接 BigModel 账号

适合国内用户。BigModel 是智谱国内站点，账号体系与国内手机号绑定，国内可直接访问，访问稳定，无需任何额外网络配置。

3. 使用 API Key

适合已订阅 GLM Coding Plan 或希望走独立 API 计费的开发者。在模型设置中粘贴 API Key 即可。

国内 Coding Plan 的 Base URL 通常按协议区分：

• 兼容 Anthropic 协议：https://ark.cn-beijing.volces.com/api/coding
• 兼容 OpenAI 协议：.../api/coding/v3

配置完成后可在模型列表中填入 GLM-5.2，亦可添加其他模型（如 GLM-5-turbo），并发送测试消息确认可用。

五、定价与新用户福利

根据官方信息（2026 年数据，活动截止 2026-07-31）：

• 新用户 5 天免费体验：GLM-5.2 每日 300 万 Token、GLM-5-turbo 每日 200 万 Token，合计每日 500 万 Token；额度仅在这 5 天内每日发放，过期失效
• 订阅用户配额优惠：高峰期（每日 14:00–18:00）3x→2x，非高峰期（其余 20 小时）1x→0.67x，约相当于 1.5 倍配额

具体订阅价格以 ZCode 官方页面实时显示为准，未在公开文档中披露。

六、典型使用场景：五类任务最适合

ZCode 的核心不是聊天，而是“围绕一个开发目标，持续推进一个完整任务”。根据官方文档与社区实践，以下五类场景匹配度最高：

1. 新功能开发：从需求拆解到代码实现、自测、提交 review 一气呵成
2. Bug 修复：粘贴报错或现象描述，Agent 自主定位、修复、回归验证
3. 代码理解：让 Agent 阅读大型 legacy 项目并输出架构说明
4. 代码评审：对本地变更或 PR 进行 Review，给出修改建议
5. 发布准备：检查依赖、构建产物、更新日志等收尾工作

主界面四个关键区域——任务进度、终端输出、文件变更、Git 状态——持续反馈 Agent 的执行链路，避免“黑盒”操作。

七、安全性：会不会乱改文件？

安全性方面，ZCode 设计了多层安全机制：

• 关键命令确认：执行高权限 shell 命令前需用户确认
• 文件修改确认：写入或删除文件前展示 diff 供审核
• Git 状态可见：所有变更实时反映到版本控制面板，可随时回滚

这意味着即便 Agent 出现误判，用户也有充足的拦截和回退手段。

八、FAQ

Q：ZCode 是开源的吗？
A：据公开信息，ZCode 当前以免费桌面客户端形式发布，智谱未公开其核心源代码。其生态内的 Skill、MCP 服务器、Plugin 等扩展机制可自定义，但客户端本体非开源。

Q：ZCode 支持哪些模型？
A：官方深度联调 GLM-5.2（1M 上下文）与 GLM-5-turbo。通过 API Key 接入其他模型服务的兼容性以实际配置为准，官方文档未列举完整的第三方模型清单。

Q：Linux 什么时候正式发布？
A：截至 2026 年 7 月，Linux 版本仍通过飞书内测群分发，官方未公布 GA 时间。

Q：ZCode 和智谱此前的 CLI 工具是什么关系？
A：ZCode 提供“数据迁移向导”，支持导入旧版 ZCode 中 ZCode Agent 的对话记录，可视为智谱在 ADE 方向上的最新迭代产品。

Q：团队多人协作怎么用？
A：ZCode 的 Remote 手机端与飞书 / 微信 Bot 可加入同一工作区，多人通过 Bot Channel 推进同一长任务，具体协作权限模型以官方“Bot Channel”文档为准。

九、总结

ZCode 的核心价值在于把 GLM-5.2 的 1M 上下文与长程任务能力，包装成国内开发者开箱即用的桌面 ADE。它对个人开发者友好（5 天免费额度足够完成 1-2 个完整任务）、对国内用户友好（BigModel 直连）、对团队协作友好（手机 Remote + IM Bot）。

据智谱官方文档（2026）与 IT之家、AIBase 等媒体报道（2025 年 12 月），ZCode 自 2025 年 12 月 26 日发布以来持续保持双周迭代节奏，当前稳定版为 v3.5.2。本文内容基于 2026 年 7 月数据，建议定期查阅 ZCode 官方文档（zcode.z.ai/cn/docs）以获取最新功能与定价信息。

延伸资源

• ZCode 官方文档：https://zcode.z.ai/cn/docs
• ZCode 安装包下载：https://zcode.z.ai/cn