ClaudeCode源码泄露,我发现了它比其他AI更好用的真正原因

省流提示：结尾有 Claude Code 系统提示词总结通用精华版放进任意 Coding Agent 都能使用

这两天 Claude Code 源码泄露，很多人在看 Prompt，在翻工程细节。

我也看了一圈。

看完最大的收获不是那些酷炫的功能设计，而是：Claude Code 的系统提示词把「成熟 Coding Agent 该怎么干活」这件事写得非常清楚。

而且反直觉的是，它更多不是在教 AI 怎么做事，而是在教 AI 不要做哪些事。

这其实有个名字，叫 Harness 工程。

简单说就是：不是给 AI 装更强的发动机，而是给它装刹车、装护栏、装边界。把它装进一个框里，让它别乱动。

这可能也是为什么 Claude Code 用起来比别的 Coding Agent 更好用。

对新手来说，与其研究怎么写更复杂的 Prompt，不如先搞懂这套框架。下面是 Harness 工程的 5 个核心卡口。

1.

先框死边界

再让它动手

刚开始 vibe coding 的人容易犯一个错：一次把需求说满，让 AI 多做一点。

结果它会顺手帮你优化、顺手扩展、顺手改掉你根本没提过的部分。最后你看着一堆「看起来很努力」的改动，不知道从哪开始收尸。

Harness 的第一个卡口就是：

先锁范围，再开工。

每次开始前，把这几件事钉死：

• 这次只改什么
• 哪些文件能碰，哪些不准碰
• 不要顺手优化，不要脑补未来需求

边界没框好，生成能力越强，坑越大。

2.

先读项目

再动代码

「帮我加个功能。」

「帮我修一下这个 bug。」

它当然会干。

问题是它可能连项目结构都没看清楚——README.md 没读，配置没读，入口没看。这种状态下动手，运气好修好一个点，运气差顺手多出三个新坑。

Harness 的第二个卡口：

第一轮不写代码，先让它读。

读完再问它：准备改哪些文件？不会碰哪些模块？还有哪里没搞清楚？交代清楚了再动手。

很多离谱 bug，不是写出来的，是没看清楚就动手改出来的。

3.

逼它汇报清楚

AI 的问题不只是会不会做，更烦的是：

• 没测，也说好了
• 只做了一半，也像是 done
• 自己其实不确定，但语气特别稳

Harness 的第三个卡口：

每次完成后，让它说清楚这四件事。

• 改了什么
• 怎么验证的
• 哪些没验证
• 还剩什么风险

你一旦养成这个习惯，「它到底做没做完」的内耗会少很多。

4.

把「实现」和「验收」拆开

刚做完一件事，人和 AI 都容易有同一种错觉：差不多了，能跑就行。

「能跑起来」和「真的可以交付」中间，还隔着一段距离。

Harness 的第四个卡口：

把验收单独拉出来，当成一个独立阶段。

• 第一轮，只做最小改动
• 第二轮，专门检查哪里没跑通，哪里只是看起来好了
• 第三轮，再决定要不要继续加东西

AI 最擅长的事之一，就是让你提前产生「应该差不多了吧」的幻觉。

5.

关键决策

必须亲自在场

vibe coding 不是全自动。真正好用的 vibe coding，从来不是让人类原地蒸发。

我用 Codex 做东西的时候，最常说的两句话其实是：「可以，推进吧。」还有：「看不懂，但推进吧。」听起来很离谱，但这不等于我在旁边躺平——我还是得提需求，看结果，判断这次算不算真的推进了。

Harness 的第五个卡口：

关键决策，你必须在场。

• 你到底要解决什么问题
• 这次边界在哪里
• 什么叫做完
• 什么结果可以接受，什么不行

真正该退场的是机械操作。脑子不能一起外包出去。

最后：

一份现成的 Harness

复制即用

上面 5 个卡口，说白了就是在给 AI 装刹车。

理解了 Harness 工程是什么，你会发现这些原则不是零散建议，而是一套完整的约束系统。

我让 Codex 分析完 Claude Code 源码后，把这套东西浓缩成了一段可以直接用的提示词——放进 Codex、Cursor、任何 Coding Agent 的个性化设置里都行：

你是我的 coding partner。默认目标是：在尽量小的改动里，完成用户明确要求的事情。工作原则：1. 先读相关文件，再提出方案或修改代码；不要假设未读代码的行为。2. 不要做未被要求的重构、抽象、清理或“顺手优化”。3. 优先选择最简单、可验证、可回滚的方案。4. 如果一次尝试失败，先解释失败原因并做针对性修复，不要盲目换方案或重复试错。5. 完成前必须做验证；如果没法验证，要明确说明“改了什么、没验证什么、为什么没验证”。6. 危险操作先确认，包括删除、覆盖、推送、改 CI、改权限、发外部消息。7. 汇报时只说确定的事实，不夸大，不把“看起来应该可以”说成“已经完成”。8. 当任务较大时，先给最小实施方案：会改哪些文件，不会碰哪些模块，完成标准是什么。9. 解释尽量简洁，但在关键决策处说明理由和取舍。10. 如果我在学习，请把任务拆小；在关键位置让我补 2-10 行代码或自己做一个小决定，然后你再继续。

这就是 Harness 工程的实物。拿走直接用。

这些坑我自己也还在踩，所以建了一个「金土的 Vibe 互助群」。

群里有好多 AI 用的很 6 的大佬，也有程序员、PM、设计师、运营等各行各业的群友。

想进群的话，可以加我好友：wilsonJin2020