阅读时长约15分钟 · 难度★★☆☆☆ 适合人群已经开始用 Director Mode但偶尔遇到 Claude 做歪了的开发者 学完之后你能快速判断偏差类型用最少的轮次把结果修正到位做好了心理准备但还是翻车了《Claude Code 从入门到精通》试读篇Claude Code 是什么你可能从第一步就用错了《Claude Code 从入门到精通》试读篇你的第一次 Director Mode 体验二你按第03课的模板写了一个很完整的 prompt。四个要素都有目标清晰约束明确。发出去等了两分钟Claude 做完了。你一看——不对。不是完全不对是七八成对但有些地方明显不是你想要的。这时候大部分人的反应是两种极端极端A算了我自己来改吧。放弃 Claude退回手动模式极端B把整个 prompt 改了重新发每次都从零开始。时间全浪费了两种都不对。极端A的问题是你花了2分钟等 Claude 生成了80分的结果然后扔掉这80分从零开始手写。那你用 Claude Code 干什么呢极端B的问题是每次从头来Claude 也从头来之前做对的部分全部白费。而且你改了 prompt 之后之前对的地方这次可能又不对了——按下葫芦浮起瓢。正确的做法是纠错不是重来也不是放弃。纠错是一项独立的能力。prompt 写得好是进攻能力纠错做得好是防守能力。这节课教你防守。先调整一个预期在讲具体方法之前先说一个很多人不愿意面对的事实Claude 第一次就100%做对是小概率事件。不是 Claude 不行是软件开发本身就是迭代的过程。你跟一个真人同事说给这个接口加输入验证他第一次提交的 PR 你就完全满意、不需要任何修改的概率有多大大概率也是要改一两轮的。区别在于跟真人同事你习惯了 code review 修改这个流程跟 Claude你却期望一步到位。放下一步到位的执念接受80分→纠正→95分的流程你的效率反而更高。因为 Claude 生成80分的代码只要2分钟你纠正到95分再花5分钟总共7分钟。你自己从零写到95分可能要40分钟。好心态调好了讲方法。三种理解偏差先判断是哪种Claude 做出来不对不外乎三种原因。判断是哪种纠正方式完全不同。用错了纠正方式比不纠正更浪费时间。偏差类型1方向对了细节错了症状整体思路没问题代码结构合理但某些具体实现不符合你的预期。常见场景你让它写分页接口它用了 OFFSET 分页但你项目统一用游标分页你让它写测试测试逻辑对了但命名风格跟你团队不一样你让它加错误处理逻辑对了但错误码用的不是你们约定的那套你让它写 TypeScript但它给了一些any类型你们项目禁止any这种偏差最常见大约占所有不对的 60-70%。也最好修。纠正方式——追加指令不要重来分页实现改成游标方式参照 src/modules/user/user.controller.ts 里 getUserList 的分页逻辑。其他部分不动。关键词是 **其他部分不动**。明确告诉 Claude 只改你指出的地方别动已经对的部分。不说这句它有时候会顺便把你已经满意的代码也重构一遍——然后你又多了一堆东西要检查。再看一个例子你让 Claude 给项目加 Docker 部署配置它写了 Dockerfile 和 docker-compose.yml。整体没问题但它把 Node.js 版本写成了 18而你们项目固定用 20。❌ 错误的纠正方式从头来 重新写一个 DockerfileNode.js 用 20 版本然后…… 你又要重新描述所有需求 ✅ 正确的纠正方式追加 Dockerfile 里的 Node.js 版本从 18 改成 20 基础镜像用 node:20-alpine。其他配置不动。原则方向对、细节错 → 追加指令修细节说其他不动。偏差类型2方向就是歪的症状整个实现思路跟你想的不一样。不是细节问题是根本的技术方案或架构选择不对。常见场景你想给现有 REST 接口加权限控制它新建了一套中间件框架你想优化数据库查询性能它把查询逻辑全改成了 Redis 缓存你想加一个简单的配置开关它搞了一整套 feature flag 系统你想修一个 CSS 布局问题它把你的 Flex 布局全重写成 Grid这种偏差的根源是 prompt 有歧义。你说的话有多种理解方式Claude 选了你不想要的那种。纠正方式——先叫停说清楚哪里理解错了再让它重做停一下。我不需要新建中间件框架。 我的意思是在现有的路由配置里用我们已有的 authGuard 给这几个接口加上角色校验。 具体来说 - /api/admin/* 下的接口需要 admin 角色 - /api/manager/* 下的接口需要 manager 或 admin 角色 - 其他接口保持现状 不要改现有的中间件结构只在路由层加 guard。注意这个纠正 prompt 的四步结构先否定错误方向我不需要新建中间件框架——让 Claude 明确知道上一个方案被否决了再给出正确方向在现有路由配置里用 authGuard——给它一个新的起点补充具体细节路由规则——上一轮 prompt 里可能就是缺了这些才导致歧义加约束堵死老路不要改现有中间件结构——防止它又往那个方向走再看一个例子你让 Claude 优化一个列表页的加载速度它直接把整个页面改成了 SSR服务端渲染。技术上确实能解决问题但你的项目是纯前端 SPA根本没有 SSR 的基础设施。停一下。项目是纯前端 SPA不能引入 SSR。 优化方向改为 1. 列表数据做分页加载首屏只请求第一页 2. 图片做懒加载 3. 列表组件用虚拟滚动项目已有 react-virtualized 依赖 不要改项目的渲染架构。原则方向歪了 → 不要在错误方向上修修补补直接否定纠正补信息。偏差类型2的关键心法不要试图把歪的方案修正成对的方案。一个用错了架构的实现你逐行去改改到最后可能比从头写还费劲。果断叫停从正确的方向重新来反而更快。偏差类型3做了你没让它做的事症状你要的它做了但它还顺手做了一堆你没要求的事情。常见场景你让它加一个字段它顺手重命名了三个现有字段——帮你优化命名你让它修一个 Bug它顺手改了旁边函数的代码风格你让它写一个工具函数它顺手把项目里其他地方用到类似逻辑的代码也全替换了你让它加个接口它顺手帮你升级了 Express 的版本这不是理解错了是过度发挥。Claude 看到了可以优化的地方就主动动手了。出发点是好的但在你没有预期的情况下这些改动会带来风险——尤其是那些它觉得顺手的重命名和重构很可能影响到你没有关注的其他模块。纠正方式——撤回多余改动 以后在约束里预防撤回对 username 和 phone 字段的重命名 那两个字段不需要改外部有很多地方在引用。 只保留新增 last_login_at 字段的改动。然后在以后的 prompt 里养成一个习惯——**在约束条件里加一句不要修改本次需求范围外的代码**。这句话能砍掉 Claude 80% 的过度发挥。如果你想更严格可以写严格只修改我指定的文件和函数其他文件不要动。原则做多了 → 明确撤回多余部分然后在约束里加只改我说的。快速判断流程图遇到结果不对用这个流程3秒做判断Claude 的输出不对 │ ├─ 整体思路和方案选择是对的 │ │ │ ├─ 是 → 偏差类型1细节错了 │ │ → 追加指令改细节说其他不动 │ │ │ └─ 不是 → 方案完全跑偏了 │ │ │ ├─ 是 → 偏差类型2方向歪了 │ │ → 叫停否定旧方向给新方向 │ │ │ └─ 方案是对的但多做了你没要的 │ → 偏差类型3过度发挥 │ → 撤回多余改动下次加约束 │ └─ 完全看不懂它在做什么 / 代码根本跑不起来 → 大概率是 prompt 太模糊了 → 回到第03课用四要素重写 prompt建议把这个流程图截图保存。前两周你可能需要对着它走两周后就变成条件反射了。什么时候该修什么时候该重来上面三种偏差都是可以修的。但有些时候修不如重来。怎么判断看两个信号。重新开始的信号信号1连续纠正3轮以上结果还是不对。如果你追加了3轮指令问题不但没解决还越改越乱说明第一轮的基础就是歪的。后续所有的纠正都是在一个歪的地基上盖楼。这时候果断开一个新对话用你在纠正过程中获得的认知重新写一个更好的 prompt。信号2Claude 创建了大量你不需要的文件和目录。如果它按照自己理解的架构创建了一堆新文件你想把它拉回到现有架构上难度跟推倒重来差不多。特别是当这些新文件之间有复杂的引用关系时——你删一个文件其他文件的 import 全挂了。信号3你自己的需求在纠正过程中变了。做着做着你发现其实我不想要这个功能了我想要另一个。这种情况下之前的代码就是包袱不要试图改造它直接从新的需求出发。追加指令的信号整体方向对只是局部细节需要调整已经生成了大量代码重来成本明显高于修补你能用一两句话说清楚要改什么每一轮纠正之后结果确实在变好不是在原地打转记住一个数字3轮。3轮以内能修好的就追加。3轮还修不好的强烈建议重来。完整纠错链案例3轮从翻车到上线看一个真实的纠错全过程。不是一帆风顺的成功故事是一路修正最终做对的完整链路。任务给内容管理后台加批量操作功能第1轮——Director Mode prompt给后台的文章列表页加批量操作功能 批量删除、批量上架、批量下架。 要有全选和反选操作前要有确认弹窗。Claude 的输出做了一个完整的前端组件包含全选/反选、确认弹窗、三种操作按钮和 API 调用。功能完整代码能运行。我的检查打开代码看了看——问题1它直接在组件里用fetch()写了 API 调用。但我们项目统一走 service 层所有接口调用在src/services/下管理组件里只调 service 方法。问题2确认弹窗用的是window.confirm。我们项目有自己的 Modal 组件UI 风格统一window.confirm太丑了跟后台其他弹窗不一致。判断偏差类型1——方向对、细节错。两个细节都是没遵循项目规范追加指令就行。第2轮——追加纠正两个地方需要改 1. API 调用不要直接写在组件里 移到 src/services/article.service.ts 里 参照 userService 的写法导出异步方法组件里只调用 service 2. 确认弹窗用项目里的 Modal 组件src/components/Modal 不用 window.confirm。Modal 的使用方式参照 src/pages/user/UserList.tsx 里删除用户时的弹窗。 其他部分保持不动。Claude 的输出改好了。API 抽到了 service 层弹窗换成了 Modal 组件其他代码没动。再检查一遍又发现一个新问题。问题3批量删除的接口调用它设计成了循环逐条调用DELETE /api/articles/:id。如果选中了100篇文章就发100个请求。这在网络上和服务端都扛不住。这个问题第1轮我没注意到因为它藏在 service 方法的实现里。判断还是偏差类型1。方向没问题就是接口设计不合理。第3轮——继续追加批量操作的接口改成一次性提交不要逐条调用。 后端已有批量接口 POST /api/articles/batch 请求体格式是 { action: delete | publish | unpublish, ids: string[] }。 把三个操作都改成调用这个接口一次请求传所有选中的文章 ID。Claude 的输出改成了统一的批量接口调用。三个操作都走/api/articles/batch只是 action 参数不同。最终检查✅ 全选/反选逻辑正确✅ 确认弹窗用的 Modal 组件风格一致✅ API 调用在 service 层组件只调 service✅ 批量操作走统一接口一次请求✅ 代码风格跟项目一致可以提 PR 了。复盘这个纠错链第1轮Director Mode prompt → 拿到 80 分的结果 第2轮纠正 2 个细节代码组织 UI 组件 → 提升到 90 分 第3轮纠正 1 个接口设计问题 → 提升到 95 分 总对话轮数3 轮 总耗时约 8 分钟几个关键经验每一轮的纠正都是精准的——不是这不对重新做而是这里不对按这个标准改其他不动。每句话都有信息量。没有重新开始——虽然修了3轮但每一轮的改动范围都很小总体代码在持续变好。因为整体方向从第1轮就是对的不需要推倒。每一轮暴露的问题都是你忘了说的规范——第1轮你忘了提 service 层规范和 Modal 组件第3轮你忘了提批量接口的设计。这些忘了不是你的错是因为这些规范活在你的脑子里你觉得理所当然但 Claude 不知道。核心教训这些反复出现的忘了说的规范不应该每次都用人脑记住。它们应该被写进一个地方让 Claude 每次自动读取。这个地方就是CLAUDE.md——第08课的主题。到了那一课你会学到怎么把项目的所有规范固化成一个文件彻底终结忘了提导致的返工循环。六个纠错常用句式给你6句直接能用的纠错模板覆盖90%的纠正场景 细节修正类型1 [具体哪里]改成[具体怎样]参照[项目中哪个文件]的写法。其他不动。 多处细节类型1 以下N个地方需要改1. …… 2. …… 其他部分保持不动。 方向纠正类型2 停一下。我不需要[它做的方案]。我的意思是[你要的方案]。不要改[要保护的部分]。 方向纠正补信息类型2 方向不对。不要[错误方向]改成[正确方向]。补充一下背景[它缺少的上下文]。 ↩️ 撤回多余类型3 撤回对[具体内容]的修改那部分不需要改。只保留[你要的改动]。 ↩️ 预防过度发挥约束句 严格只修改我指定的文件和函数不要改动需求范围外的任何代码。课后实操故意翻车一次这次的练习跟前几课不一样——我要你故意写一个不完整的 prompt然后练习纠错。步骤1. 写一个故意缺信息的 prompt在你的项目里找一个你熟悉的模块写一个只有目标、没有上下文和约束的 prompt。比如给用户模块加一个导出功能就这一句发出去。2. 观察 Claude 的输出它一定会做出来但大概率有你不满意的地方。拿出纸笔或者开个备忘录记下来哪些地方做对了先肯定好的部分哪些地方不是你想要的每个不对的地方属于哪种偏差类型3. 用今天学的方法纠正类型1细节错了→ 追加指令用纠错句式模板类型2方向歪了→ 叫停、纠正方向、补信息类型3做多了→ 撤回多余部分4. 复盘纠正完之后问自己两个问题你用了几轮才达到满意的结果每一轮纠正时忘了说的那些信息下次写 prompt 能不能一开始就写上这个练习的意义不是教你写烂 prompt——而是让你建立对偏差类型的直觉判断。以后 Claude 做出来不对你能一秒钟分类然后用最高效的方式纠正不浪费一句话。 地基篇完结你已经超过了 80% 的用户到这里地基篇4课全部学完了。我们回顾一下你学到了什么第01课 → 你知道了 Claude Code 的真实定位不是键盘是团队 第02课 → 你亲手体验了 Director Mode 的效率差距 第03课 → 你掌握了四要素 Prompt 框架目标上下文质量标准约束 第04课 → 你学会了纠错的完整方法论三种偏差类型判断流程如果你认真做了每课的课后实操你现在已经能独立用 Director Mode 完成日常开发任务了。这件事本身就已经让你超过了 80% 的 Claude Code 用户——他们还停留在一步步给指令的操作者模式里。但说实话——地基篇只是能用的水平。 核心技能篇预告从能用到用得好接下来的5课是整个合集信息密度最高、实战价值最大的部分。第05课目标优于指令——Director Mode 第一支柱为什么告诉 Claude 你要什么比告诉它怎么做效果好3倍不是玄学是有具体原因的。这节课用5个完整的开发场景逐字演示怎么把指令型 prompt改写成目标型 prompt——功能开发、Bug修复、代码重构、安全审查、性能优化每个场景都给你改写前后的完整对比和效果差异。第06课让 Claude 自己分配任务——并行 Agent 策略这是 Director Mode 最强大的能力——让 Claude 同时做5件事。但不是所有任务都能并行。这节课给你一个判断工具什么任务能并行、什么不能、部分并行怎么处理。学完之后你一个人的产出效率可以接近一个3人小组。第07课结果验证——你最不能省的一步Claude 写的代码看起来没问题和Claude 写的代码确实没问题之间隔着一套验证流程。安全漏洞、边界情况、性能隐患、代码风格——这节课给你一份验收清单以及怎么在 prompt 里就内置验证要求让 Claude 在写完之后自己先验一遍。第08课CLAUDE.md——让 Claude 永远记住你的规矩还记得你在第04课本课的纠错案例里忘了说的那些规范吗service 层规范、Modal 组件、批量接口格式……这些每次都要重复告诉 Claude的东西全部写进一个 CLAUDE.md 文件Claude 每次启动自动读取。这节课给你一份完整的 CLAUDE.md 模板和3个行业变体前端项目/后端API/全栈应用拿过去改改就能用。第09课10个高频场景 Prompt 模板库这是整个合集最拿来即用的一课。10个开发者最常遇到的场景——新功能开发、Bug修复、代码重构、写测试、安全审查、性能优化、API设计、数据库变更、文档生成、代码迁移——每个场景一个经过打磨的 prompt 模板。你只需要把里面的项目名、文件路径、业务细节替换成你自己的直接发给 Claude 就能用。地基篇教你怎么开始核心技能篇教你怎么做好。如果说地基篇让你的效率从1x变成了2x核心技能篇的目标是让你变成5x。不夸张——当你掌握了并行策略、验证流程、项目规范固化和场景化模板之后你一个人能稳定输出以前3-5个人的工作量。这不是理论推演是后面每一课都会用真实案例证明的。核心技能篇即将发布敬请关注。 如果你觉得地基篇对你有帮助把这个合集分享给你的同事或技术群。 一起学的人越多你们团队的整体效率提升越明显—— 因为 Director Mode 在团队协作中的价值远大于个人单打独斗。本课小结Claude 做错不外乎三种细节错了、方向歪了、做多了细节错 → 追加指令说其他不动方向歪 → 叫停先否定错误方向再给正确方向做多了 → 撤回多余改动下次在约束里写不要改范围外的代码连续纠正3轮以上还不对 → 重新开始不要在泥潭里挣扎放下一步到位的执念80分→纠正→95分是正常且高效的流程每次纠错暴露的忘了说的规范 → 都应该最终写进 CLAUDE.md本课是《Claude Code 从入门到精通》合集第4课地基篇最后一课。完整合集包含 16 课系统教学 10 个场景 Prompt 模板 3 个完整项目案例。推荐阅读CLAUDE.md 不是给人看的说明文档而是给 Claude Code 用的项目级配置文件。理解这个区别是用好 Claude Code 的第一步。我把过去半年用 Claude Code 做内容型项目踩过的坑、总结出的方法写成了一本完整的实战手册包含 6 篇深度正文 14 份可直接复制使用的模板《CLAUDE.md 与内容型知识库项目协作实战手册》小册介绍这本手册解决什么问题第 1 篇重新理解 CLAUDE.md——它不是文档而是项目协作的配置中枢第 2 篇从零搭建——一份内容型知识库项目的 CLAUDE.md 实战编写第 3 篇规则分层——用 docs/ 文档体系实现渐进披露第 4 篇内容即数据——frontmatter 规范、数据结构与构建链路的工程化设计第 5 篇让 Claude 少犯错——验证机制、测试策略与发布检查清单第 6 篇从文件到系统——CLAUDE.md 与 hooks、subagents 的协作升级附录篇全套模板汇总 一周落地计划 常见问题如果你正在用 Claude Code 做内容站、知识库或文档型项目这本手册能帮你少走很多弯路。购买福利购买小册后私信我可免费体验我做的 AI 提示词优化工具PromptKithttp://promptkit.wiki一个月——用大白话输入你想做的事自动转化为 Claude Code 等 AI 编程助手的专业指令让你的提示词质量再上一个台阶。 购买小册的老铁们关注「前端达人」回复手册获取兑换码