摘要：Anthropic Claude Code 创建者 Boris Cherny 和团队的真实工作流精华，被整理成一份 CLAUDE.md 文件。放入项目根目录后，Claude 的思考方式和执行习惯全面对齐 Staff Engineer 标准——先规划再动手、犯错自动记录不再重复、交付前必须验证。本文完整拆解六大核心工作流、六步任务闭环和三条底层哲学，附可直接复制的完整配置。
关键词：CLAUDE.md、Claude Code、Boris Cherny、AI 编程、工作流编排、自我改进循环、10x 工程师、Anthropic
📋 目录
- 前言：AI 帮你写代码，为什么还是到处是 Bug？
- 一、CLAUDE.md 到底是什么？为什么这么牛？
- 二、六大核心工作流：整个文件的灵魂
- 三、六步任务闭环：项目管理像开挂
- 四、三条底层哲学：决定 AI 的上限
- 五、零成本落地：三分钟上手指南
- 六、真实效果对比：用了和没用的天壤之别
- 七、最后想说的话
💡 国内如何稳定使用 Claude？推荐 weelinking，国内可直连，按量付费，全系模型支持。
📢 前言：AI 帮你写代码，为什么还是到处是 Bug？
大家好，我是鲁工。
从事前端开发八年多。每天敲代码、调 Bug、跟 AI 助手较劲，已经成了我的日常。
以前用 Claude Code 写项目，经常出现这种情况：
AI 帮我生成了代码 → 逻辑看着没问题 → 一跑就崩
改了个小需求 → AI 把整个架构搅得乱七八糟
来回 prompt 十几次 → 效率低得怀疑人生
直到上周，国外大神分享了一个叫 CLAUDE.md 的文件，据说是 Anthropic Claude Code 的创建者 Boris Cherny 和团队的真实工作流精华。
有人把他的多条内部分享线程整理成结构化文档，只要把这个文件丢进项目根目录，Claude 就会像换了个人一样——思考方式、执行习惯，全都对齐资深工程师的标准。
我当时抱着试试看的心态，把文件复制进去，重新开了一个中型项目。
结果呢？
三天时间，我一个人就把以前需要一周才能搞定的功能全部上线，Bug 率直接腰斩。
不是夸张，这东西真让我体会到了什么叫——“AI 不再是工具，而是靠谱的搭档”。
今天我就把这个 CLAUDE.md 的来龙去脉、每一部分的具体含义、实际落地方法，完整拆解给你。看完这篇文章，你不仅会明白为什么它能让人 10x，还能立刻复制到自己的项目里用起来。
准备好笔记，咱们开始。
一、CLAUDE.md 到底是什么？为什么这么牛？
简单说，CLAUDE.md 就是 Claude Code 项目的 “行为规范手册”。
它不是普通的系统提示词，而是把 Anthropic 内部最顶尖的 AI 编码实践，浓缩成了一份可执行的规则文档。
Boris Cherny 作为 Claude Code 的创建者，在内部多次分享他们团队每天真实使用 Claude 的工作流。有人把这些散碎的线程整理成 Markdown，放到任意项目的根目录下。Claude Code 会自动读取它，把这些规则当作自己的"企业文化"和"工作手册"。
核心价值三点：
| 先思考后动手 | 不再一上来就狂敲代码，先做规划 | 返工率暴降 |
| 自我改进机制 | AI 犯过的错，自动记录，下次不再犯 | 越用越聪明 |
| 资深工程师思维 | 模拟 Staff Engineer 的思考框架 | 输出质量飙升 |
用了它之后，你会发现：
以前 AI 是 “听话的实习生”，现在它变成了 “能独当一面的 Senior Dev”。
二、六大核心工作流：整个文件的灵魂
这个部分是整个 CLAUDE.md 的灵魂。一共六条，每一条都直击 AI 编码的痛点。
2.1 Plan Node Default —— 默认进入规划模式
规则： 任何非琐碎任务（超过 3 步，或者涉及架构决策），必须先进入 Plan 模式。
我以前的习惯是直接说"帮我实现用户登录"，结果 AI 直接甩出一堆代码，后面发现鉴权逻辑跟现有系统冲突。
用了这条规则后，我现在第一句话永远是 “先写详细 Plan 到 tasks/todo.md”。
Plan 里要包含：
- 功能边界
- 边缘 case
- 与现有代码的交互点
- 预计改动范围
这样一来，后面的执行几乎零返工。
2.2 Subagent Strategy —— 子代理策略
规则： 复杂问题不要让主 Agent 全包，果断扔给子代理。
比如做一个带实时聊天的后台，我会让：
子代理 A → 专门调研 WebSocket 方案
子代理 B → 专门调研数据库选型
主 Agent → 只负责整合
上下文窗口干净了，专注度也上来了。
Boris 团队的经验是：复杂问题就多扔算力，用子代理并行攻克。
2.3 Self-Improvement Loop —— 自我改进循环
这是最变态、最爽的一条！
规则： 用户每次纠正 AI 的错误，AI 必须立刻把这个 pattern 更新到 tasks/lessons.md 里，写成"下次绝不再犯"的规则。
我第一次用的时候，AI 把 React Hook 依赖顺序写错了。我纠正后，它不仅改了代码，还在 lessons.md 里加了一条：
❌ 教训：使用 useEffect 时，必须把所有依赖显式列出，否则触发无限渲染。
第二次遇到类似场景，它主动提醒我检查依赖。
几次下来，同一个错它再也没犯过。
长期使用，这个文件会变成你和 AI 共同的"知识库"，AI 的"智商"肉眼可见地提升。
2.4 Verification Before Done —— 交付前必须验证
规则： 绝不标记任务完成，除非真正证明它能跑。
要求 AI 提供：
- diff 对比
- 测试用例
- 日志截图
- 边缘 case 验证
还要自问一句：“Staff Engineer 会点头吗？”
这条规则直接把 “看起来能跑” 变成了 “确实没问题”。
2.5 Demand Elegance —— 平衡地追求优雅
规则： 非关键改动别过度设计，但明显 hacky 的方案必须重构。
AI 会主动问：“我知道现在所有上下文，有没有更优雅的写法？”
简单 Bug 就别折腾，复杂逻辑必须追求简洁。
2.6 Autonomous Bug Fixing —— 自主 Bug 修复
规则： 用户扔个 Bug 报告，AI 二话不说直接定位、修复、验证。
它会自己去看日志、跑测试、修 CI。用户零上下文切换。
这才是真正的"AI 替你干活"。
六大工作流一图总览
| 1 | Plan Node Default | 先规划，再动手 |
| 2 | Subagent Strategy | 复杂任务拆给子代理并行处理 |
| 3 | Self-Improvement Loop | 犯错即记录，同错不犯两次 |
| 4 | Verification Before Done | 没验证过，不算完成 |
| 5 | Demand Elegance | 该优雅时优雅，该简单时简单 |
| 6 | Autonomous Bug Fixing | 给个 Bug 报告，剩下的 AI 全包 |
三、六步任务闭环：项目管理像开挂
Step 1 Plan First ──→ 把计划写到 tasks/todo.md，用可勾选清单
Step 2 Verify Plan ──→ 实施前再确认一遍
Step 3 Track Progress ──→ 每完成一项就打钩
Step 4 Explain Changes ──→ 每步给出高层总结
Step 5 Document Results ──→ 完成后在 todo.md 加 Review 小节
Step 6 Capture Lessons ──→ 任何纠正都更新 lessons.md
我现在每个新功能都严格走这六步。
好处立竿见影：
- 项目文档自动生成——交接给别人看一眼 todo.md 就知道进度和决策过程
- 错误不重复——lessons.md 越积越厚，AI 越来越靠谱
- 进度透明——打开 todo.md 一目了然，再也不用追着问"做到哪了"
四、三条底层哲学：决定 AI 的上限
| Simplicity First | 改动越小越好，只碰必要代码 | 做微创手术，不做开膛破肚 |
| No Laziness | 必须找到根因，绝不临时修复 | 按 Senior 标准来，不是糊弄交差 |
| Minimal Impact | 改动范围最小化，避免引入新 Bug | 改一个地方，不连带炸三个模块 |
这三条听起来简单，做起来却能把 AI 从 “聪明的新手” 变成 “靠谱的老兵”。
五、零成本落地：三分钟上手指南
第一步：创建文件
在项目根目录新建 CLAUDE.md 文件。
第二步：复制配置
把下面完整内容复制进去（已整理好最新版）：
## Workflow Orchestration
### 1. Plan Node Default
– Enter plan mode for ANY non-trivial task (3+ steps or architectural decisions)
– If something goes sideways, STOP and re-plan immediately – don't keep pushing
– Use plan mode for verification steps, not just building
– Write detailed specs upfront to reduce ambiguity
### 2. Subagent Strategy
– Use subagents liberally to keep main context window clean
– Offload research, exploration, and parallel analysis to subagents
– For complex problems, throw more compute at it via subagents
– One tack per subagent for focused execution
### 3. Self-Improvement Loop
– After ANY correction from the user: update `tasks/lessons.md` with the pattern
– Write rules for yourself that prevent the same mistake
– Ruthlessly iterate on these lessons until mistake rate drops
– Review lessons at session start for relevant project
### 4. Verification Before Done
– Never mark a task complete without proving it works
– Diff behavior between main and your changes when relevant
– Ask yourself: "Would a staff engineer approve this?"
– Run tests, check logs, demonstrate correctness
### 5. Demand Elegance (Balanced)
– For non-trivial changes: pause and ask "is there a more elegant way?"
– If a fix feels hacky: "Knowing everything I know now, implement the elegant solution"
– Skip this for simple, obvious fixes – don't over-engineer
– Challenge your own work before presenting it
### 6. Autonomous Bug Fixing
– When given a bug report: just fix it. Don't ask for hand-holding
– Point at logs, errors, failing tests – then resolve them
– Zero context switching required from the user
– Go fix failing CI tests without being told how
## Task Management
1. **Plan First**: Write plan to `tasks/todo.md` with checkable items
2. **Verify Plan**: Check in before starting implementation
3. **Track Progress**: Mark items complete as you go
4. **Explain Changes**: High-level summary at each step
5. **Document Results**: Add review section to `tasks/todo.md`
6. **Capture Lessons**: Update `tasks/lessons.md` after corrections
## Core Principles
– **Simplicity First**: Make every change as simple as possible. Impact minimal code.
– **No Laziness**: Find root causes. No temporary fixes. Senior developer standards.
– **Minimal Impact**: Changes should only touch what's necessary. Avoid introducing bugs.
第三步：启用规则
打开 Claude Code，新建或进入项目。告诉它：
从现在开始，所有操作都严格遵循 CLAUDE.md 中的规则。
搞定！ 后续交互就会自动带上这些规范。
六、真实效果对比：用了和没用的天壤之别
6.1 登录模块实战对比
没用前： 一个登录模块我花了 4 小时，返工 3 次，最后还有安全隐患。
用了后： 同一个模块——Plan 15 分钟，子代理调研 20 分钟，编码 40 分钟，验证 30 分钟。总共 1 小时 45 分，零返工，还顺便优化了 JWT 过期策略。
| 总耗时 | 4 小时 | 1 小时 45 分 |
| 返工次数 | 3 次 | 0 次 |
| 安全隐患 | 有 | 无，AI 主动优化 |
| AI 理解程度 | 每次重新解释 | 越用越懂你 |
6.2 长期使用的复利效应
更重要的是，lessons.md 越积越多，AI 对我的代码风格、业务逻辑越来越懂。
三个项目下来，它已经能主动提出这种建议：
“这个地方跟上个项目你改过类似逻辑，要不要复用那个抽象？”
这不是工具，这是一个越用越默契的搭档。
七、最后想说的话
2026 年的编程，已经不是人和代码的较量，而是 人和 AI 协作的艺术。
CLAUDE.md 把 Anthropic 最顶尖的协作经验，免费送到了每个开发者手里。
它不是让你偷懒，而是让你把精力真正花在有创造力的地方。
如果你每天都在用 Claude、Cursor、Windsurf 等 AI 编码工具，强烈建议立刻试试这个文件。
试完后，欢迎在评论区告诉我你的感受：Bug 少了多少？时间省了多少？最让你惊喜的变化是什么？
把这篇文章转给你的程序员朋友吧，也许下一个 10x 工程师，就是他。
📖 推荐阅读
如果这篇对你有帮助，以下文章你也会喜欢：
- 把 Claude Code 用成工程工具：8 条黄金法则与一套可复用工作流 — CC Switch 配置好之后，这 8 条法则能让你的 Claude Code 效率再翻一倍
- Claude Code 正式引入 Git Worktree 原生支持：Agent 全面实现并行独立工作 — 多 API 配好了，再学学多 Agent 并行工作，彻底解放生产力
- Claude Code 省 Token 终极指南：从烧钱到精打细算 — 接了 weelinking 按量付费，正好配上这篇，控制好成本
💡 国内的程序员丝滑使用claude weelinking 🚀 整个系列的核心理念：你不需要变成程序员，你只需要从"找人做"变成"自己能做"。
