15分钟做完一个电影App：Claude Code新手上手的真正秘诀

这是一篇基于 Peter Yang 的实操视频整理的深度文章。你将看到 Claude Code 如何从零安装、理解代码库、运行真实项目，并在严谨规划下完成一个 Watch List 功能。更重要的是，文章提炼了“先规划、再生成”的 AI 编程方法论，这是视频最有价值的部分。

为什么他说 Claude Code 是“目前最好的 AI Agent”？

在视频一开始，Peter Yang 就给出了一个非常明确的判断：“I think Claude Code is the best AI agent available in the market today.” 这并不是一句营销式的夸赞，而是贯穿整支视频的实践结论。他并没有用复杂案例证明模型多聪明，而是选择了一个更残酷也更真实的标准：一个新手，能不能在 15 分钟内，用 AI 把一个真实项目跑起来，并且加完功能。

这也是这个教程最重要的独特视角。Peter 并不假设你是资深工程师，反而在向 Claude 提问时，特意补充背景：“假设我是一个有 10 年以上经验的 PM，但不是工程师。”这个细节非常关键，它直接影响了 Claude 输出的解释深度和语言风格。结果是，Claude 给出的代码库讲解不是堆技术名词，而是从用户体验、整体架构和数据来源讲起。

这里的洞见在于：Claude Code 的价值，不只是“写代码更快”，而是它能在不同角色视角之间自由切换。当你不会写代码时，它可以是技术翻译器；当你准备加功能时，它又能变成架构师和执行者。这种角色弹性，是 Peter 认为它领先于其他 AI Agent 的核心原因。

从零到可运行：一次真实的 Claude Code 安装与克隆体验

视频中最有说服力的部分，是 Peter 几乎不做剪辑地展示整个安装过程。Claude Code 的安装方式非常直接：在官方文档中复制一行命令，粘贴到终端即可完成安装，随后输入 claude 就能启动。这种“单行命令即用”的体验，是他反复强调的友好之处。

不过更有意思的是，他并没有选择只在终端里使用，而是切换到了 Cursor 这个 IDE。他坦诚地说了一句略带玩笑的话：“Apologies to the Cursor team， but these days instead of using the Cursor agent， I prefer to just open terminal in Cursor and type claude.” 这句话点出了一个真实趋势：AI Agent 正在从 IDE 自带能力，转向独立、可嵌入任何环境的工具。

随后，他用 Claude 直接克隆了一个 GitHub 上的电影发现应用。整个过程几乎没有手动操作，只是告诉 Claude 去 git clone 项目。几秒钟后，项目就完整出现在 Cursor 中。这个案例本身并不复杂，但它传达的信息很明确：Claude Code 已经足够稳定，可以承担“项目初始化”这种基础但关键的工作。

让 AI 先解释代码，而不是先改代码

在很多 AI 编程翻车的案例中，问题并不出在模型不会写代码，而是它在不理解现有代码的情况下贸然修改。Peter 在这里做了一个非常值得借鉴的示范：在任何开发动作之前，他先让 Claude 解释整个代码库。

他对 Claude 的指令是：“Tell me how this app actually works.” 并且再次强调自己是 PM，而不是工程师。Claude 的响应方式也因此发生了变化：它没有逐行解释代码，而是先给出产品层面的总结——这是一个“Netflix-like browsing experience”的电影和电视发现应用；然后才进入技术架构，说明数据来自 TMDB（The Movie Database），前端使用 TypeScript 和 Tailwind CSS。

一个很真实的细节是，Peter 直接说：“There’s a bunch of stuff here that I don’t fully understand.” 他并没有假装自己都懂，而是把 Claude 当成一个可以随时请教的技术合伙人。这种姿态，反而让 AI 的价值最大化。对于非工程背景的人来说，这一步几乎决定了你后续是否敢继续让 AI 动手。

真正的关键：Plan Mode、Spec 和 claude.md

如果说前面的内容只是展示 Claude Code“能做什么”，那从 Watch List 功能开始，视频才进入真正的方法论层面。Peter 特别强调：不要一上来就让 Claude 写代码，而是先写规格说明（spec）。

他使用了 Claude Code 的 Plan Mode（通过 Shift + Tab 进入），并明确指出这一模式“只做研究和规划，不会改动代码”。他的需求描述也刻意保持克制：“keep things simple so I can test along the way”，并提醒观众这是“非常重要的一行”，因为模型很容易过度设计。

Claude 生成 spec 后，甚至开始自动实现功能，但 Peter 选择了中断，先人工审查规格，删除了不必要的功能，比如 toast 通知和批量操作。这一步体现了一个成熟的 AI 使用原则：你必须对 scope 保持绝对控制。

在真正编码前，他还让 Claude 通过 /init 创建了一个 claude.md 文件。这个文件会在每次 Claude Code 会话中被加载，相当于项目的“长期记忆”。里面包含环境配置、架构说明、组件规范，以及后续补充的最佳实践。最终，当 Claude 根据 to-do list 开始实现 Watch List 功能时，几乎没有出现返工。这也是 Peter 给出的最终结论：“The more planning you do up front， the more likely Claude will build features without issues.”

总结

这支 15 分钟的教程，表面上是在教你用 Claude Code 做一个电影 App，但真正的价值在于它展示了一种全新的协作方式：把 AI 当成一个需要被管理、被引导的高级执行者。安装、克隆、理解、规划、再实现，每一步都有明确边界。对读者最大的启发是：AI 编程的上限，往往不是模型能力，而是你是否愿意在动手前多花 10 分钟做规划。

关键词： Claude Code， AI Agent， Cursor， Plan Mode， Watch List

事实核查备注： 视频作者：Peter Yang；产品名称：Claude Code、Claude、Cursor；数据源：TMDB（The Movie Database）；功能示例：Watch List（收藏/移除/本地存储）；端口号：localhost：5173；关键文件：claude.md；模式名称：Plan Mode（Shift + Tab）