Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第6章 项目记忆 — 用 CLAUDE.md 写下我的规则 ​

必读 想跟着这个阶段学下去,一定要读这一章。

一句话总结:每次都要重新说一遍的规则,写进文件夹里的 CLAUDE.md 文件。Claude 每次开始会话时都会读这个文件。 不过它不是强制装置,而是参考背景。写得越短、越具体,它就越能遵守。

这一章依据2026年10月31日确认的 Claude Code 官方文档和 macOS 桌面应用(韩语界面,付费账号)编写。这一章是把第5章做的模板,归拢成“基本规则”。

每次会话都从头开始 ​

Claude Code 的会话每次都从空白状态开始。 即使在上一个会话里说过“日期请这样写”,新会话也不知道。[1] 能让记忆跨会话延续的机制有两种。[2] 一种是我自己写的 CLAUDE.md,另一种是 Claude 自己记下的自动记忆。

这一章只讲我自己写的 CLAUDE.md。自动记忆是 Claude 看了我的纠正后,自己记下的备忘,所以现在不需要另外做什么。[2:1]

把两种机制放在一起看(点击展开)
CLAUDE.md自动记忆
谁来写我Claude
里面有什么指示和规则我纠正过的内容、我的喜好
什么时候读取每次会话开始时每次会话开始时(只读前面部分)

出处:Claude Code 官方文档[2:2]

理解检查

昨天的会话里你说过“日期要写成 10/27(周一)这样”。今天开新会话,Claude 还会记得这句话吗?

写什么 ​

CLAUDE.md 是写下**“不写的话每次都要重新解释的内容”**的地方。[3] 遇到这些情况就写下来。

  • Claude 第二次犯同样的错时
  • 正在重复提出上个会话里提过的同一个纠正时
  • 对新来的人也需要同样告知的内容

出处:Claude Code 官方文档[3:1]

并且要写得具体到可以验证。[4]

不够好的规则更好的规则
日期请写得整洁一点日期像 10/27(周一) 这样写
请好好整理待办事项用表格写,一定要包含负责人和期限
请小心对待原件绝不修改 inbox 里的原始备忘

更好的规则,看了结果就能马上判断“有没有遵守”。

请写得简短。 官方文档建议每个文件控制在200行以内。越长,占用的背景越多,被遵守的程度也越低。[5] 由多个步骤组成的流程,最好挪到第7章的技能里。[3:2]

理解检查

写进 CLAUDE.md 的规则,哪一条最合适?

实践 — 用我的规则做出 CLAUDE.md ​

让它把第4章里写下的“通用规则”做成 CLAUDE.md。

CLAUDE.md 请求。红色编号 ① 标在输入框里写着5条规则的请求上

请为这个文件夹做一个 CLAUDE.md。要放进去的规则:1) 绝不修改 inbox 里的原始备忘 2) 整理时使用 templates 文件夹里的模板 3) 日期像 10/27(周一) 这样写 4) 备忘里没有的内容不要编造,写成(备忘中没有) 5) 待办事项用表格写,一定要包含负责人和期限。要简短,控制在20行以内。

Claude 在文件夹最上层做出了 CLAUDE.md(结果:ch6-CLAUDE.md.txt)。5条规则各占一行,用粗体写出,后面还附上了待办事项表格的示例。

文件夹最上层的 CLAUDE.md(或 .claude/CLAUDE.md)称为项目指示。它适用于在这个文件夹里工作的所有会话。[6]

理解检查

在「整理工具」文件夹最上层创建的 CLAUDE.md,适用于哪里?

测试它有没有遵守 — 在新会话里 ​

CLAUDE.md 是在会话开始时读取的。[1:1] 所以测试要在新会话里做。这次完全不提格式,只简短地提出请求。

新会话里的简短请求。红色编号 ① 标在「请用 inbox 里的3份复盘备忘,写本周的周复盘。」上

请用 inbox 里的3份复盘备忘,写本周的周复盘。

把结果(ch6-weekly-review-2026-10-27.txt)和规则对照了一下,是这样的。

规则结果
使用 templates 的模板原样使用第5章的 KPT 模板(做得好的、不足的、下周要做的)
日期像 10/27(周一)10/30(周四)、11/3(周一) 的格式
备忘里没有就写(备忘中没有)在缺少“为什么”的两处写了(备忘中没有)
不修改原件inbox 备忘保持原样

出处:本指南的实践结果(2026-10-31)

数字也都和备忘一致。Instagram 3次、点赞12个、写错的价格 6,000韩元、套装4个·每周11个、热红酒成本 1,800韩元,都原样写了进去。

结果界面。红色编号标在:① Claude 用模板的检查表自己确认出的「检查结果」,② 「需要确认的3件事」,③ 会话信息栏里的成果(周复盘文件)

看 ①,你会发现 Claude 用第5章做的模板说明里的检查表自己做了确认。连确认的范围(复盘备忘 3/3)也说明了。

在 ② 里,它先告知了需要确认的三件事。

  • 备忘里的星期和实际日历不一致(第2章里说过的“编造的日期”)
  • 备忘里没写原因的格子
  • 原始备忘里有一处没有记录的修改[7]

把规则和检查表写下来,结果回来时就会连同依据一起回来。

理解检查

想测试 Claude 是否遵守 CLAUDE.md 里写的规则。最好的办法是什么?

它不是强制规则 ​

官方文档明确说,CLAUDE.md 是参考背景,不是强制设置。[8] 所以要这样写。

  • 越是必须遵守的东西,越要写得具体而简短。越具体,遵守得越一致。[8:1]
  • 如果有互相冲突的规则,Claude 可能会随便选一条。要时不时读一读,把过时的规则删掉。[9]
  • 无论如何都必须阻止的事(例:删除原件文件夹),不要只相信 CLAUDE.md,要和第4章的权限模式及 Git 记录一起来守住。比如设成「手动」模式,Claude 在修改文件或执行命令之前会先询问。留下提交的话,就算出了差错,也能用那条记录恢复。

这一章图里的回答末尾,可能会看到“状态:”一行。这是因为截图用的电脑上有一份适用于所有文件夹的个人指示文件(~/.claude/CLAUDE.md),才出现的一行。你的界面里没有也是正常的。[6:1]

也有适用于我整台电脑的 CLAUDE.md

写在 ~/.claude/CLAUDE.md(我的用户文件夹)里的指示,适用于所有文件夹的会话。[6:2] 本指南截图用的电脑上也有这样的个人指示,所以会在回答末尾加“状态:”一行等,界面略有不同。只在一个文件夹里使用的规则,请写进那个文件夹的 CLAUDE.md。

理解检查

你在 CLAUDE.md 里写了“绝对不要修改 inbox 原件”。按官方文档,哪种说法是对的?

亲自试一试 ​

  1. 把第4章写下的通用规则,精简成3~5行。要写得具体,让人能判断“有没有遵守”。
  2. 像上面的请求那样,请它做出 CLAUDE.md,并在文件栏里确认内容。
  3. 打开新会话,发送一个不提格式的简短请求。
  4. 把结果和规则表逐条对照。如果有没遵守的规则,就写得更具体一些。

连续任务:现在,“帮我整理会议纪要”“帮我做学习笔记”都是每次用话来说。在第7章里,会把这些请求做成像 /会议整理 这样的技能,用一行就能调用。

小结 ​

  • 会话每次都从头开始。要重新解释的内容,写进 CLAUDE.md。
  • 同样的错误、同样的纠正第二次出现时,就是该写的时候。要具体,控制在200行以内。
  • 文件夹最上层的 CLAUDE.md 适用于那个文件夹的所有会话,~/.claude/CLAUDE.md 适用于所有文件夹。
  • 它有没有遵守,在新会话里用简短的请求来测试。
  • 它不是强制装置。必须阻止的事,要和权限模式、Git 记录一起来守住。

术语表 ​

术语中文名称一句话解释
CLAUDE.mdCLAUDE.md每次会话都会读取的、由我来写的指示文件
Auto memory自动记忆Claude 自己记下我的纠正和喜好的备忘
Project instructions项目指示适用于那个文件夹所有会话的 CLAUDE.md
Context背景(上下文)给它参考用的信息。和强制规则不同

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第7章. 技能、插件、外部工具

参考资料(9 条)
  1. Claude Code 官方文档,「How Claude remembers your project」。"Each Claude Code session begins with a fresh context window." / "Claude reads them at the start of every session." code.claude.com (确认日期 2026-10-31) ↩︎

  2. Claude Code 官方文档,「How Claude remembers your project」。"Two mechanisms carry knowledge across sessions" / "Auto memory: notes Claude writes itself based on your corrections and preferences" / "Both are loaded at the start of every conversation." code.claude.com (确认日期 2026-10-31) ↩︎

  3. Claude Code 官方文档,「How Claude remembers your project」。"Treat CLAUDE.md as the place you write down what you'd otherwise re-explain." / "Claude makes the same mistake a second time" / "You type the same correction or clarification into chat that you typed last session" / "A new teammate would need the same context to be productive" / "If an entry is a multi-step procedure or only matters for one part of the codebase, move it to a skill" code.claude.com (确认日期 2026-10-31) ↩︎

  4. Claude Code 官方文档,「How Claude remembers your project」。"Write instructions that are concrete enough to verify" code.claude.com (确认日期 2026-10-31) ↩︎

  5. Claude Code 官方文档,「How Claude remembers your project」。"target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence." code.claude.com (确认日期 2026-10-31) ↩︎

  6. Claude Code 官方文档,「How Claude remembers your project」。"Personal preferences for all projects" / "Team-shared instructions for the project" / "A project CLAUDE.md can be stored in either ./CLAUDE.md or ./.claude/CLAUDE.md." code.claude.com (确认日期 2026-10-31) ↩︎

  7. 这处修改是截图前本指南改了原始备忘里的一行。不是 Claude 做的,所以在你的实操里可能不会出现这一项。 ↩︎

  8. Claude Code 官方文档,「How Claude remembers your project」。"Claude treats them as context, not enforced configuration." / "The more specific and concise your instructions, the more consistently Claude follows them." code.claude.com (确认日期 2026-10-31) ↩︎

  9. Claude Code 官方文档,「How Claude remembers your project」。"if two instructions contradict each other, Claude may pick one arbitrarily." code.claude.com (确认日期 2026-10-31) ↩︎