本篇导读

预计阅读时间：6 分钟。读完你会装好 Agent 客户端 Zcode，并且明白安装过程中每一步在做什么。这是全教程第一次动手，跟着做就行。

从这一章开始动手。我们以 Zcode 为例（为什么选它，第 1 章说过：对新手友好、模型可自由更换、功能完整）。再次说明：工具只是外壳，概念全部通用，如果你想尝试别的 Agent，操作流程也基本一致。

下载与安装

1. 打开 Zcode 中文官网：zcode.z.ai/cn。
2. 点击页面上的 立即下载 按钮，下载 Windows 版安装程序（.exe 文件）。
3. 双击运行，一路按安装向导点下去，安装时选择仅为我安装，默认路径，完成后从开始菜单或桌面快捷方式启动。

就这么简单，它是一个普通的桌面软件，和你装 QQ、浏览器没有区别。

两个可能遇到的小状况：

• 杀毒软件拦截：个别杀软会对新下载的安装程序报警，属于误报，将安装目录加入白名单即可。
• 第一次启动：会弹出欢迎引导界面，注册账号（否则很多工具无法正常使用），跟着走就行，后面一步（连接模型）我们在下一节细讲。

装好之后你拥有了什么

打开 Zcode，你会看到一个聊天窗口——先别失望：「这不还是聊天框吗？」

不一样。这个窗口背后挂着一整套 Harness（第 1 章讲的身体）：它能读你电脑上的文件、能执行命令、能搜索网页。你马上就能验证。

一个直观的检验方法：对它说「看看我的桌面上有什么文件」。聊天框里的 AI 只能瞎编，而它会真的去查找你的桌面路径，然后把文件名列给你。

运行模式说明

Zcode 对「Agent 能自作主张到什么程度」设了几档权限模式，初学者尽量保持默认的变更前确认——否则它可能会在你不知情的情况下，错误地删除不该删的东西，或修改对你来说比较重要的文件。几档模式的差别，3.1 节会详细展开。

下一节：给它接上大脑

客户端装好了，但它现在还没有脑子——Zcode 默认没有绑定任何模型，你跟它说话它也答不上来。

下一节我们解决「大脑」的问题：什么是 API Key、为什么要接入第三方模型，以及怎么在五分钟内配好。