m.3方法⏱ 约 5 分钟
上下文管理(二):用 CLAUDE.md 记住项目
给 AI 一份"项目说明书",不用每次重说
🔎 最后验证 2026-05📚 来源:Claude Code 官方文档、《AI编程实战三卷书》卷一🧰 Claude Code✅ 159 人学过👁 364 次阅读
为什么学这个
上一节你知道了 AI 会"忘事"。每次都重复"我们这个项目用 X、风格是 Y、别动 Z"太累了。Claude Code 提供了一个优雅的解法:在项目里放一份 CLAUDE.md,让 AI 每次自动读到项目的关键约定。
💡 打个比方
CLAUDE.md 就像贴在新员工工位上的“本项目须知”:不用每天口头交代,他一坐下就看到"我们怎么命名、用什么风格、哪些坑别踩"。AI 进项目也先读它,自动对齐你的规矩。
CLAUDE.md= 放在项目里的一份说明文件,Claude Code 会自动参考它- 适合写进去的内容:
- 项目是做什么的、技术栈是什么
- 代码风格/命名约定("函数用驼峰""注释用中文")
- 重要约束("不要引入第三方库""别动 legacy/ 目录")
- 常用命令(怎么跑、怎么测)
- 好处:把"每次都要叮嘱的话"沉淀成文件,对话更短、AI 更稳、团队也统一
# 项目须知(CLAUDE.md 示例)
## 这是什么
一个网页版待办清单,纯前端,数据存浏览器 localStorage。
## 约定
- 只用原生 HTML/CSS/JS,不引入框架或第三方库
- 注释用中文;函数命名用驼峰式
- 改动前先读相关文件;不要改动 vendor/ 目录
## 怎么运行
直接用浏览器打开 index.html。
❓ 测验
CLAUDE.md 的主要作用是?
⚠️ 避坑CLAUDE.md 不是越长越好,会喧宾夺主
把它写成几百行的长篇大论,反而会占用上下文、稀释重点(还记得上一节'桌子满了'吗)。只写真正重要、反复要强调的约定,保持精炼。它是"须知",不是"百科全书"。
🤖 让 AI 帮你起草 CLAUDE.md
请帮我为这个项目起草一份精简的 CLAUDE.md:先读一下项目,然后写出'这是什么、技术栈、关键约定(命名/风格/不要动的地方)、怎么运行'。控制在 30 行内,只留真正重要的。
🔎 来源与核验· 2 条,点开核对
本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。
「Claude Code 会自动参考项目中的 CLAUDE.md 作为长期上下文」
📚 Claude Code 官方文档✓ 已核验 2026-05
「把项目约定沉淀为记忆文件可减少重复沟通、提升一致性」
📚 《AI 编程实战三卷书》卷一(上下文管理)✓ 已核验 2026-05
🔧 试一试:让 CLAUDE.md 替你把约定说一遍(8 分钟)
- 在项目根目录建一个
CLAUDE.md,写三条约定,比如:"用 TypeScript,禁止 any;提交信息用中文;不要改legacy/目录"。 - 开一个全新对话,让 Claude 写一段新功能代码——一个字都别提那三条约定。
- 看它写出来的代码有没有自动遵守:是不是 TypeScript、有没有用 any、碰没碰 legacy/。
你会看到:有了 CLAUDE.md 它自动守规矩,你不用每次重复;而没有它时,同样的请求它每次的选择都不一样。
为什么:CLAUDE.md 是项目的"长期记忆"——每次对话自动读到,于是"我们这个项目怎么做"不再依赖你记得每次都说。
✅ 小结
你会用 CLAUDE.md 给 AI 长期记忆了。除了约定,具体干活时还要给它"对的信息"才能做对。下一节讲怎么喂信息。
下一节 → 给 AI 喂对的信息
都看到这了，打个赏呗！
接下来 · m.4
给 AI 喂对的信息
继续读下一节 →