READING FRAME

文章详情阅读与延伸浏览页

本页围绕单篇资讯建立完整阅读链路,承接标题信息、正文展示、上下篇跳转与推荐内容延伸,让访问者更顺畅完成阅读过程。

Focus Reading
Share Ready
More Topics

理解Claude Code的规则应用与上下文

球盟会app中文官方网站 286 阅读 约 5.5 分钟

在使用Claude Code时,许多人发现它可能会忽略某些规则,随即采取改动,例如改变措辞或格式。然而,在进行这些修改之前,有必要首先确认这些规则是否已被纳入智能体的上下文。这两个问题的本质是不同的:如果规则已加载但未遵守,那就涉及到措辞或执行;反之,如果规则根本未加载,则问题在于管线,哪怕重新措辞也无法解决。大多数情况下,问题属于第一种:虽然文件已加载,智能体能够复述出内容,但在执行时可能会偏离预期。

有开发者查看了一个旧项目,想要确认智能体获得了哪些信息。该项目名为SageCompass,是作者在去年冬天创作的LangGraph项目,其指令文件为手动编写,最后一次提交时间为2026年1月21日,并未针对此次检查进行任何调优。项目结构是这样的:langgraph/app/下的每个文件夹都有对应的CLAUDE.md文件,其中app/graphs/下的文件专门用于编辑图形模块的指令。

经过十个月后,作者首次在sagecompass/langgraph中启动Claude Code 2.1.311,让智能体进行检查。智能体成功读取了系统地图,浏览了图形代码,运行了质量检查并通过了测试,之后修复了每轮结束时出现的重复错误,使用了两个提示词和18条shell命令。

接着,作者利用npx @reporails/cli xray查看此次会话。此工具会在127.0.0.1上开启一个页面,读取Claude Code之前保存的会话记录。Graph标签将智能体置于时间轴上,左侧列出每个指令文件、规则、技能、记忆文件和MCP服务器首次加载的时间。结果显示,只有两个指令文件在启动时加载:根目录的CLAUDE.md和langgraph/CLAUDE.md。接下来的会话中,没有其他指令文件被纳入上下文,峰值为65k token,两个文件合计约2.3k。

从已加载的Sources列表可知,langgraph下可加载的指令文件共11个,仅加载了2个,剩余9个都显示为未加载。其中包括app/graphs/CLAUDE.md,该文件是该文件夹的主要指令,尽管智能体曾访问过该文件夹的代码,但app/graphs/CLAUDE.md依然没有被加载。

如果智能体继续编辑graph.py而没有加载相关指令,它将缺少关于“图模块如何编写”的指引,因此必须先解决加载问题,再进行措辞的修改。在Tool calls标签下,页面显示了当时智能体所拥有的内容,包括40k token的上下文、两个指令文件——根CLAUDE.md和langgraph/CLAUDE.md。

总的来说,在进行规则修改之前,需先查看会话记录。如果x-ray显示文件已加载,就应针对措辞或执行进行修正;若从未加载,则需先解决加载问题。同时,不应期望嵌套文件可以承载所有必须遵循的规则,启动时加载的文件中必须包含每次修改都适用的规则。此外,确保指向实际存在的文件是重要的,比如langgraph/CLAUDE.md中指向的.pmd文件如果已被拆分,保持旧指针可能导致静默失败,智能体仅会收到一次读取失败的信号。

最后,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。

觉得有用?分享给朋友

让更多人看到这篇内容,也欢迎继续浏览平台中的其他相关文章与专题内容。

推荐阅读