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(免费,测试版):
- 在我的文件夹中添加你的项目文件夹。Claude Code 写入的文件,例如计划、规格说明和报告,会显示出来,并标有 N(新)或 U(已更新)。当 Claude Code 或其他应用更改了已打开的笔记时,它会重新载入。
- 高亮显示更改会显示你已读过的文件中改了什么:添加的为蓝色,删除或编辑的为橙色。对于 Claude 不断更新的
MEMORY.md或计划,这很方便。 - 并排比较会显示两个版本。开启文件历史记录后,文件 › 显示历史记录… 可让你回到较早的版本。
~/.claude是隐藏文件夹。在“打开”面板中,按 ⌘⇧.(Command-Shift-句点)即可显示隐藏文件夹。- 不建立互联网连接;你的笔记留在你的 Mac 上。
PilcrowMD Mac 版(测试版) · 更多关于阅读智能体文件的内容
常见问题
Claude 忽略了我的 CLAUDE.md。为什么? 在会话中运行 /context,检查它是否列在 Memory files 之下。过长或相互矛盾的文件被遵循的可靠性较低。
CLAUDE.local.md 应该放进 Git 吗? 不应该,它是给你自己的笔记用的。请把它加入 .gitignore。
我能在手机上阅读这些文件吗? 如果项目文件夹同步到 Google Drive,请在 PilcrowMD Android 版的“我的文件夹”中添加它。打开笔记即可看到最新版本;Android 上没有实时重新加载。
Mac 上同样可用: PilcrowMD Mac 版(测试版)