这一章训练的能力：选一个 AI 编程工具，把想法说清楚，做出能运行的小作品，并亲自验收。
vibecoding = 想法描述 + AI 编程工具执行 + 人来验收 + 反复迭代。
你不需要先成为程序员，但需要学会描述需求、检查结果和反馈问题。先做出一个能打开的网页，再逐步学习代码和项目知识。
一、先选一个入口
本教程的提示词适用于能打开本地项目并修改文件的 AI 编程工具。第一次练习建议选 TRAE：从官网下载安装，打开一个空文件夹，就可以开始描述需求。其他工具可按场景选用。界面、功能、系统支持和价格会变化，以各官网实际页面为准。
| 工具 | 更适合的任务 | 官方入口 |
|---|---|---|
| TRAE（字节跳动） | 从想法开始制作网页或小项目，适合本教程的入门练习 | 官网与下载 |
| CodeBuddy（腾讯云代码智能体） | 阅读和修改已有代码项目 | 官网 · 桌面端 · 网页版 · 官方安装说明 |
| WorkBuddy（腾讯） | 在办公场景中处理文件、表格，或尝试轻量应用 | 官网与下载 |
| 通义灵码（阿里云） | 在编辑器中获得代码解释、补全和修改建议 | 官网 · 下载与安装 |
想从零做本章的小网页，先用 TRAE；已有代码项目可试 CodeBuddy；主要处理办公文件可试 WorkBuddy；已经在 VS Code 或 JetBrains 中写代码，可试通义灵码。具体功能和可用额度请查看官方页面。
二、从官网下载并打开工具
以下以 Windows 上的 TRAE 为例。Mac 或 Linux 用户在同一官网选择适合系统的版本；若官网没有对应入口，以页面实际支持情况为准。
- 打开 TRAE 官网，找到“下载”或“下载中心”，选择自己的系统。
- 打开下载的安装包，按屏幕提示完成安装。只使用官网给出的安装包。
- 从开始菜单打开 TRAE，按页面提示登录。
- 在电脑上新建一个文件夹，例如
D:\vibecoding\reminder，在工具中选择“打开文件夹”并选中它。 - 找到对话输入框，准备粘贴下一节的提示词。按钮名称可能随版本改变，可把当前界面截图发给工具，问它下一步点哪里。
成功标志： 工具打开了你新建的文件夹，能看到对话输入框，并能回复你的问题。
如果失败，下一句这样问：
我是 Windows 新手。我正在从官网安装并打开 AI 编程工具，卡在这一步：（写出页面上的文字或报错）。
请只告诉我下一步点哪里；如果需要检查文件，请告诉我文件在哪。不要让我去第三方网盘下载安装包。
使用 CodeBuddy、WorkBuddy 或通义灵码时，同样先从上表的官方入口进入。CodeBuddy 的桌面端和网页版适合不同设备；通义灵码可按下载页选择编辑器插件或独立产品。不同工具的项目入口和自动改文件能力不同，看到的按钮以实际界面为准。
三、直接复制第一条提示词
你要做的事：做一个可以在浏览器打开的“输液提醒闹钟”网页。
【可直接复制给 AI 编程工具】
我是编程小白。请在当前文件夹做一个最简单、能运行的输液提醒闹钟网页。
要求：
1. 可以输入总分钟数，点击开始后显示倒计时；
2. 时间结束后在页面上明显提醒；
3. 页面适合手机查看；
4. 优先使用一个 HTML 文件完成，不要先引入复杂依赖；
5. 完成后告诉我创建了哪些文件、在 Windows 上双击哪个文件能看到效果；
6. 请说明我该怎样手动检查功能是否正常。
【AI 正常会返回什么】
- 创建或修改网页文件，通常是
index.html； - 告诉你怎样打开页面；
- 简单说明它做了什么以及怎样测试。
需要你手动做： 在文件夹里双击 index.html，用浏览器打开。输入 1 分钟，点击开始，看看倒计时是否变化；提醒功能也要亲自检查。工具若给出本地预览地址，按它的说明打开。
成功标志： 页面可以打开，输入框和按钮可用，倒计时运行，结束后出现提醒。
四、结果不满意，继续追问
如果页面能用但还不符合你的想法，不用从头重做。说清楚“现在怎样”和“想改成怎样”。
【可直接复制给 AI 编程工具】
页面已经能打开。请只做这三处改进：
1. 开始按钮更明显；
2. 增加暂停和重置按钮；
3. 手机上文字不要挤在一起。
修改后请告诉我改了哪个文件，以及我该怎样验证这三点。
【AI 正常会返回什么】 修改过的文件、每项改动的说明和检查方法。你应刷新浏览器，再逐项点击验证。
如果项目运行失败，把完整报错交给工具。
【可直接复制给 AI 编程工具】
我按你的步骤操作后失败了。下面是完整报错：（粘贴报错文字）。
请先用一句话解释它的意思，再告诉我只需要做的下一步。
如果你能检查当前项目，请先检查，不要猜测。
【AI 正常会返回什么】 报错原因、需要检查的文件或操作，以及一次只做一个修复步骤。修完后重新运行，确认原来的问题是否消失。
五、账号、额度和密钥怎么处理
本章的单文件网页练习通常不需要单独购买 API、充值第三方平台或配置 API Key。先用工具官网提供的登录方式完成练习。若工具提示额度不足、要求订阅或需要密钥，先看该工具官方页面的实际说明和费用，再决定是否继续。
API Key 可以理解为访问服务的专用密码。以后做需要调用外部服务的项目时，只从服务商官方页面获取密钥；不要把真实密钥发进聊天、截图、公开仓库或教程。让工具先说明费用和密钥会保存在哪个文件，再决定是否配置。
六、常见卡点
| 看到的问题 | 先检查什么 | 下一句怎么问 |
|---|---|---|
| 安装包打不开 | 是否从官网选对了系统版本 | “这是安装提示截图，请告诉我下一步点哪里。” |
| 找不到项目文件 | 工具是否打开了正确的文件夹 | “请告诉我你创建了哪个文件，以及它在电脑上的位置。” |
| 页面没有变化 | 是否刷新了浏览器，是否打开了刚修改的文件 | “请检查我打开的网页文件是否是你刚修改的那个。” |
| 运行时报错 | 复制完整报错，不只发最后一句 | “请先解释报错，再给我一个最小修复步骤。” |
| 提示付费或密钥 | 查看工具官方额度和费用说明 | “这个练习能否只用本地 HTML 完成？请不要替我购买服务。” |
七、本章保存的提示词
本章可复用的三条提示词是：创建最小可运行版本、限定范围继续改进、粘贴完整报错请工具排查。以后换项目，只需替换目标、功能和验收步骤。
你已经练习了第一种 vibecoding 能力：把想法变成可运行结果，再亲自检查并提出下一轮修改。下一章会用 Python 解释编程语言、编码、调试、依赖和启动命令，让你逐渐看懂工具在做什么。