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/8/18 16:32:51 阅读更多 →
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/8/17 3:01:26 阅读更多 →
LangChain Chain链实战:从原理到论文写作应用

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

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

2026/8/14 23:14:38 阅读更多 →

最新新闻

零基础也能上手AI股票研究:一个开源工具让普通人也拥有“分析师团队“

零基础也能上手AI股票研究:一个开源工具让普通人也拥有“分析师团队“

零基础也能上手AI股票研究:一个开源工具让普通人也拥有"分析师团队" 【免费下载链接】TradingAgents-CN 基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版 项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN 深夜十…

2026/8/18 16:33:01 阅读更多 →
家里电视盒子放不动高清片?先别急着换硬件,试试这个开源播放器

家里电视盒子放不动高清片?先别急着换硬件,试试这个开源播放器

家里电视盒子放不动高清片?先别急着换硬件,试试这个开源播放器 【免费下载链接】TVBoxOSC TVBoxOSC - 一个基于第三方项目的代码库,用于电视盒子的控制和管理。 项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC 家里的电视…

2026/8/18 16:33:01 阅读更多 →
3分钟上手多智能体AI股票分析系统:零代码搭建你的智能投资参谋

3分钟上手多智能体AI股票分析系统:零代码搭建你的智能投资参谋

3分钟上手多智能体AI股票分析系统:零代码搭建你的智能投资参谋 【免费下载链接】TradingAgents-CN 基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版 项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN 如果你对"AI炒股…

2026/8/18 16:33:00 阅读更多 →
yfinance完整指南:零配置5分钟搞定免费金融数据获取

yfinance完整指南:零配置5分钟搞定免费金融数据获取

yfinance完整指南:零配置5分钟搞定免费金融数据获取 【免费下载链接】yfinance Download market data from Yahoo! Finances API 项目地址: https://gitcode.com/GitHub_Trending/yf/yfinance yfinance 是一个用 Python 下载雅虎财经市场数据的开源库&#x…

2026/8/18 16:33:00 阅读更多 →
nowatermark 去水印源码深度解析:WatermarkRemover 核心类工作原理逐行拆解

nowatermark 去水印源码深度解析:WatermarkRemover 核心类工作原理逐行拆解

nowatermark 去水印源码深度解析:WatermarkRemover 核心类工作原理逐行拆解 【免费下载链接】nowatermark remove watermark. 去除图片中的水印 项目地址: https://gitcode.com/gh_mirrors/no/nowatermark 本文为你深度解析 nowatermark 这个基于 Python 与 …

2026/8/18 16:33:00 阅读更多 →
HsMod 炉石插件零基础实战指南:从安装避坑到按场景调优

HsMod 炉石插件零基础实战指南:从安装避坑到按场景调优

HsMod 炉石插件零基础实战指南:从安装避坑到按场景调优 【免费下载链接】HsMod Hearthstone Modification Based on BepInEx 项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod 如果你是炉石传说玩家,大概都经历过这样几个瞬间&#xff1a…

2026/8/18 16:31:59 阅读更多 →

日新闻

告别逐帧截图:用 extract-video-ppt 快速提取视频中的 PPT 并一键导出 PDF

告别逐帧截图:用 extract-video-ppt 快速提取视频中的 PPT 并一键导出 PDF

告别逐帧截图:用 extract-video-ppt 快速提取视频中的 PPT 并一键导出 PDF 【免费下载链接】extract-video-ppt extract the ppt in the video 项目地址: https://gitcode.com/gh_mirrors/ex/extract-video-ppt 如果你还停留在"看网课 不停暂停 截图 …

2026/8/18 0:00:57 阅读更多 →
思源宋体TTF一站式上手:7个字重免费商用,从下载到上线的完整走查

思源宋体TTF一站式上手:7个字重免费商用,从下载到上线的完整走查

思源宋体TTF一站式上手:7个字重免费商用,从下载到上线的完整走查 【免费下载链接】source-han-serif-ttf Source Han Serif TTF 项目地址: https://gitcode.com/gh_mirrors/so/source-han-serif-ttf 你是不是也经历过这种时刻:设计稿里…

2026/8/18 0:00:58 阅读更多 →
华硕笔记本控制权回收指南:GHelper 如何用一个 10MB 文件替代 Armoury Crate

华硕笔记本控制权回收指南:GHelper 如何用一个 10MB 文件替代 Armoury Crate

华硕笔记本控制权回收指南:GHelper 如何用一个 10MB 文件替代 Armoury Crate 【免费下载链接】g-helper Lightweight Armoury Crate alternative for Asus laptops with nearly the same functionality. Works with ROG Zephyrus, Flow, TUF, Strix, Scar, ProArt, …

2026/8/18 0:00:59 阅读更多 →

周新闻

基于阿里云与通义千问(Qwen)构建AI应用:从模型调用到生产部署的完整实践指南

基于阿里云与通义千问(Qwen)构建AI应用:从模型调用到生产部署的完整实践指南

如果你是一名开发者,最近可能已经感受到了AI大模型正在从“玩具”变成“生产力工具”的强烈信号。从代码补全到智能Agent,从本地部署到云端API,我们正处在一个技术栈快速重构的节点。然而,面对层出不穷的模型、框架和工具&#xf…

2026/8/18 9:15:35 阅读更多 →
工业通信系统底层逻辑:04 反射——高频能量撞墙之后会发生什么?

工业通信系统底层逻辑:04 反射——高频能量撞墙之后会发生什么?

第四篇:反射——高频能量撞墙之后会发生什么? —— 你以为信号已经过去了,其实它正在回来打你 老Q的现场笔记 第五季,我们正式进入工业神经系统层。这里不再是单个设备的战斗,而是整个工厂“经脉”层面的秩序之战。从这一篇开始,你将第一次看清:看似简单的信号传播,背…

2026/8/18 9:06:28 阅读更多 →
【文章复现】非线性值迭代自适应动态规划(ADP):离散时间非线性系统的策略迭代自适应动态规划算法研究附Matlab代码

【文章复现】非线性值迭代自适应动态规划(ADP):离散时间非线性系统的策略迭代自适应动态规划算法研究附Matlab代码

✅作者简介:热爱科研的Matlab仿真开发者,擅长毕业设计辅导、数学建模、数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页:Matlab科研工作室👇 关注我领取海量matlab电子书和…

2026/8/18 9:04:56 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/17 18:54:37 阅读更多 →
终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗?ncmdump解密工具帮你轻松解决这个困…

2026/8/17 18:55:16 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片:为英语学习 App 打造桌面级学习助手适用平台:HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0(API 26 Beta)新增了 AgentCard 智能体卡片能力,这是继 HMAF(鸿蒙智能体框架&#x…

2026/8/17 18:55:55 阅读更多 →