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

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

来源：互联网 2026-07-28 06:12:17

ZCodev3.5.2是智谱推出的桌面端智能体开发环境，将GLM-5.2大模型深度嵌入编程工作流，以长任务为基本工作单元。全面支持macOS和Windows系统，Linux版本正在内测中。国内用户可通过BigModel平台直接连接，新用户可享有5天每日500万Token免费体验。

这篇文章发布于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 安装三步

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

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

3. Windows 安装三步

下载 ZCode-3.5.2-win-x64.exe 安装程序
双击运行，按照安装向导完成安装
从开始菜单或桌面快捷方式启动 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 的核心不是聊天，而是“围绕一个开发目标，持续推进一个完整任务”。根据官方文档与社区实践，以下五类场景匹配度最高：

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

主界面四个关键区域——任务进度、终端输出、文件变更、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）以获取最新功能与定价信息。