很多人第一次打开 Claude Code，最紧张的地方往往不是功能不会用，而是不知道第一句话该怎么说。这个视频其实很短，讲的也不是复杂技巧，但它点醒了一个很容易被忽略的问题：Claude Code 的第一条 prompt，重点从来不在“修辞”，重点在你到底有没有把任务边界、风险偏好和执行节奏交代清楚。
这类入门视频最容易被人低估。标题看着像“新手教学”，很多人会默认里面只会讲一些很浅的 prompt 技巧，比如多写点上下文、描述得更具体一点、把目标说清楚一点。可 Claude 这个视频真正有价值的地方，不在这些泛泛建议，它真正提醒的是另一件事：Claude Code 不是一个只负责接话的聊天助手，它是一个会读代码、改文件、跑命令、规划步骤的执行代理。
一旦你把它看成执行代理，而不是纯聊天对象，第一条 prompt 的写法就完全变了。
一、第一次用 Claude Code，很多人其实是不知道自己在授权什么
视频一上来先讲的不是 prompt 模板，先讲的是 approval mode 和 auto accept。
这个顺序很对。
因为第一次用 Claude Code，真正该先搞明白的，不是“我要怎么提需求”。更重要的是“我准备把多大权限交给它”。
视频里说得很直白：
- 你可以让 Claude 自动接受文件修改和创建
- 也可以让它每次都先征求明确许可
- 即使在 auto accept 模式下，它跑命令时仍然会再问你
这里面最重要的，不是具体哪种模式更好，关键是它把一件事摆到了台面上：Claude Code 不是只在回答问题，它在实际动你的项目。
很多人第一次上手这类 coding agent 时，脑子里还是 ChatGPT 使用习惯。他们会把 prompt 理解成“我怎么把一句话说漂亮”，却很少先问：
- 这次我允许它改到什么层
- 我想不想每一步都看到
- 我更重视速度，还是更重视可控性
- 这是一个适合自动推进的低风险任务，还是一个应该先计划再执行的任务
如果这些问题没想清楚，prompt 再顺也没用。
因为 coding agent 的第一风险，从来都不在语言层，而在授权层。
二、所谓“第一条 prompt”，本质上是在定义任务合同
视频里的例子很简单，让 Claude 帮一个现有应用实现 dark mode，并在 header 上加 toggle switch，还要求它找一个和现有 light theme 匹配、对比度合适的颜色。
这个例子看起来朴素，但拿来做第一条 prompt 其实很典型。因为它同时具备几个特征：
- 有明确目标
- 有可见结果
- 有跨多个文件修改的可能
- 有一点实现判断空间
- 又不至于危险到一上来就动核心业务链
这类任务很适合拿来练手。
更关键的是，这个 prompt 本身已经暴露了一个好 prompt 的真实结构。它不只是句“帮我做 dark mode”，它其实在隐含定义一份任务合同：
- 做什么
- 全应用 dark mode
-
header 上有 toggle
-
做到什么程度
-
用户可以在 light/dark 间切换
-
有哪些额外约束
- 颜色要和现有 light theme 协调
- 对比度要合理
也就是说，好的第一条 prompt，不是文学表达，它首先是任务定义。
你不是在跟它聊天，你是在给一个能执行的代理下单。
这也是为什么很多新手一上来效果不好。不是模型不够强，问题在于他们说的是意图，不是合同。
像这种模糊说法：
- 帮我优化一下
- 做个暗黑模式
- 看看这里能不能改好
- 帮我把 UI 弄漂亮点
这些都像口头需求，不像执行需求。
而 coding agent 想跑稳，最需要的是可执行边界。
三、Plan mode 真正解决的，是“先别急着动手”
这条短视频里最值得注意的部分，其实是它特地讲了 plan mode。
这不是一个花哨功能，我反而觉得它是 Claude Code 最容易被低估的安全阀。
视频里的解释很清楚：
- plan mode 会先用只读工具分析代码库
- 会做实现调研
- 会在一些不清楚的地方反过来问你
- 最后给你一份更长、更细的执行计划
它适合什么？
- 复杂改动
- 多步骤特性开发
- 安全一些的代码审查
这个设计特别像一个成熟工程师真正会做的事。
因为真实开发里，最贵的错误往往不是代码写错了，更常见的是还没想清楚就开始改了。
很多人把 coding agent 的价值理解成“它可以立刻动起来”，但实际用久了以后会发现，真正值钱的能力恰恰是：它能不能先忍住别乱动，先把问题看一遍。
Plan mode 的意义就在这里。
它帮你把“先规划，再执行”这件事制度化了。
这背后其实对应的是两种完全不同的使用哲学：
响应式用法
- 想到一个需求
- 立刻叫它改
- 改完再看结果
规划式用法
- 先让它读代码
- 先形成修改路线
- 先暴露潜在问题
- 再决定是否执行
前一种快，但容易漂。
后一种慢一点，但稳得多。
而且对于第一次写 prompt 的人来说，plan mode 还有一个特别隐性的好处：它会逼你面对自己需求里的模糊点。
很多时候，人以为自己已经说清楚了。等 Claude 开始规划、开始反问，才发现真正不清楚的是自己。
这不是缺点，反而是很好的反馈。
因为 coding agent 真正高级的地方，从来不只在“照做”，还在于它能把需求里的空洞提前照出来。
四、为什么它反复强调“尽量描述得具体”
视频最后给了一个很常见的建议：用 Claude Code 时，要尽可能描述得具体。
这句话单看很普通，几乎所有 prompt 教程都会这么说。可放在 Claude Code 这个场景里，它的意思其实更窄，也更工程化。
这里的“具体”，不是让你把一句话写得更长，重点是把下面这些东西讲清楚：
- 改动范围
- 结果形态
- 风格约束
- 风险偏好
- 是否允许它自主推进
- 哪些地方需要先问
- 哪些标准用来验收
也就是说，具体不等于啰嗦。
很多人会误把“更详细”理解成“多写一点背景废话”。但 coding agent 最怕的不是信息少，它更怕有效约束少。
比如这两种写法差别就很大：
差的写法
帮我做个暗色模式，整体舒服一点。
好的写法
请在整个应用中实现 dark mode，并在 header 增加一个 toggle switch 让用户可以在 light/dark 之间切换。请基于现有 light theme 选择对比度合理、视觉一致的暗色方案。先进入 plan mode，阅读代码结构后给出改动计划，再等我确认执行。
后面这段并不华丽，但它把：
- 范围
- 交互点
- 风格要求
- 执行节奏
都说明白了。
这就是 coding agent 真正需要的“具体”。
五、第一条 prompt 最容易犯的错，其实有三种
看完这类视频，最容易发生的情况往往不是完全不会用，而是半懂不懂地开始乱用。
我觉得第一条 prompt 最常见的坑有三种。
1）把 Claude Code 当搜索助手用
有些人第一句就是：
- 这个项目是干嘛的
- 你帮我看看这代码写得怎么样
- 解释一下这个仓库
这类问题当然不是不能问，但如果目标本来是做事情，那一上来就完全停在泛问答层，很容易浪费掉 Claude Code 作为执行代理的真正价值。
更合理的方式通常是：
- 给它一个具体任务
- 允许它先读代码
- 顺带在过程中理解仓库结构
这样它既在完成事，也在建立上下文。
2）任务太大，边界太虚
第一条 prompt 如果直接上：
- 帮我重构整个项目
- 帮我提升性能
- 帮我把架构优化一下
这种通常都容易翻车。
不是模型一定做不到，更常见的情况是第一次上手时，人自己也还不知道这套代理在哪些边界最舒服，哪些情况下需要更强约束。任务太大、边界太虚，只会让结果难以验收。
第一次最适合的，是那种：
- 范围有限
- 结果可见
- 能够快速检查对错
- 就算做坏了也容易回滚
dark mode 就是非常典型的练手题。
3）一上来就交出全部执行权
很多人会因为新鲜感，直接切到最放飞的模式，恨不得让 agent 自己一路跑到底。
这在低风险任务里偶尔没问题，但第一次上手这么做，其实很容易形成错误的使用习惯。
更好的顺序通常是：
- 先用 approval mode 熟悉它会怎么动
- 再用 plan mode 理解它会怎么想
- 最后再逐步提高自动推进的比例
因为真正需要建立的，不只是“它能不能做”，还有“我能不能看懂它在怎么做”。
六、这条视频虽然短，但背后其实指向一条更成熟的 agent 使用路径
如果把这条视频往深一点翻，会发现它其实在传递一套很成熟的使用顺序：
第一步：先定义权限边界
approval mode 还是 auto accept，不只是体验选项，它是在决定代理能走多远。
第二步：先定义任务合同
别只说目标，要把范围、约束、验收口径讲清楚。
第三步：复杂任务优先 plan mode
先读代码、先做计划、先暴露疑点，再执行。
第四步：看执行痕迹
视频里还特地提到，执行完后你能明确看到 Claude 做了什么、怎么得出这个结论。
这件事特别重要。
因为 coding agent 不是 magic box。你真正想建立的，不是“它替你神奇完成了”这种幻觉，你真正想建立的是“它替你跑完之后，你还能看懂整个过程”。
这和前两天聊的那些 AI 依赖问题其实是连着的。
工具越强，越不能只盯结果。
你得保住两件事：
- 自己还能判断它的计划是不是靠谱
- 自己还能理解它最后到底改了什么
否则第一条 prompt 写得越顺，后面越可能把自己带到“它写得很像对，但我其实没掌控”的状态里。
七、如果把这条视频压成一句最有用的话
如果只能记住一句，我会记这个：
Claude Code 的第一条 prompt，不是写给聊天模型的，是写给执行代理的。
这两者差别很大。
写给聊天模型，你追求的是：
- 让它懂你在说什么
写给执行代理，你追求的是：
- 让它知道该做什么
- 做到什么程度
- 先想还是先做
- 什么时候该停下来问你
- 你会按什么标准验收它
一旦把这个角色切对，很多所谓的 prompt 焦虑会立刻降下来。
你不需要想一句“最厉害的话”。
你需要的是一份足够清楚的任务说明。
这也是为什么我觉得这个视频虽然短，但挺适合发给第一次接触 Claude Code 的人。
它没有教花招，反而帮人把姿势摆正了。
第一次用 Claude Code，最重要的不是显得会用，最重要的是别把它用成一个你自己都没想清楚的自动执行器。先把权限想清楚，先把任务讲清楚，复杂任务先计划，再执行。把这三件事养成习惯，后面很多坑会少一大半。
附：视频信息
- 视频来源：https://www.youtube.com/watch?v=gbetp6D7J_Q
- 演讲标题：Your first Claude Code prompt
- 频道：Claude