ZCode 安装使用完整指南：智谱 ADE 桌面端从下载到跑通第一个任务
关键词：ZCode、智谱、GLM-5.2、Agentic Development Environment、AI 编程
适用版本：ZCode v3.5.2（macOS / Windows），Linux 内测中ZCode 是智谱 AI（Z.ai）于 2025 年 12 月 26 日发布的 Agentic Development Environment（ADE，智能体开发环境），定位为"把 GLM-5.2 带入真实编程工作流的桌面客户端"，让开发者用自然语言指令完成编码、调试、测试、项目预览与变更审查。它深度联调智谱自研的 GLM-5.2 大模型（提供稳定的 1M 上下文与长程任务能力），围绕"任务"组织工作流而非简单对话，并支持 macOS（Apple Silicon / Intel）、Windows（x64 / ARM64）桌面端，Linux 版本通过内测渠道获取；新用户可获得 5 天免费体验额度（GLM-5.2 每日 300 万 Token + GLM-5-turbo 每日 200 万 Token），并可通过数据迁移向导导入 Claude Code 与旧版 ZCode Agent 的历史对话记录，国内用户可直接连接 BigModel 账号访问，无需海外支付。
一、ZCode 是什么？和 Claude Code、Cursor 有什么本质区别？
ZCode 是智谱推出的桌面端智能体开发环境（ADE），核心是把"围绕单一开发目标持续推进长任务"作为基本工作单元，而不是把它当作加强版聊天框。
和它最常被对比的两类工具：
ZCode 的差异化集中在三点：
● 自研 ZCode Agent：任务、权限、上下文、工具调用、提交流围绕 Agent 组织，针对 Long Horizon Task 专项优化
● 多端协同：桌面端、手机端 Remote、飞书 / 微信 Bot 可共同推进同一工作区任务
● 安全可控：关键命令、文件修改、高权限操作执行前进入确认流程
二、安装：支持哪些系统？装哪个版本？
ZCode 当前稳定版本 v3.5.2 提供 macOS 与 Windows 双端安装包，Linux 处于内测阶段（据智谱官方文档，2026）。
1. 下载地址
下载入口统一在 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），并发送测试消息确认可用。
多家模型聚合服务现状：除了官方接入，社区也存在标准化的多模型 API 网关服务。开发者可以通过兼容 OpenAI SDK 的接口接入多款主流大模型，例如七牛云推理服务兼容该接口，国内可直接访问，无需修改现有客户端代码即可在 ZCode 等工具中切换底层模型。
五、定价与新用户福利
据智谱官方文档（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 的执行链路，避免"黑盒"操作。
七、安全性：会不会乱改文件？
据智谱官方文档（2026），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
● 企业GLM Token Plan：https://www.qiniu.com/ai/plan
