把 AI Agent 装进你的项目

灶台（Node）有了，菜板（编辑器）有了，这一篇来请"厨师"——把 AI Agent 装到你的项目里。

装完它，第 2 章学的那些"提需求、看代码、修错"的本领，就第一次有了用武之地。

回顾一下：智能体编辑器，AI 已经内置

第 2 章我们盘点过两个主力编程 Agent：Cursor 和 ZCode。

它们有一个共同点——都是"开箱即用的智能体编辑器"：AI 直接内置在编辑器里，你下载安装好，就有了"工作台 + AI 助手"，不用再单独装什么 AI。

所以这一篇的"装 Agent"，其实非常简单：如果你上一篇已经装好了 Cursor 或 ZCode，那 Agent 其实已经在你电脑里了，剩下的只是"登录激活、确认能用"。

如果你选的是 VS Code（它本身不带 AI），那需要先装一个 AI 插件（比如 Cursor 或 ZCode 官方提供的插件）。这种情况配置稍多一点，建议新手直接用 Cursor 或 ZCode 更省事。

激活你的 Agent：登录就能用

不管你用的是 Cursor 还是 ZCode，激活步骤基本一样，全程图形界面，不用敲命令：

1. 打开编辑器，按提示登录账号（邮箱注册一个就行）
2. 登录后，AI 功能就激活了（一般有免费使用额度）
3. 找到 AI 面板（通常在侧边栏有个对话图标，点一下就出来）

打开 AI 面板后，试着对它说一句最简单的话，比如：

你好，请用一句话介绍你自己。

如果它回答了，恭喜你——你的 Agent 已经就位。整个过程不用敲任何命令，登录就能用。

如果登录或激活时卡住了（网络问题、提示报错等），老办法：把提示信息截图或复制下来，贴给第 2 章说的"对话式工具"（ChatGPT、豆包）问"我在激活 XX 编辑器时遇到这个提示，怎么解决"。等你的 Agent 激活好，以后这类问题就都能直接问它了。

和 Agent 说第一句话

不管你用的是 Cursor 还是 ZCode，装好后都来做一件事：和它说第一句话，确认它真的能干活。

在 Agent 的输入框里，对它说：

在当前文件夹里帮我创建一个文件，叫 hello.txt，内容写"我的第一个 Agent 作品"。

回车，看它操作。如果一切正常，它会自己创建这个文件。你打开左边的文件树，就能看到 hello.txt 躺在那里。

这一刻很重要——你刚刚第一次"指挥 AI 动手"成功了。这就是 Agent 驱动开发的最小闭环：你说 → 它做 → 你验收。

如果它没成功，检查两点：① 你是不是在编辑器里打开了一个文件夹（Agent 需要知道在哪干活）② 报错的话，把报错给它看。打开文件夹的方法：编辑器菜单"文件 → 打开文件夹"，选一个空文件夹（可以先新建一个，比如叫 my-first-app）。

把第 2 章的本领用起来

现在 Agent 就位了，是时候把第 2 章学的"能力包"真正用起来了。回忆一下那五样：

1. 会提需求：说清楚目标、背景、约束、期望
2. 会看代码：三层法看懂 AI 写的东西
3. 会修错：复制报错 + 贴代码 + 按建议改 + 跑验证
4. 选对工具：知道 Cursor 和 ZCode 各擅长什么
5. 会验收：跑起来看效果，不盲信 AI

从这一刻起，这些不再是理论——你接下来每一次和 Agent 打交道，都在用它们。比如下一篇建项目时：

• 你要"提需求"：告诉 Agent 建一个什么样的项目
• 它会"干活"：创建文件、装依赖
• 你要"验收"：看项目跑起来没有、长得对不对

这套"你指挥 → Agent 干活 → 你验收"的循环，就是后面整门课的工作方式。而你刚刚装好 Agent、说通第一句话，已经把这个循环跑通了第一圈。

本篇小结

• Cursor 和 ZCode 都是"开箱即用的智能体编辑器"，AI 已内置，登录账号即激活（不用敲命令）
• 装好后和它说第一句话（比如让它建个文件），验证它真能动手
• 需要先在编辑器里打开一个文件夹，Agent 才知道在哪干活
• 卡住、报错都是正常的，把报错丢给 AI 解决
• Agent 就位 = 第 2 章的"提需求/看代码/修错/验收"第一次实战

下一篇，是本章的高潮——用 Agent 创建你的第一个 Next.js 项目，并把它跑起来。很快你就能在浏览器里看到自己项目的雏形了。