CLAUDE.md 写法指南
这页是「怎么写 CLAUDE.md」的方法论子页，纯写作视角：核心原则、动笔前分析、四类必备内容、分层组织、长度纪律、三套可复制模板、反模式、维护闭环、论文反证。证据数据（Karpathy 四条源头、12 条规则、41%→3% 实测、官方原文要点）和加载机制细节请见 [[wiki/entities/CLAUDE.md 与 .claude 配置]]，本页不重复，只讲动手写。2026-06-19 新增：充分利用 2026-06-14 单日批量摄入的 25+ 篇 CLAUDE.md 写法源，加上 2026-06-18 的 arXiv 论文反证，提炼成一份动手指南。2026-06-21 新增：融入 6 月最新一批来源（吴师兄 CLAUDE.md 2000 行教训、分层治理体系三条件漏斗、七种定制机制全景），更新了对「CLAUDE.md 在新治理体系中的定位」的共识理解。
核心原则：写 Claude 推断不出来的
最常见、也是最致命的错误，是把 CLAUDE.md 当 README 写——堆项目介绍、目录结构、技术栈背景。这些对 Claude 几乎没有价值：它能自己扫描目录、读 pyproject.toml / package.json、推断你用了什么框架。你用两百字描述的项目背景，它扫一眼依赖文件就知道了。[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]] [[raw/2026-06-18/j5land/别再自动生成 CLAUDE.md 了，最新论文把真相讲透了.md|来源: j5land 论文反证]]
矛盾：社区普遍认为「写 CLAUDE.md 就能降错误率」（见 [[wiki/entities/CLAUDE.md 与 .claude 配置]] 的 41%→3% 实测） vs arXiv 论文（2602.11988）发现「上下文文件确实改变 agent 行为，但不一定提升任务成功率」——自动生成的 context file 在 8 组设置里有 5 组反而降低成功率、平均多走 2.45–3.92 步、推理成本涨 20–23%。关键不是「写不写」，而是「写的每一条是否减少了真实犯错」。来自 [[raw/2026-06-18/j5land/别再自动生成 CLAUDE.md 了，最新论文把真相讲透了.md|来源: j5land 论文反证]]
把 CLAUDE.md 想成给一位聪明的新同事做入职培训：他不需要你告诉他「这是 Python 项目」，他看一眼代码就知道；他真正需要的是 PR 流程、哪些是历史包袱别碰、那些代码里看不出来的团队约定。CLAUDE.md 的价值不在告诉 Claude 它能自己发现的事，而在告诉它通过读代码无法知道的事——你的偏好、边界、决策、禁区。 [[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
底层原因（Kyle 的第一性原理）：LLM 是无状态的，权重推理时已冻结，它对代码库的唯一认知就是你每次会话喂进去的 token；CLAUDE.md 是默认进入每一次对话的唯一文件，所以它就是 Claude 的「入职手册」。但 Anthropic 在注入它时带了一条 <system-reminder> 说「此上下文可能与任务无关，除非高度相关否则不要响应」——也就是说，文件里越多不普适的内容，Claude 就越可能整份忽略。[[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
动笔前：摸清要写什么
先问自己一个筛选问题，对每一条候选内容：如果不写这条，Claude 会做错什么具体的事？答不上来，就不写。 [[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
按「WHAT / WHY / HOW」三轴做需求分析（Kyle 的 onboarding 框架）：
- WHAT（地图）：技术栈、项目结构。monorepo 尤其重要——说清有哪些 app、哪些共享包、各自做什么，让 Claude 知道去哪找东西。
- WHY（目的）：项目存在的目的、各部分的职责。不只是「是什么」，而是「为什么这么分」。
- HOW（怎么干活）：你用
bun还是node？怎么跑测试、类型检查、编译？怎么验证 Claude 自己的改动？
[[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
一个验收标准（来自 Taylor）：让一个没看过你项目的人读完 CLAUDE.md，能在 30 秒内回答三个问题——这是什么产品？技术栈是什么？新代码放哪里？答不全就继续改。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]]
X 来源里的 Prompt Engineering 速记可以作为写 CLAUDE.md/AGENTS.md 时的微型检查表：核心是任务边界、输入结构、输出约束、失败处理四件事。可复用技巧包括角色+受众双重设定、只要求输出可检查判断依据而不是隐藏推理链、正例+负例、显式字段/类型/取值范围、XML 标签隔离任务/背景/规则/正文、允许模型说”不知道”并说明缺什么证据。调试时不要一次改多个变量：格式不稳先加输出约束，语义跑偏补 few-shot，编造多就增加失败出口。[[agent 生成 prompt 时参考|来源: Prompt Engineering 四件事]]
落笔：四类必备内容
把真正有价值的内容归成四类（kris330 的五分法里最有实操价值的四块）：
1. 不跑一遍不知道的命令（构建/测试/lint/启动）——这是 Anthropic 官方文档里唯一明确推荐要写的内容之一。少了它，Claude 每次验证改动都得猜你的测试命令或扫遍配置文件解析，白白烧上下文。
## 常用命令
- 安装依赖：`pip install -e ".[dev]"`
- 启动服务：`uvicorn app.main:app --reload`
- 跑全部测试：`pytest`
- 跑单个测试：`pytest tests/test_users.py::test_create_user -v`
- 提交前必跑：`ruff check . && mypy app/ && pytest`2. 偏好，尤其是「和默认值不一样的地方」——只写项目特有的约定，别写语言基本规范。「用类型注解」「避免裸 except」是 Python 默认，写了浪费 token；「日志统一用 loguru 禁用标准库 logging」「依赖注入统一用 dishka」才是 Claude 不知道的。
3. 架构约束和目录边界——防止 Claude「顺手乱改」的关键。明确每个目录的职责和红线（如 app/api/ 只处理请求响应不写业务逻辑），能大幅减少它自作主张扩大改动范围。
4. 明确的禁止事项——最被低估、效果最立竿见影的一块。把每次 Claude 乱来让你吃过亏的点，用「禁止」写进去；这个列表随时间增长，本质是你和 Claude 合作的「错题本」。
[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
补充：Taylor 特别强调「不要引入什么和要引入什么同等重要」。Claude 的知识截止到训练日，它不知道你项目有历史包袱；没有禁止清单，它会出于善意引入它「知道」的最优方案，结果和你的项目冲突（如项目已迁移到 Zustand 它又引入 Redux）。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]]
分层组织
CLAUDE.md 不是单文件，而是有明确层级，更具体的层级覆盖更通用的层级冲突项：
- 全局（
~/.claude/CLAUDE.md）：跨项目通用个人偏好（回答风格、全局禁忌如「任何地方不硬编码密钥」），不提交 Git。 - 项目（项目根目录
CLAUDE.md）：项目特有规范/命令/架构，提交 Git，团队共用。最核心的一层。 - 子目录（如
app/CLAUDE.md、tests/CLAUDE.md）：大项目里不同模块各有规则，处理该子目录文件时额外加载。 - 本地个人（
CLAUDE.local.md）：进.gitignore，个人的、不适合共享的本地配置。
[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
进阶做法：给敏感模块开本地 CLAUDE.md——在 src/auth/、src/payments/、infra/ 下各放一个，像给危险区装护栏，Claude 操作这些目录时自动加载该模块的红线与已知陷阱。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]]
更细一层是 .claude/rules/ + paths frontmatter 的路径级规则：按文件路径 glob 条件加载，只有修改匹配文件时才注入，不匹配的会话完全不占 token。这让 monorepo 能为不同模块维护专用规则而不塞爆上下文——机制细节、@import 语法和排查三件套（/memory、claudeMdExcludes、InstructionsLoaded hook）见 [[CLAUDE.md 与 .claude 配置#多层加载机制解密]]。[[raw/2026-06-14/井底之硅/还在往 CLAUDE.md 里堆规则？开发者翻出「.claude-rules」目录，Claude Code 项目治理已经细到文件路径级！.md|来源: 井底之硅 .claude/rules/ 路径级规则]]
长度纪律：写得准，不是写得全
反直觉的事实：信息越多，Claude 越容易忽略真正重要的。 原因是技术性的——CLAUDE.md 内容会占上下文窗口，而在你敲第一个字之前，系统提示、工具定义、MCP 配置已经吃掉约三到四万 token；CLAUDE.md 越长，留给真正工作（代码/对话/工具输出）的空间越小。[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
三条硬指标：
- 200 行是上限：Boris Cherny（Claude Code 作者）明确建议不超过 200 行。HumanLayer 自己的根 CLAUDE.md 不到 60 行。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]] [[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
- 14 条规则天花板：社区实测规则数超过 14 条后合规率开始塌方（详见 [[wiki/entities/CLAUDE.md 与 .claude 配置]] 的实证数据）。
- 指令数与遵守质量负相关：研究显示前沿思维型模型约能稳定跟随 150–200 条指令，而 Claude Code 系统提示本身已占约 50 条——再加 rules/plugins/skills/user messages 很快逼近上限；且指令越多，模型是「均匀地全部变差」，不是只忽略靠后的。[[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
一份 200 token 的精准规则，比一份 3000 token 充满废话的文件更有效。来自 [[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
具体化原则（Taylor）：规则必须可操作，不是可感受。「写干净的代码」「保持简洁」对 AI 等于没说——它懂的是「用 named export 不用 default export」「组件不超过 200 行」「async/await 不用 then 链」。测试方法：读完一条规则，你能不能在 5 秒内判断一段代码是否符合它？能就合格，不能就改写。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]]
模板：指针，不是图书馆
CLAUDE.md 的职责不是存储信息，而是告诉 Claude 去哪找信息——这是顶级用户和普通用户的分水岭：普通用户做知识梳理，顶级用户做 router。配合渐进式上下文（Progressive Disclosure），把任务相关说明拆进单独的 markdown 文件，CLAUDE.md 里只列指针 + 简述，让 Claude 按需读取。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]] [[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
下面给出三套可直接复制的模板骨架（精简到结构，具体内容按项目填）：
模板 A：项目根目录 CLAUDE.md（Python 后端示例，提交 Git）：
# [项目名] — Claude Code 工作手册
## 这个项目是什么
[1-2 句说明项目做什么，只写不读代码无法知道的背景]
## 常用命令
- 激活环境 / 安装依赖 / 启动服务 / 跑测试 / 单个测试 / lint / format / 提交前必跑
## 代码规范（只列与默认约定不同的地方）
- [如：日志统一用 loguru，禁用 print 和 logging]
## 目录职责
- `app/api/`：路由层，只处理请求/响应，不写业务逻辑
- `app/services/`：业务逻辑，调用 repository，不直接操作数据库
- [补充项目特有目录]
## 禁止事项
- 不要修改 alembic/versions/ 下的迁移文件，需要变更就新建
- 不要自动 pip install 新包，先说明需要什么、为什么
- [项目特有的禁区]
## 工作方式
- 影响超过 3 个文件的改动，先列计划确认
- 需求不明确时停下来问，不要猜
- 每次改动后自动跑 pytest 验证
## 已知坑（随时补充）
- [坑的描述] → 正确做法是 [...][[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
模板 B：全局 ~/.claude/CLAUDE.md（个人跨项目偏好，不提交）：
# 我的全局 Claude Code 偏好
## 工作方式
- 改动超过 5 个文件的任务，先列完整计划等我确认再执行
- 遇到多种实现方案，列 2-3 个选项说明权衡，不要自行决定
- 完成后主动说明做了什么、为什么、有什么要注意
## 代码偏好
- 注释解释「为什么」，不解释「是什么」
- 新增依赖前告诉我，说明有无标准库替代
## 安全底线（任何项目都适用）
- 绝不硬编码密钥/token/密码/连接串
- SQL 查询必须参数化，禁止字符串拼接
## 禁止事项
- 不要自动 push 到任何远程仓库
- 不要在生产代码里留 print()，用日志工具代替[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
模板 C：路径级 .claude/rules/（按需加载，省 token）：
---
paths:
- "src/api/**"
---
# API 约定（只在改 src/api/ 下文件时注入）
- 响应统一用 app/schemas/response.py 的 APIResponse 包装
- 错误处理用自定义异常类，不要直接 raise Exception[[raw/2026-06-14/井底之硅/还在往 CLAUDE.md 里堆规则？开发者翻出「.claude-rules」目录，Claude Code 项目治理已经细到文件路径级！.md|来源: 井底之硅 .claude/rules/ 路径级规则]]
常见反模式
| 反模式 | 为什么没用 | 改法 |
|---|---|---|
| README 综合征：堆项目介绍/目录树/技术栈背景 | Claude 能自己读代码、扫依赖推断出来，是上下文噪音 | 只写它推断不出的偏好/边界/禁区 |
| 口号式规则：「写干净代码」「保持简洁」 | AI 不懂「干净」，无法执行 | 改成可 5 秒判定的具体指令 |
| 贪多：几百行全堆根目录 | 每次会话全量加载，挤占上下文、降低遵守质量 | 砍到 200 行内，用渐进式上下文分流到子文件/.claude/rules/ |
| 当 linter 用：塞大量代码风格规范 | LLM 比传统 linter 贵且慢，风格规范会膨胀上下文 | 用确定性工具（ruff/Biome）+ Stop hook，别让 Claude 找格式问题 |
| 写「看起来正确」的常识复述 | agent 会认真执行每一条，复述常识只会让它多跑测试、多读文件、多花 token | 论文实证：真正重要的不是信息而是「为什么不能改」这类约束 |
[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]] [[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]] [[raw/2026-06-18/j5land/别再自动生成 CLAUDE.md 了，最新论文把真相讲透了.md|来源: j5land 论文反证]]
维护闭环：/init 是起点不是终点
/init 能扫代码库生成第一版 CLAUDE.md（覆盖 70–80% 基础内容），但它是起点，不是终点。Sam 的真实教训：一个用 Cloudflare Workers + D1 的项目，/init 没识别出 Workers 运行时，Claude 一直不知道 Intl API 在 Workers 有坑，反复返回错误代码——直到手动把运行时写进 CLAUDE.md 才解决。跑完 /init 一定要用编辑器通读一遍，补上它漏掉的关键约束。[[raw/2026-05-23/Sam/别再让 -init 自己跑了：90% 的人都漏了 CLAUDE.md 这一步.md|来源: Sam /init 是起点不是终点]]
注意 /init 读的是「当前工作目录」不是 git 仓库根——在子目录跑只会生成子目录的图谱。另外它只创建/更新 CLAUDE.md，不动其他文件，可以放心跑。[[raw/2026-05-23/Sam/别再让 -init 自己跑了：90% 的人都漏了 CLAUDE.md 这一步.md|来源: Sam /init 是起点不是终点]]
长期维护回路（Boris Cherny 的建议）：每次 Claude 出错，纠正后让它自己把教训写回 CLAUDE.md。具体就是出问题后加一句「把这条规则更新到 CLAUDE.md」，它会自己写一条清晰限制规则。这让 CLAUDE.md 随时间越来越贴合你的工作方式，而不是写一次就落灰的静态文件——最有价值的 CLAUDE.md 不是花一个下午精心设计的那个，而是跟着每次 AI 犯错一起生长起来的那个。[[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
进阶：把 CLAUDE.md 里的关键规则配成 Hook 的触发条件，让「请记住」升级成「你必须」（如每次编辑后自动 format、核心模块变更后自动跑测试）。排查加载情况用 /memory 看实际加载了哪些 CLAUDE.md。[[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条一线经验]]
关键组件
CLAUDE.md写四类内容：非显然命令、特有偏好、目录边界、禁止事项CLAUDE.local.md个人偏好，不污染团队共享规则.claude/rules/+pathsfrontmatter 按路径条件加载规则，省 token/init生成第一版，/memory排查实际加载内容
2026 年 6 月共识：CLAUDE.md 是「特权」不是「垃圾桶」
2026 年 6 月的新一批来源（吴师兄 CLAUDE.md 2000 行教训、金色传说 CC 全景、邵猛七种指令全解析、扶苏深度定制指南）独立验证并收敛到同一个结论：CLAUDE.md 是每次会话全量加载的「特权空间」，往里放什么比怎么写更关键。 [[raw/2026-06-19/吴师兄/面试官皱眉：-Claude Code 你用了半年，CLAUDE.md 多少行了？-我说两千多，他：那今天就到这吧.md|来源: 吴师兄 CLAUDE.md 行数]] [[raw/2026-06-20/金色传说大聪明/深入理解 Claude Code：从 CLAUDE.md 到 Hooks、Skills、Subagents…md|来源: 金色传说 CC 全景]] [[raw/2026-06-20/邵猛/驾驭 Claude Code：CLAUDE.md 配置文件、Skills、Hooks、Rules、Subagents 等 7 种指令全解析.md|来源: 邵猛七种指令]]
吴师兄的 2000 行教训：CLAUDE.md 不是堆越多越好
吴师兄的实战教训是对「长度纪律」最惨烈的独立验证：他把 CLAUDE.md 写到了 2000 多行，结果 Skills 的假通过率达 35%（20 个里有 7 个黑屏了但 AI 说通过了）。根因不是模型能力退化，而是 CLAUDE.md 太长后 AI 开始忽略关键限制——CLAUDE.md 越长，模型越倾向于关注自己「想关注的」而非你「希望它关注的」。[[raw/2026-06-20/吴师兄/一个月给 Claude Code 烧了 1.5 万美金，我才搞懂 skill 到底该怎么写.md|来源: 吴师兄 1.5 万美金]]
他的解决方案与社区共识完全一致：
- 只写 AI 猜不到的——项目背景/技术栈/TODO 计划等模型能自己推断的内容全部移出
- 能沉到 Rules/Skills/Hooks 的就不要留在 CLAUDE.md
- 定期审查——每次 AI 犯错后让 AI 把教训写回 CLAUDE.md，但也定期清理不再需要的旧规则
三条件漏斗：判断一条内容该不该放 CLAUDE.md
多位作者独立提出了一致的「放什么」判断框架，可提炼为一个三条件漏斗：
- 条件一（不可推断性）：这条信息 Claude 通过读代码/扫描目录/读
package.json能自己知道吗？→ 能 → 不放 - 条件二（会话普适性）：这条信息是否只在特定操作/路径/文件修改时才需要？→ 是 → 下沉到
.claude/rules/路径级规则或 Skill - 条件三（工具替代性）：这条信息能否通过 Lint 规则/Hook/确定性脚本强制检查？→ 能 → 用工具或 Hooks，不在 CLAUDE.md 里说服模型
只有三条都回答「否」的内容才放 CLAUDE.md——这是从 2026 年 5-6 月的多来源实践中归纳出的准入标准。[[raw/2026-06-20/吴师兄/一个月给 Claude Code 烧了 1.5 万美金，我才搞懂 skill 到底该怎么写.md|来源: 吴师兄 1.5 万美金]] [[raw/2026-06-20/技术自由圈/阿里面试官：如何设计工业级 Skills 进化体系？ 一个工业级 技能 Infra 底座如何设计？.md|来源: 技术自由圈 程序性记忆 vs 一次性指令]] [[raw/2026-06-20/扶苏/Claude Code 深度定制指南：CLAUDE.md、Commands、Skills 与Subagents.md|来源: 扶苏 Commands vs Skills]]
CLAUDE.md 在新治理体系中的定位
七月种定制机制全景（金色传说大聪明、邵猛、扶苏）清晰地定位了 CLAUDE.md 在新治理体系中的角色：
| 机制 | 加载时机 | 确定性 | 适合放什么 |
|---|---|---|---|
| CLAUDE.md | 每次对话全量加载 | 低（说服模型） | 跨会话普适的偏好/边界/禁区 |
| .claude/rules/ | 匹配路径时按需加载 | 低（说服模型） | 模块/目录级局部约束 |
| Skills | 用户或模型选择时加载 | 中（描述触发） | 可复用流程/标准化操作 |
| Subagents | 委派时激活 | 高（隔离执行） | 需要独立上下文的重型任务 |
| Hooks | 生命周期事件触发 | 最高（代码执行） | 确定性验证/前置检查/后置处理 |
| Commands | 用户显式调用 | 高（代码执行） | 快捷命令/常用操作 |
| Output Styles | 格式化输出时 | 中 | 输出风格/格式规范 |
核心洞察：CLAUDE.md 在七种机制中是「确定性最低」但「加载频率最高」的一种——它靠「说服」而不是「执行」来发挥作用。如果你发现某条规则需要反复强调但 Claude 总是不听，它大概率不应该放在 CLAUDE.md 里，而应该升级为 Hooks（确定性执行）或 Subagents（隔离执行）。[[raw/2026-06-20/金色传说大聪明/深入理解 Claude Code：从 CLAUDE.md 到 Hooks、Skills、Subagents…md|来源: 金色传说 CC 全景]] [[raw/2026-06-20/邵猛/驾驭 Claude Code：CLAUDE.md 配置文件、Skills、Hooks、Rules、Subagents 等 7 种指令全解析.md|来源: 邵猛七种指令]]
输入来源
- [[raw/2026-06-14/kris330/第3篇《CLAUDE.md 完全指南：写好这一个文件，AI 就不会乱来》.md|来源: kris330 CLAUDE.md 完全指南]]
- [[raw/2026-06-14/Kyle/Writing a good CLAUDE.md|来源: Kyle Writing a good CLAUDE.md]]
- [[raw/2026-06-14/Taylor/8条CLAUDE.md一线实战经验：让 Claude Code 更懂你更智慧.md|来源: Taylor 8 条经验]]
- [[raw/2026-06-14/井底之硅/还在往 CLAUDE.md 里堆规则？开发者翻出「.claude-rules」目录，Claude Code 项目治理已经细到文件路径级！.md|来源: 井底之硅 路径级规则]]
- [[raw/2026-06-18/j5land/别再自动生成 CLAUDE.md 了，最新论文把真相讲透了.md|来源: j5land 论文反证]]
- [[raw/2026-05-23/Sam/别再让
-init自己跑了：90% 的人都漏了 CLAUDE.md 这一步.md|来源: Sam /init 起点]] - [[raw/2026-06-19/吴师兄/面试官皱眉：-Claude Code 你用了半年，CLAUDE.md 多少行了？-我说两千多，他：那今天就到这吧.md|来源: 吴师兄 CLAUDE.md 行数]]
- [[raw/2026-06-20/吴师兄/一个月给 Claude Code 烧了 1.5 万美金，我才搞懂 skill 到底该怎么写.md|来源: 吴师兄 1.5 万美金]]
- [[raw/2026-06-20/金色传说大聪明/深入理解 Claude Code：从 CLAUDE.md 到 Hooks、Skills、Subagents…md|来源: 金色传说 CC 全景]]
- [[raw/2026-06-20/邵猛/驾驭 Claude Code：CLAUDE.md 配置文件、Skills、Hooks、Rules、Subagents 等 7 种指令全解析.md|来源: 邵猛七种指令]]
- [[raw/2026-06-20/扶苏/Claude Code 深度定制指南：CLAUDE.md、Commands、Skills 与Subagents.md|来源: 扶苏 Commands vs Skills]]
- [[raw/2026-06-20/技术自由圈/阿里面试官：如何设计工业级 Skills 进化体系？ 一个工业级 技能 Infra 底座如何设计？.md|来源: 技术自由圈 Skills 工业级]]
2026-07 更新：删除测试与存活测试
这批资料给 CLAUDE.md 写作补了两个更实用的测试：
删除测试：删掉某一行后，如果 Claude 的行为没有可观察变化，就说明这行不该留在 CLAUDE.md。CLAUDE.md 的价值不靠”看起来全面”，靠能不能改变未来的错误分布。[[raw/2026-06-24/Guide/面试官：“你说你用Claude写代码，你说说你怎么维护CLAUDE.md”，我：“这是啥？”，面试官：“回去等通知吧！”.md|来源: CLAUDE.md 维护]]
存活测试：这条规则在 auto-compact、子目录切换、Skill 未调用、长程任务恢复之后还能不能被执行？如果不能，要么上提到 root CLAUDE.md，要么外化为 SPEC/Goal，要么改成 Hook。[[raw/2026-06-30/吴师兄/面试官抓狂：-我的 Claude Code 怎么越用越笨？！-我看了一眼：-不是它笨，是 auto-compact 把记忆悄悄压没了-.md|来源: auto-compact]]
写法准则因此更狠：CLAUDE.md 只写”会改变行为的长期约束”，不写背景、愿望、临时提醒和模型能自己读出来的技术栈。维护重点不是新增，而是定期删除和下沉。
相关页面
- [[wiki/entities/CLAUDE.md 与 .claude 配置]] — 证据/规则清单页（Karpathy 四条源头、12 条规则、41%→3% 实测、Anthropic 官方最佳实践、多层加载机制），本页是其方法论姊妹篇
- [[wiki/entities/Claude Code]]
- [[wiki/concepts/上下文管理与 Harness Engineering]]
- [[wiki/concepts/Skills、Agents 与工具设计]]
- [[wiki/concepts/Spec + RAG 与增强开发工作流]]