大多数人把 CLAUDE.md 写反了
摘要
本文指出,大多数 CLAUDE.md 文件都是“倒着写”的,里面堆满了过往失败的规则,而非精简的前瞻性上下文。文章主张只保留少量核心内容:当前目标、身份设定以及那些隐蔽但依然活跃的故障模式。
**每一份** **CLAUDE.md** **我接手过的(或在仓库截图中看到的,或从零搭建的)都有着相同的形态:一份错误清单。** **“不要对 ID 使用裸字符串。”“调用 Y 前务必检查 X。”“数据库对并发写入不友好。”三个月的生产事故,被格式化成了操作指令。** **文件靠不断堆砌而膨胀。每次出点问题,就加一条新规则。Agent 每次运行都要把它们全读一遍。这不是上下文工程,这是伤疤登记册。** **模型不需要知道所有出过的错。它只需要知道:** **- 它现在要做什么(目标 + 当前任务)** **- 它是谁(身份设定 + 约束条件,最多 3-5 行)** **- 3-5 个真正隐蔽且依然活跃的故障模式** **其余的都是它在干正事之前被迫阅读的噪音。** **倒写的问题在于:** **CLAUDE.md** **文件是基于过去编写的。“这是我学到的经验。”这对事故复盘很有用,但对运行上下文却很糟糕。运行上下文应该正向编写——基于我们当前的实际状况,告诉你今天要把事情做好所需的最少信息。** **最精简的** **CLAUDE.md** **只要能真正促成高效工作,永远胜过那份让你引以为傲的冗长文档。** **你的结构是怎样的?具体来说:你如何决定哪些内容配得上成为永久规则,哪些该放进单次会话的上下文文件中?**
相似文章
@PrajwalTomar_: 你的 CLAUDE.md 正悄悄把 Claude 变成一个只会说“是”的机器人。几乎每个人都把 Andrej Karpathy 的4条著名规则复制到了……
文章讨论了从 Andrej Karpathy 那里复制来的常见 CLAUDE.md 规则如何导致 Claude 变成一个唯命是从的助手,并提出了一个修复方法——添加允许 AI 提出更优方案的权限。
@PrajwalTomar_: Claude 没有出问题。是你的 CLAUDE.md 有问题。大多数人认为 Claude Code 出错是因为模型不好。错。……
一条推文指出,Claude Code 的糟糕行为源于错误的 CLAUDE.md 配置,而非模型缺陷,并分享了让智能体像资深工程师一样行事的规则。
multica-ai/andrej-karpathy-skills
一个单独的 CLAUDE.md 文件,实现了四项原则,以改进 Claude Code 的编码行为,源自 Andrej Karpathy 对 LLM 编码陷阱的观察。
@PawelHuryn: 187,000 人在 GitHub 上给一个 CLAUDE.md 文件点了星。每次交互都会加载一个 CLAUDE.md。每一行代码都是你付的租金……
Paweł Huryn 在推特上分享了他关于为 Claude Code 编写高效 CLAUDE.md 文件的见解,重点强调了项目专属规则以及避免不必要的冗余。
@dair_ai: If you maintain an AGENTS.md or a CLAUDE.md, this is worth a read. (bookmark it) 288 gold-test evaluated runs across Cl…
This paper presents a controlled ablation study across Claude Code and Codex, 17 real tasks, and 288 runs, finding that context files like AGENTS.md/CLAUDE.md do not measurably improve correctness; agents fail on implementation skill, not missing repository knowledge.