运行 /context all,查看 Memory files 中是否出现预期文件。 文件没加载时查路径;已加载时查冲突和指令内容。先定位加载问题,再修改规则内容。
从启动目录向上检查
Claude Code 启动时读取当前目录及其父目录的 CLAUDE.md、CLAUDE.local.md;子目录的规则会在读写该目录文件时按需加载。项目规则也可放在 .claude/CLAUDE.md。
例如在 repo/frontend 启动,检查 repo/frontend 和上级目录中的规则。若规则只放在 repo/backend,当前会话尚未处理 backend 文件时,它可能还未进入上下文。
- 确认启动位置是目标项目,而非相邻仓库。
- 用
/context all列出已加载文件。 - 对照预期规则所在路径,检查父子目录关系。
- 若使用
.claude/rules/的 paths 条件,确认当前文件确实匹配。
AGENTS.md 和 CLAUDE.md 同时存在时
当前文档说明,Claude Code v2.1.277 起支持直接读取 AGENTS.md。默认情况下,工作目录及上级存在项目 CLAUDE.md 或 CLAUDE.local.md 时,会读取这些文件,而非自动再叠加 AGENTS.md。
如果团队希望共用 AGENTS.md,可在 CLAUDE.md 中明确导入,或调整 Project instructions 设置。仅把两个文件放在同一目录,可能与预期加载结果不同。
导入路径和规则冲突怎么查
导入使用 @path/to/file,相对路径以包含该导入的文件目录为基准。路径含空格时需要转义;放在代码块或行内代码里的 @README 会作为文字保留。
多个已发现的规则文件会合并进入上下文。检查是否同时出现“全部使用 npm”和“本项目使用 pnpm”等矛盾约定,保留符合当前项目的一项。
把“代码写好一点”改成可验证内容,例如“使用项目既有格式;改动后运行 package.json 中的 lint 命令;报告测试结果”。官方建议每个 CLAUDE.md 尽量少于 200 行,局部约定可移到对应目录或路径规则。
用小任务确认修复
重新开始一个会话后,要求 Claude 说明已加载的项目规则,并执行一个无需改代码的小任务,例如定位测试命令。核对它引用的文件、命令与项目一致,再继续正式修改。
这项检查验证当前会话的加载结果。后续目录、规则文件或版本改变时,可以再次用 /context all 定位。
常见问题
Q: /context 看不到完整文件列表怎么办?
A: 使用 /context all;官方说明全屏模式下普通 /context 会折叠文件列表。
Q: 子目录规则为什么启动时没出现?
A: 子目录文件通常按需加载,在 Claude 读写相应目录的文件后检查。
Q: 两份 CLAUDE.md 会互相覆盖吗?
A: 已发现的文件会合并进上下文,靠近启动目录的内容读入较晚。发现矛盾时应直接消除冲突。
Q: AGENTS.md 需要另复制一份吗?
A: 当前版本可直接读取,前提是满足默认加载条件;已有 CLAUDE.md 的项目也可通过导入共用内容。
Q: /init 会覆盖现有规则吗?
A: 官方说明已有 CLAUDE.md 时会建议改进。生成内容仍应根据项目实际命令和约定审阅。
Q: 规则已加载,Claude 仍然忽略怎么办?
A: 删除过期和矛盾条目,改成具体可核对的要求;访问限制则交给权限配置执行。