Claude Code不守规矩？先看规则有没有进上下文

Claude Code 忽略一条规则时，很多人的第一反应是改措辞：动词开头、字面量加反引号、想强调的段落加粗。但在动手改之前，有个更便宜、也更普遍的问题值得先回答：这条规则到底有没有进入智能体的上下文？ 这是两种不同的失败。规则加载了却没被遵守，是措辞或执行的问题；规则压根没加载，是管线的问题，再怎么改措辞也修不好。很多时候是前一种：文件加载了，智能体能复述出来，执行时照样跑偏。分清是哪一种，才知道该修哪里。 有人打开了一个旧项目，直接看智能体实际拿到了什么。 项目背景 SageCompass 是作者去年冬天写的 LangGraph 项目，指令文件是手写的，最后一次提交在 2026 年 1 月 21 日，没有为这次观察做过任何调优。 它的结构是： langgraph/app/ 下的每个文件夹都有自己的 CLAUDE.md 。其中 app/graphs/ 那份开头写着，这个文件是编辑 app/graphs/** 时的“主要”指令面。 那次会话 在隔了十个月之后，作者第一次在 sagecompass/langgraph 里打开 Claude Code 2.1.311，让它四处看看。它读了系统地图，走了一遍图代码，跑了质量门禁和测试，报告一切仍然通过；随后又修掉了每轮结束时反复出现的报错。两个提示词，18 条 shell 命令。 然后作者用 npx @reporails/cli xray 打开了这次会话。这个工具在 127.0.0.1 上起一个页面，读取 Claude Code 已经存在 ~/.claude/projects/ 下的会话记录。Graph 标签把智能体放到时间线上，左侧列出每个指令文件、规则、技能、记忆文件和 MCP 服务器首次加载的时刻。 结果： 只有两个指令文件加载，都在启动时 ——根目录的 CLAUDE.md 和 langgraph/CLAUDE.md。此后整个会话再没有其他指令文件进入上下文。上下文峰值为 65k token ，两个文件合计约 2.3k（根文件约 771，langgraph/CLAUDE.md 约 1.5k）；工具调用与结果约 22k，工具定义约 14k。 加载了，还是从未加载 Sources 列表会标出每个条目的状态：已加载、列出但从未加载、在磁盘上但从未加载、本次会话未记录。这次会话中，langgraph/ 下可加载的指令文件共 11 个 ，加载了 2 个。其余 9 个——app/ 下每个文件夹各一份，加上 tests/ 一份——都显示为未加载。 这 9 个里就有 app/graphs/CLAUDE.md，也就是自称该文件夹主要指令的那份，而智能体恰恰读过这个文件夹的代码。0:13 时它执行了 sed -n 1,200p app/graphs/graph.py。会话里所有读取都走 shell，app/graphs/CLAUDE.md 始终没有加载。 如果智能体接着以同样方式编辑 graph.py，它会在没有那份“图模块该怎么写”的文件的情况下动手。这个文件需要先修加载，再谈措辞。 在 Tool calls 标签点开那次调用，页面会显示智能体当时手里有什么：40k token 的上下文，两个指令文件——根 CLAUDE.md 和 langgraph/CLAUDE.md。 这次会话指向的几条做法 改规则之前先查会话。x-ray 显示文件已加载，就去看措辞或执行；显示从未加载，先修加载。 别指望嵌套文件承载必须遵守的规则。文件夹的 CLAUDE.md 取决于智能体怎么到达那个文件夹，这次会话里它就没加载。必须在每次改动中都成立的规则，应该放进启动时加载的文件，或者挂在钩子后面做检查。 指向真实存在的文件。langgraph/CLAUDE.md 第 128 行写着 See .shared/rules/testing.md，而那个文件几个月前已经拆成五个 testing-*.md，指针还留着旧名字。坏掉的指针只会安静地失败，智能体唯一的信号就是一次读取失败。 x-ray 覆盖什么 x-ray 读取的是 Claude Code 会话。SageCompass 的 11 个 AGENTS.md 文件由 Codex、Copilot 和 Cursor 读取，x-ray 不显示这些智能体的会话。在 Team 或 Enterprise 机器上，它会读取组织在 claude.ai 管理控制台里设定的配置，因此展示的是策略产生的上下文。 它在本地运行，页面起在 127.0.0.1，读取的是本机已有的会话文件。只有 Check 和 Fix 两个按钮会连到 Reporails 服务器。 在自己的会话上试 在启动 Claude Code 的那个文件夹里运行 npx @reporails/cli xray。装了 Reporai