CClaude套餐
充值套餐咨询流程教程常见问题ChatGPT 充值
微信咨询
  1. 首页
  2. /Claude 套餐
  3. /Claude 指南
  4. /Claude Code 不读 CLAUDE.md 怎么办?加载目录、导入与生效检查

Claude / 指南

Claude Code 不读 CLAUDE.md 怎么办?加载目录、导入与生效检查

PayForChat Editorial Team · 发布于 2026/11/10

Claude Code 项目规则未生效时,先用 /context all 核对实际加载文件,再检查启动目录、父目录、按需加载的子目录规则和导入路径。本文给出排查顺序,说明 CLAUDE.md 与 AGENTS.md 同时存在时的当前默认行为、规则冲突处理和小任务验证方法,区分文件未加载与指令含糊的问题,并保留直接读取 AGENTS.md 的版本条件。

运行 /context all,查看 Memory files 中是否出现预期文件。 文件没加载时查路径;已加载时查冲突和指令内容。先定位加载问题,再修改规则内容。

从启动目录向上检查

Claude Code 启动时读取当前目录及其父目录的 CLAUDE.md、CLAUDE.local.md;子目录的规则会在读写该目录文件时按需加载。项目规则也可放在 .claude/CLAUDE.md。

例如在 repo/frontend 启动,检查 repo/frontend 和上级目录中的规则。若规则只放在 repo/backend,当前会话尚未处理 backend 文件时,它可能还未进入上下文。

  1. 确认启动位置是目标项目,而非相邻仓库。
  2. 用 /context all 列出已加载文件。
  3. 对照预期规则所在路径,检查父子目录关系。
  4. 若使用 .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: 删除过期和矛盾条目,改成具体可核对的要求;访问限制则交给权限配置执行。

参考资料

  • Claude Code 项目指令与记忆

CLAUDE · 套餐咨询

Claude 充值 / 代充咨询

Claude Pro 可通过上方「前往订阅」进入 CCMaxPlan。Claude Max 相关问题可直接扫码添加微信咨询。

正在获取联系方式…

继续阅读

Claude Code 用量怎么看?/usage、缓存统计与限流提示Claude Code 更新后还是旧版?原生安装、Homebrew 与版本检查Claude Code 总要确认权限怎么办?查规则来源、匹配顺序与命令范围
CClaude套餐

© 2026 由 PayForChat 运营
独立第三方套餐咨询服务,与 Anthropic 无关联。

充值套餐教程常见问题微信咨询查订单工单ChatGPT 充值服务条款客服 [email protected]