讲解 Claude Code 的 CLAUDE.md 和记忆文件

Claude Code 使用 Markdown 文件来存放指令和记忆。你在 CLAUDE.md 中给它指令。它把自己的笔记保存在记忆文件中。当你提出要求时,它还会把计划、规格说明和报告作为 .md 文件写入你的项目。本页说明每个文件在哪里,以及怎样舒适地阅读它们。

Claude Code 读取的文件

文件位置用途
用户指令~/.claude/CLAUDE.md你的偏好,适用于每个项目
项目指令./CLAUDE.md 或 ./.claude/CLAUDE.md团队的规则,通过 Git 共享
本地指令./CLAUDE.local.md你自己为某个项目写的笔记;请把它加入 .gitignore
规则.claude/rules/*.md(一个项目)或 ~/.claude/rules/(所有项目)每个文件一个主题;可限定在特定路径

它们如何加载。 Claude Code 会读取你启动它所在的文件夹以及其上每一级文件夹中的 CLAUDE.md 和 CLAUDE.local.md。它们是合并的,而不是替换:从最上层的文件夹开始向下,因此你启动时所在文件夹中的文件最后读取。子文件夹中的 CLAUDE.md 会在 Claude 开始处理那里的文件时加载。

导入。 像 @docs/style.md 这样的一行会把另一个文件拉入你的 CLAUDE.md。

保持简短。 文档建议每个 CLAUDE.md 不超过 200 行。请把各主题的规则移到 .claude/rules/ 中。

AGENTS.md

如果项目有 AGENTS.md(Codex 和其他智能体读取的文件),但没有 CLAUDE.md 或 CLAUDE.local.md,Claude Code 就会改为读取 AGENTS.md。如果两者都存在,默认只读取 CLAUDE.md。要让一个文件同时供两者使用,请导入它:在你的 CLAUDE.md 中写入 @AGENTS.md。关于 AGENTS.md 的更多内容:Codex 页面。

自动记忆:Claude 自己写的笔记

自动记忆默认开启。工作时,Claude Code 会保存关于你、你的反馈、项目以及各种东西在哪里的笔记。它们位于:

~/.claude/projects/<project>/memory/

那里的 MEMORY.md 是索引;每次会话开始时会加载其前 200 行(或 25 KB)。你可以用 /memory 命令开启或关闭自动记忆。

这些是纯 Markdown 文件,你可以阅读和编辑。请不时检查一下:一条错误的笔记会影响每一次新会话,直到你修正或删除它。

在 Mac 上阅读这些文件

在 Mac 上,用 PilcrowMD(免费,测试版):

PilcrowMD Mac 版(测试版) · 更多关于阅读智能体文件的内容

常见问题

Claude 忽略了我的 CLAUDE.md。为什么? 在会话中运行 /context,检查它是否列在 Memory files 之下。过长或相互矛盾的文件被遵循的可靠性较低。

CLAUDE.local.md 应该放进 Git 吗? 不应该,它是给你自己的笔记用的。请把它加入 .gitignore。

我能在手机上阅读这些文件吗? 如果项目文件夹同步到 Google Drive,请在 PilcrowMD Android 版的“我的文件夹”中添加它。打开笔记即可看到最新版本;Android 上没有实时重新加载。

Mac 上同样可用: PilcrowMD Mac 版(测试版)