ZCode 怎么用：从下载到跑通第一个任务

ZCode 是什么

智谱 2025 年 12 月底推出的 AI 代码编辑器，今年 6 月 13 日升到 3.0，内核换成自研的 ZCode Agent，专门对接 GLM-5.2。3.0 之前还能当 Claude Code、Codex、Gemini 的统一外壳，3.0 之后这些第三方适配不维护了，专心跑 GLM。

装出来是个独立的桌面应用（Mac 和 Windows），不是 VSCode 插件，也不是命令行工具。

怎么用

下载装。去 zcode.ai 下安装包，装完打开，首屏让你配 API key。

配 key。ZCode 支持好几种 key 源：

• 智谱 GLM Coding Plan 编程套餐
• 智谱开放平台的模型资源包或充值余额
• 智谱 Z.AI
• OpenRouter（一个 key 接多家模型）
• 任何兼容 Anthropic / OpenAI 协议的服务，包括本地部署

在对话框右下角点 Select Model → Manager Models，按你用的协议填 key 和 base URL。3.0 之后默认走自研内核 + GLM-5.2。

打开项目目录。File → Open 打开已有项目，或者新建一个空文件夹。ZCode 就在这个目录里读文件、跑命令、改东西。

新建任务（快捷键 ⌘N）。任务是 ZCode 干活的基本单位。用大白话写需求就行，比如：

给这个 Express 项目加一个 /health 端点，写一个基础测试

Agent 自己拆任务、读相关文件、改代码、跑测试，整个过程每一步都看得见。删文件、改配置、联网这些高风险动作，会停下来问你。

四种权限模式

ZCode 把 agent 能做的事分成文件编辑、命令行、联网、搜索四类，预设了四档：

日常建议从「自动编辑」开始。变更前确认太碎，完全访问太野。

两个能力提一下

改历史对话再重跑。ZCode 的对话历史可以改——你在中间任何一条消息上改需求、改措辞，然后让 agent 从那条开始重新跑。不是重发一遍 prompt 那么简单，后面整段对话都重来。前面哪句话说错了，改掉，后面的动作跟着重跑。

手机远控。手机连上桌面端的 agent，在外面也能下任务、看进度。Claude Code、Codex 这种终端工具没这个能力。

和 Claude Code VSCode 插件比

很多人在这两个之间选。说实话，核心差别是你要不要离开 VSCode。

Claude Code 的 VSCode 插件配合终端工具用——你不用切窗口，agent 改文件直接在编辑器里显示 diff。ZCode 要切到独立窗口，但权限是图形化开关，任务流也看得见。

控制粒度也不一样。ZCode 用图形界面切权限，简单直观；Claude Code 靠 hooks 写脚本拦截，写起来麻烦点，但能精确到”不许动 payment_service.py 这个文件”这种程度。