AI 开发者工具包安装
学习目标
到本节课结束，学员应当能够：
- 装好并登录整学期要用的三套 AI 编码环境 —— Cursor（主力 IDE）、Claude Code（终端原生 AI）、Gemini CLI（免费额度的脚本型 AI）—— 并知道什么时候该用哪一个。
- 给 Claude Code / Cursor 装上一个 Skill 和一个 MCP 服务器，并能用一句话说清每个扩展让 AI 能替学员做什么。
- 识别并应用授权规则 —— 知道哪些操作该通过 CLI 或 MCP 交给 AI，哪些（OAuth、DNS、provider 侧凭据）必须自己动手。
核心主题
- "自然语言就是源代码"为什么是这门课的主轴——以及它如何改变学员对编程的思考方式。
- 三套 AI 环境：Cursor、Claude Code、Gemini CLI —— 分别在什么场景下用。
- MCP 服务器和 Skills 是什么，它们如何把一个 AI 聊天变成会用工具的 agent。
- Voice-first 提示词（可选但强烈推荐）—— Wispr Flow。
- GitHub 作为"唯一真实数据源"那一层，后面每一周的部署链路都依赖它。
工具 / 技术栈
| 工具 | 在本学期的作用 |
|---|---|
| Cursor | 主力 IDE；内置 AI 聊天；整学期的周课工作都在这里发生 |
| Claude Code | 终端原生的 AI，带 MCP + Skills；第 8 周 PDF 流程的首选 |
| Gemini CLI | 免费额度的 AI，适合一次性脚本和快速探索 |
| Wispr Flow | 语音转文字；不用敲字就能口述长提示词 |
| GitHub | 唯一真实数据源；自动触发每一次 Vercel 部署 |
| Vercel CLI | AI 调它来部署、读日志、管理环境变量 |
| Neon CLI + Neon MCP | AI 调它来开数据库和 Auth（从第 4 周开始） |
| Typst skill | AI 调它生成像素级精致的 PDF（第 8 周会用到） |
课堂计划
| 时间 | 活动 |
|---|---|
| 0 – 15 分钟 | 回顾与 Check-in。 第一节课——没有回顾。10 分钟破冰：每个人讲一讲他们在看过 Cursor demo 之前 和 之后 对"编程"这件事的理解。 |
| 15 – 40 分钟 | 概念讲解。 授权规则。我们为什么让 AI 去跑 CLI。MCP 服务器是什么。声音 + AI 如何改变那些"非常吃键盘"的活儿。现场比一比：同一个任务，Cursor vs Claude Code vs Gemini CLI。 |
| 40 – 75 分钟 | 现场演示。 讲师从零打开 Cursor，装上 Vercel MCP，然后对 Cursor 说："把一个空的 Next.js 站点部署到我的 Vercel 账号。"全班看着 AI 调 Vercel CLI、审批、部署、返回一个活的 URL。 |
| 75 – 105 分钟 | 动手 Lab。 每位学员在自己笔记本上把这遍演示复现一遍，结束时拿到一个可以分享的 *.vercel.app URL。 |
| 105 – 120 分钟 | Q&A + 收尾。 全班一起排错。所有人下课时都带着能工作的工具走。 |
动手 Lab
任务。 从"什么开发者工具都没装"走到"Cursor 刚刚在我 Vercel 账号里部署了一个空的 Next.js 站点，而且整个过程我是亲眼看着它发生的"。这是整学期唯一一堂"手动配置多于平常"的课——从第 2 周开始，几乎每一步都只是一句口述。
如果你在第 1–4 步（安装）落后了，别慌。目标是在下课前走完第 7 步（你的第一次 AI 驱动的 Vercel 部署）。安装可以继续挂在后台——Claude Code 可以一边在后台下载，一边 AI 已经能开始干活。
阶段 1 —— 装好三套 AI 环境
从 cursor.com 下载安装 Cursor。打开它，用 GitHub 登录，接受条款。当 Cursor 问你 "Would you like to import VS Code settings?" 时选 Skip —— 我们要一个干净的环境。
Why manual: Cursor 的安装器 + GitHub OAuth 需要点击和同意页，任何 CLI 都代替不了你。
按 官方快速开始 的步骤安装 Claude Code。在 Windows 上运行安装器，一路用默认值。当它提示登录时，用你的 Anthropic 账号登录。
Why manual: Anthropic 的登录流程会打开浏览器走同意，必须人参与。
按 Google 的 readme 安装 Gemini CLI。在任何终端（Cursor 自带的终端也行）里跑 npm install -g @google/gemini-cli，然后 gemini login，用 Google 账号登录。
Why manual: 装 Node + 登录 Google 两步都需要同意页。
Wispr Flow（wisprflow.ai）让你用口述代替敲字。从第 5 步往后，每一步都是一句口述——Wispr Flow 会让你这学期剩下的时间都舒服不少。
阶段 2 —— 证明 AI 会动手
我刚装好你。你能不能做个自我介绍，告诉我你现在能调用哪些工具（比如能不能在终端跑 shell 命令、能不能读写硬盘上的文件、能 不能打开网页？），然后在我 home 目录下新建一个叫
technest-week-1的空文件夹？建好以后，把它作为 Cursor 工作区打开。
- Cursor 用它自己的话报告了它的能力——花一点时间读一读。
- 你的 home 目录下出现了一个叫
technest-week-1的文件夹。 - Cursor 窗口现在就在这个文件夹里（左侧文件树看得到）。
阶段 3 —— 装一个 MCP 服务器，让 AI 能操作 Vercel
请给我装上 Vercel MCP 服务器，这样你能替我调 Vercel 的 API。把它加到我的 Cursor 配置里。装好以后，告诉我它给你带来了哪些工具——我想看一看这张清单。如果 MCP 服务器需要我粘一个 Vercel token，请先停下来，告诉我这个 token 具体去哪里取，再继续。
当 Cursor 暂停并问你要 Vercel token 时，在浏览器里打开 vercel.com/account/tokens，登录，点 Create Token，名字起作 cursor-mcp，复制 token，粘回 Cursor 的聊天窗。
Why manual: Vercel 不通过任何 API 暴露账号级 token——只能在网页控制台里手动建。
- Cursor 打印出它现在拥有的 Vercel 工具列表（创建部署、读日志、管环境变量等等）。
- 没有报错。
阶段 4 —— "哇哦"时刻
现在向我证明这个"授权模型"真的能跑通。在这个文件夹里新建一个全新的空 Next.js 项目（叫它
hello-technest），初始化 git 仓库，把它推到我 GitHub 账号下一个新的公开仓库，然后通过 Vercel MCP 部署到 Vercel。部署上线后，在我浏览器里打开生产 URL。整个过程中请合理地 commit 并写清楚的 commit message。我只负责看。
- 你的浏览器打开了一个 线上
hello-technest-*.vercel.appURL，显示 Next.js 默认的 starter 页。 - 你的 GitHub 账号里出现了一个新仓库。
- 本地文件夹里有 Cursor 替你写的一串合理的 commit 历史。
部署失败了，有个 build error。你能不能通过 MCP 读一下 Vercel 的 build log，找到根因，修一下，再重新部署？在我们进行下一步之前，我希望那个生产 URL 能无报错地打开。
阶段 5 —— 换一个 AI 试试手感
打开一个终端，
cd进hello-technest，确认你能看到这个项目。然后从 Anthropic skills registry 里装上 Typst skill。装好以后告诉我，你现在能处理哪些类型的提示词。
- Claude Code 确认 Typst skill 已安装。
- 它列出了几条它现在能响应的提示词，比如 "generate a PDF"、"compile a typst file"。我们在第 8 周会用到这一条。
阶段 6 —— 把授权规则内化掉
让 AI 去做：开资源、环境变量管道、git、装依赖、改代码、迁移 schema、部署、生成 PDF——全部通过 CLI、API、MCP、Skill。只有你自己能做的事：OAuth 同意页、在 provider 站点建 API key、DNS、以及偶尔某行 .env.local（因为没有任何 CLI 能设它）。拿不准的时候，直接问 AI 这件事属于哪一类 —— 这是一个完美的提示词："这件事你能通过 CLI 做，还是需要我自己来？"
本周作业
做 / 交付。
- 一个全程由 AI 调 CLI 部署出来的
*.vercel.app线上 URL。 - 一张 Cursor 对话截图，展示你用哪一句提示词触发了部署。
- 第二张截图，展示 Vercel MCP 的 tool-call 输出。
要求。
- 仓库必须在你自己的 GitHub 账号下。
- 部署必须是 AI 触发的，而不是你自己手动跑
vercel deploy（这是整学期的重点）。 - Cursor 和 Claude Code 必须都装好，而且 Claude Code 里已经加载了 Typst skill。
提交。 在第 2 周开课前，把这三样（线上 URL + 两张截图）发到课程 Slack 频道里。
资源
| 文档 | 视频 | 仓库 |
|---|---|---|
| Cursor 官方文档 —— 入门 | 讲师的 "first AI deploy" 演示录屏 | her-waka/tutorial/vibe-coding —— 给好奇学员的深入版 |
| Claude Code —— quickstart | Fireship —— "Cursor in 100 seconds" | anthropics/skills —— Skill registry |
| Vercel MCP server —— readme | ||
| Wispr Flow —— setup |
真实世界应用
2026 年任何一家做 AI 工程的公司，在面试时都会让你 演示一次工作流，而不是背语法。招聘经理想看到的是：候选人打开 Cursor，描述一个功 能，10 分钟后一个线上 URL 就出来了——因为他们团队里的资深工程师已经是这种工作方式。今天的 Lab 就是那段面试素材：你用一句口述拿到了一个线上 URL。请把屏幕录屏存好。
下一周可以更新的 LinkedIn bio："Full-stack AI developer · I prompt, I ship · vercel.app/my-project"。
踩坑提醒 & 小贴士
- "Cursor 每条 shell 命令都让我确认。" 这是好事——课堂环境下保留手动审批。第 3 周之后如果你想迭代更快，可以给低风险命令开自动批准。
- "MCP 服务器说 'authentication required'。" 你的 Vercel token 丢了或过期了。从
vercel.com/account/tokens重新生成一个并粘回来。 - "Gemini CLI 提示我超了 rate limit。" 本节课剩下的时间用 Cursor 或 Claude Code。Gemini 免费额度每小时重置。
- "我搞不清这一步该我做还是该问 AI。" 直接问："这件事你能通过工具做，还是需要我自己做？" AI 会如实回答。
- "我的提示词不够具体——AI 总在追问。" 仔细看这堂课讲师用的提示词。好的提示词会写明：AI 应该用哪个工具、手里有哪些输入、以及什么信号表示任务完成。
把你最后一条提示词 加上 AI 最后一条回复，粘到一个全新的 Claude Code 窗口里，说："这条没跑通。最可能的下一步是什么，为什么？" 把卡住的 AI 会话当成一个可以重启、可以检视、可以重定向的调试对象——这是这门课最重要的一个能力。