Claude 5 模型上下文工程的新规则

Claude 5 模型的新上下文工程规则 2026 年 7 月 24 日 · 8 分钟阅读 · 查看原文 ↗ Claude AI 我之前写过关于如何最好地为最新一代 Claude 5 模型编写提示词，以及如何与它们迭代协作，从而发现你到底想构建什么。 但当你给 Claude 发送一条消息时，提示词只是它所获得上下文的一小部分。你的上下文大部分是由系统提示词（system prompt）、Skills、CLAUDE.md 文件、记忆（memory）以及其他来源拼装而成的。我们把这称为上下文工程（context engineering），它对你使用 Claude Code 或构建自己的智能体（agent）时所产生的成果影响巨大。 与提示词不同，上下文会被广泛地复用于许多请求，所以它不可能那么具体。那你要如何为 Claude 构建这些通用的提示词和指导，尤其是当你并不知道用户的提示词会是什么的时候？ 随着 Claude 自身能力的不断进化，这件事会变得出人意料地困难。最近，我们注意到，我们为最新一代 Claude 模型编写提示词的方式发生了一次巨大的跃迁。对于 Claude Opus 5 和 Claude Fable 5 这类模型，我们删除了 Claude Code 超过 80% 的系统提示词，而我们的编程评估结果没有任何可测量的损失。 以下是我们关于如何为这一新型模型编写提示词所学到的东西，以及你如何利用它来更新你的上下文工程。我们已经把这些最佳实践放进了 claude doctor——在 Claude Code 中使用 /doctor 命令，即可为你的 skills 和 CLAUDE.md 文件"瘦身"。 为 Claude 松绑 总体而言，我们发现我们过度约束了 Claude Code，无论是在系统提示词上，还是在 CLAUDE.md 文件和 skills 上。 例如，当我们阅读自己内部使用 Claude Code 的对话记录时，会看到在单个请求中出现多条相互冲突的信息，比如"酌情保留文档"，或者"不要添加注释"，这些来自系统提示词、skills 和用户请求的指令彼此打架。 一般来说，Claude 能够解读用户的意图从而得到正确答案，但 Claude 必须先更仔细地思考这些重叠且相互冲突的信息，才能决定该做什么。 而且，虽然这些约束曾经是避免最坏情况所必需的，但我们已经发现，我们可以删除其中的许多约束，让模型改用周围的上下文和它自己的判断力。 此外，Claude Code 现在拥有了多得多的工具。Claude 过去依赖 CLAUDE.md 作为记忆、信息和指导的来源。现在我们有 memory、artifacts 和 skills，Claude 可以用它们来创造在会话之间加载和共享上下文的新方式。 过去与现在 有许多过去的上下文工程最佳实践如今已经变成了神话。包括： **过去：给 Claude 规则 现在：让 Claude 运用判断力** 当我们首次推出 Claude Code 时，我们需要确保 Claude 避免最坏情况，比如删除文件。这意味着我们会给出一些未必总是正确的、特别强硬的指导。例如，在系统提示词中我们过去会说： 在代码中：默认不写注释。绝不写多段落 docstring 或多行注释块——最多一行短注释。除非用户要求，否则不要创建规划、决策或分析类文档——基于对话上下文工作，而不是中间文件。 但对于某一部分提示词来说，这种指导是错误的。就文档而言，用户可能有自己的偏好，或者某些非常复杂的代码片段确实需要多行注释块。 尽管如此，如果没有这些针对旧模型的护栏，Claude 写出的注释在很多情况下会是错的，我们不得不接受这种取舍。但新模型拥有更好的判断力，能够在没有明确规则的情况下处理好这些决策。 在新的系统提示词中，我们这样说：写出读起来像周围代码的代码：匹配它的注释密度、命名习惯和惯用写法。 **过去：给 Claude 示例 现在：设计接口** 关于工具使用，头号规则是给 Claude 如何使用这些工具的示例。但对于我们最新的模型，我们发现给示例实际上把它们限制在了一个特定的探索空间里。 与其使用示例，不如多想想你的工具、脚本和文件的设计——Claude 拥有哪些参数，以及如何让它们更具表现力？ 例如，在 Todo 工具的例子中，仅仅把状态列为 pending、in_progress 和 completed 这样的枚举，就已经在向 Claude 暗示如何使用它。而"保持只有一个条目处于 in_progress"这条指令，则帮助定义了我们所要求的行为。 **过去：把所有东西都放在最前面 现在：使用渐进式披露（progressive disclosure）** 由于 Claude Code 专注于编程，我们的系统提示词里包含了关于如何进行代码审查和验证的详细信息。这些信息并不总是需要，但一旦需要，就至关重要。 自那以后，Claude Code 已经非常擅长使用渐进式披露——在正确的时机加载正确的上下文。例如，我们把验证和代码审查移到了它们各自的 skills 里，让 Claude Code 可以按需调用。 但渐进式披露不仅适用于 skills，我们也把它用于工具。我们的一些工具是"延迟加载"的，这意味着智能体必须先用 ToolSearch 搜索它们的完整定义，然后才能使用。这让我们能够拥有更多工具（比如我们的 Task 工具），这些工具在需要之前不会占用上下文。 同样的做法也可以应用到你自己的 CLAUDE.md 和 Skill.md 文件上。一个常见的神话是，你想把这些文件做成一个中央仓库，收纳你可能遇到的每一种已知实践，因为否则 Claude 就找不到它。相反，你可以考虑维护一棵由文件组成的树，让它们在正确的时机被加载。 **过去：重复自己 现在：简单的工具描述** 早期的 Claude 模型有时需要重复的指令，或者更倾向于听从上下文窗口末尾的指令，而不是开头的。这意味着我们的系统提示词有时既在主系统提示词里提到工具，又在工具描述里给出指令。 我们发现，我们可以删除这些重复的示例，把如何使用工具的指令放到工具描述里，而不是系统提示词里。 **过去：记忆放在 CLAUDE.md 文件里 现在：自动记忆（Auto-memory）** 我们过去鼓励用户把东西存到 Claude 的记忆里，方法是使用 # 快捷键自动写入他们的 CLAUDE.md。相反，Claude 现在会自动保存与工作、与你相关的记忆。 **过去：简单的规范（specs） 现在：丰富的引用（references）** 在计划模式（plan mode）下，Claude Code 大量依赖包含计划的 markdown 文件。把这些文件存储为计划，有助于 Claude 在需要时引用它们。另一个类似的最佳实践是，把规范存储在代码库里，供 Claude 在跨较长期的项目中工作时参考。 但我们发现，Claude 能够处理越来越复杂的引用。除了简单的 markdown 文件，Claude 还可以引用由我们新的 artifacts 功能所创建的 HTML artifacts。 你也可以用代码的形式给 Claude 提供引用。一份规范也可以是一套详细的测试套件，或者是另一个代码库里 Claude 可能要移植的一个函数。 评分标准（Rubrics）是引用的另一种形式。Rubrics 让 Claude 能够尝试并验证你在某个特定领域里的品味（例如，好的 API 设计长什么样），方法是使用动态工作流，并用这些 rubrics 启动验证型智能体。 把这些应用到你的上下文 把这一切汇总起来，当你拼装自己的上下文时，它是什么样子的？ 系统提示词（System Prompt） 系统提示词与产品上下文高度绑定。它告诉 Claude 它正在哪个产品中运行、正在做什么。对于 Claude Code，你大概率永远不需要修改它，但如果你在构建自己的智能体框架（agent harness），这里才是你应该投入大量时间的地方。 CLAUDE.md 让你的 CLAUDE.md 保持轻量，简要描述你的仓库是做什么的，但要把大部分 token 花在代码库内部的那些"坑"上。例如，你可以把你的代码组织成把所有类型都放在一个单一的文件里，别处没有。避免去陈述那些 Claude 看看你的文件系统或仓库就能知道的"显而易见的"事情。 对于更多细节，使用渐进式披露。例如，如果你有几条关于如何验证工作的独特指令，就创建一个 verification skill，并从你的 CLAUDE.md 里引用它。 Skills 把 skills 想象成轻量级指南，让 Claude 在需要时能找到信息。避免让它们过度约束，除非是在极其重要的领域。 对于较长的 skills，尽量多使用渐进式披露——把它拆分成许多文件，并分割开来。 最好的情况是，skills 编码了那些专属于你、你的团队或产品的特定观点、知识或最佳实践。 引用（References） 你可以用 @ 提及文件，把它们作为引用包含进来。引用让 Claude 能够参考关于当前计划的深入信息。 这可能是 specs 文件、线框图（mockups），甚至是整个代码库。一般来说，你应该优先选择以代码形式存在的文件，因为它能以一种 Claude 非常熟悉的语言，向 Claude 提供清晰、高保真的指令。例如，一个设计的 HTML mockup，通常会产生比设计描述或截图更好的结果。 尝试简化 在你的系统提示词、skills 和 CLAUDE.md 文件上，你可能需要像我们一样做简化。我们推出了一个叫 claude doctor 的新命令，它也能帮你自动完成这件事。关于专门针对更先进模型编写提示词的更多细节，请查看我们的 Fable 实战指南（Fable field guide）。 标签：# X # Claude # AI # Guide # Fable 相关文章 10 SEO backlink Claude automations for 61k AI mentions in 3 months Link building is trial and error. SEO AI Claude Automation