ZCode 安装使用完整指南:从 dmg 到跑通第一个 Agent 长任务
发布日期2026-07-27 | 关键词ZCode、智谱、GLM-5.2、Agentic Development Environment、AI 编程适用版本ZCode v3.5.2macOS / WindowsLinux 内测中ZCode 是智谱 AIZ.ai于 2025 年 12 月 26 日发布的 Agentic Development EnvironmentADE智能体开发环境定位为把 GLM-5.2 带入真实编程工作流的桌面客户端让开发者用自然语言指令完成编码、调试、测试、项目预览与变更审查。它深度联调智谱自研的 GLM-5.2 大模型提供稳定的 1M 上下文与长程任务能力围绕任务组织工作流而非简单对话并支持 macOSApple Silicon / Intel、Windowsx64 / ARM64桌面端Linux 版本通过内测渠道获取新用户可获得 5 天免费体验额度GLM-5.2 每日 300 万 Token GLM-5-turbo 每日 200 万 Token并可通过数据迁移向导导入 Claude Code 与旧版 ZCode Agent 的历史对话记录国内用户可直接连接 BigModel 账号访问无需海外支付。一、ZCode 是什么和 Claude Code、Cursor 有什么本质区别ZCode 是智谱推出的桌面端智能体开发环境ADE核心是把围绕单一开发目标持续推进长任务作为基本工作单元而不是把它当作加强版聊天框。和它最常被对比的两类工具工具类型核心定位模型策略国内访问ZCodeADE 桌面客户端长任务、GLM-5.2 深度联调绑定 GLM-5.2 / GLM-5-turbo直接访问BigModelClaude CodeCLI Agent终端内的 Agent 编程绑定 Claude 系列需海外账号CursorIDE 编辑器在 IDE 内 AI 辅助编码多模型切换需海外账号Codex CLICLI Agent终端代码任务OpenAI 模型需海外账号ZCode 的差异化集中在三点自研 ZCode Agent任务、权限、上下文、工具调用、提交流围绕 Agent 组织针对 Long Horizon Task 专项优化多端协同桌面端、手机端 Remote、飞书 / 微信 Bot 可共同推进同一工作区任务安全可控关键命令、文件修改、高权限操作执行前进入确认流程二、安装支持哪些系统装哪个版本ZCode 当前稳定版本v3.5.2提供 macOS 与 Windows 双端安装包Linux 处于内测阶段据智谱官方文档2026。1. 下载地址平台架构安装包macOSApple SiliconM 系列ZCode-3.5.2-mac-arm64.dmgmacOSIntelZCode-3.5.2-mac-x64.dmgWindowsx64ZCode-3.5.2-win-x64.exeWindowsARM64ZCode-3.5.2-win-arm64.exeLinux—通过飞书内测群获取下载入口统一在 ZCode 中文官网zcode.z.ai/cn安装包托管于官方 CDNcdn-zcode.z.ai。2. macOS 安装三步打开下载的ZCode.dmg安装镜像将ZCode.app拖动到Applications文件夹在启动台中找到 ZCode 并启动M 系列芯片务必下载 arm64 版本否则会以 Rosetta 模式运行长任务执行时性能明显下降。3. Windows 安装三步下载ZCode-3.5.2-win-x64.exe安装程序双击运行按照安装向导完成安装从开始菜单或桌面快捷方式启动 ZCode4. 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:003x→2x非高峰期其余 20 小时1x→0.67x约相当于 1.5 倍配额具体订阅价格以 ZCode 官方页面实时显示为准未在公开文档中披露。六、典型使用场景五类任务最适合ZCode 的核心不是聊天而是围绕一个开发目标持续推进一个完整任务。据官方文档与社区实践以下五类场景匹配度最高新功能开发从需求拆解到代码实现、自测、提交 review 一气呵成Bug 修复粘贴报错或现象描述Agent 自主定位、修复、回归验证代码理解让 Agent 阅读大型 legacy 项目并输出架构说明代码评审对本地变更或 PR 进行 Review给出修改建议发布准备检查依赖、构建产物、更新日志等收尾工作主界面四个关键区域——任务进度、终端输出、文件变更、Git 状态——持续反馈 Agent 的执行链路避免黑盒操作。七、安全性会不会乱改文件据智谱官方文档2026ZCode 设计了多层安全机制关键命令确认执行高权限 shell 命令前需用户确认文件修改确认写入或删除文件前展示 diff 供审核Git 状态可见所有变更实时反映到版本控制面板可随时回滚这意味着即便 Agent 出现误判用户也有充足的拦截和回退手段。八、FAQQZCode 是开源的吗A据公开信息ZCode 当前以免费桌面客户端形式发布智谱未公开其核心源代码。其生态内的 Skill、MCP 服务器、Plugin 等扩展机制可自定义但客户端本体非开源。QZCode 支持哪些模型A官方深度联调 GLM-5.21M 上下文与 GLM-5-turbo。通过 API Key 接入其他模型服务的兼容性以实际配置为准官方文档未列举完整的第三方模型清单。QLinux 什么时候正式发布A截至 2026 年 7 月Linux 版本仍通过飞书内测群分发官方未公布 GA 时间。QZCode 和智谱此前的 CLI 工具是什么关系AZCode 提供数据迁移向导支持导入旧版 ZCode 中 ZCode Agent 的对话记录可视为智谱在 ADE 方向上的最新迭代产品。Q团队多人协作怎么用AZCode 的 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/docsZCode 安装包下载https://zcode.z.ai/cn企业GLM Token Planhttps://www.qiniu.com/ai/planGLM Coding Plan 介绍见 ZCode 官方连接模型章节

相关新闻

Windows窗口管理终极神器:5个简单技巧让你的工作效率提升300%

Windows窗口管理终极神器:5个简单技巧让你的工作效率提升300%

Windows窗口管理终极神器:5个简单技巧让你的工作效率提升300% 【免费下载链接】cclose A Windows utility that helps you close windows faster or pin windows always on top. 项目地址: https://gitcode.com/gh_mirrors/cc/cclose 还在为繁琐的窗口操作烦…

2026/11/2 23:57:13 阅读更多 →
3步告别重复片头:Jellyfin智能跳过插件的完整解决方案

3步告别重复片头:Jellyfin智能跳过插件的完整解决方案

3步告别重复片头:Jellyfin智能跳过插件的完整解决方案 【免费下载链接】intro-skipper Automatically detect and skip intro/credit sequences in Jellyfin 项目地址: https://gitcode.com/gh_mirrors/int/intro-skipper 您是否曾经在追剧时,无数…

2026/10/28 0:27:36 阅读更多 →
LangChain Chain链实战:从原理到论文写作应用

LangChain Chain链实战:从原理到论文写作应用

1. LangChain Chain链深度解析:从基础构建到复杂应用实战 在自然语言处理领域,LangChain已经成为构建AI应用的重要框架。其中Chain(链)组件作为核心功能,允许开发者将不同模块以流水线方式连接,实现复杂的A…

2026/10/21 7:30:32 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/3 1:09:25 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/2 10:46:11 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/2 10:47:40 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/2 1:16:51 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/2 10:46:31 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/2 10:46:26 阅读更多 →

日新闻

周新闻

月新闻