
Claude 5 代模型上下文工程新规则概述
为更先进的模型移除了超 80% 的 Claude Code 系统提示。那么,如何将经验应用到在 Claude Code 中的上下文工程,以及自己的智能体构建中呢?文章涉及类别有 Claude Code、智能体;产品包括 Claude Code、Claude Enterprise、Claude Platform;日期为 2026 年 7 月 24 日,阅读时长 5 分钟。
Claude 模型提示与上下文工程
此前写过关于为最新一代的 Claude 5 模型提供最佳提示,以及与它们迭代协作以明确构建内容的方法。但向 Claude 发送消息时,提示只是它所获取上下文的一小部分,大部分上下文来自系统提示、技能、CLAUDE.md 文件、记忆和其他来源,这被称为上下文工程,它对使用 Claude Code 或构建自己的智能体时产生的结果有重大影响。与提示不同,上下文通常适用于多个请求,不能过于具体。那么,如何为 Claude 构建这些通用提示和指南,尤其是在不知道用户提示内容的情况下?随着 Claude 自身能力发展,这可能变得异常困难。最近发现为最新一代 Claude 模型提供提示的方式有重大转变,对于像 Claude Opus 5 和 Claude Fable 5 这样的模型,移除超 80% 的 Claude Code 系统提示,编码评估结果却无明显下降。
释放 Claude 的潜力
总体而言,发现无论是通过系统提示,还是在 CLAUDE.md 文件和技能设置中,都对 Claude Code 施加了过多限制。例如,查看内部使用 Claude Code 的记录,会发现单个请求中存在相互冲突的信息,如系统提示、技能设置和用户请求相互矛盾,出现“酌情保留文档”或“不要添加注释”等表述。通常 Claude 能解读用户意图并给出正确答案,但做决策前,它必须仔细权衡这些重叠和冲突的信息。虽然这些限制曾是为避免最坏情况,但现在发现可删除许多限制,让模型依靠周围的上下文和判断力处理问题。此外,Claude Code 现在拥有了更多工具。过去,Claude 依赖 CLAUDE.md 存储记忆、信息和指南,现在有了记忆、工件和技能,Claude 可利用这些工具在不同会话中加载和共享上下文。
今昔对比:上下文工程最佳实践的转变
过去:给 Claude 制定规则;现在:让 Claude 自主判断
最初推出 Claude Code 时,为避免最坏情况,会给出一些可能并非普遍适用的强硬指导。如在系统提示中曾写道:“编写代码时,默认不添加注释。绝不要编写多段式文档字符串或多行注释块,最多写一行简短注释。除非用户要求,否则不要创建规划、决策或分析文档,应依据对话上下文工作,而非中间文件。”但对于某些特定提示,这些指导并不适用。在文档编写方面,用户可能有自己的偏好,或者复杂代码的某些部分可能需要多行注释块。对于旧模型,若没有这些限制,Claude 编写的注释在很多情况下会出错,不得不接受折衷方案。但新模型具备更好的判断力,无需明确规则也能妥善处理这些决策。在新的系统提示中,表述为:“编写的代码应与周围代码风格一致,包括注释密度、命名方式和代码习惯。”
过去:给 Claude 提供示例;现在:设计接口
使用工具的首要规则曾是为 Claude 提供使用示例。但对于最新的模型,发现提供示例实际上会限制它们的探索范围。应更多地思考工具、脚本和文件的设计,考虑 Claude 可使用的参数以及如何让这些参数更具表达力。例如,在待办事项工具的示例中,将状态列为“待办”“进行中”和“已完成”的枚举类型,能让 Claude 了解如何使用该工具。“保持一项任务处于进行中”的说明有助于明确需求。
过去:一次性提供所有信息;现在:采用渐进式披露
由于 Claude Code 专注于编码,系统提示中包含了详细的代码审查和验证信息。这些信息并非每次都需要,但在需要时却至关重要。此后,Claude Code 在渐进式披露方面表现出色,能够在合适的时机加载正确的上下文。例如,将验证和代码审查功能移至独立的技能中,Claude Code 可以根据需要选择性调用。渐进式披露不仅适用于技能,也适用于工具。一些工具采用“延迟加载”方式,意味着智能体在使用工具前必须通过 ToolSearch 搜索其完整定义。这样,可以拥有更多工具,而这些工具在需要时才会占用上下文。同样的方法也适用于自己的 CLAUDE.md 和 Skill.md 文件。常见误区是,可能想将这些文件作为可能遇到的所有已知实践的中央存储库,认为否则 Claude 就无法找到这些信息。实际上,可以考虑创建一个文件树,在合适的时间加载相应的文件。
过去:重复说明;现在:简洁的工具描述
早期的 Claude 模型有时需要重复的指令,或者更倾向于遵循上下文窗口末尾的指令。因此,系统提示有时会在主系统提示和工具描述中都提及工具。发现可以删除这些重复的示例,将工具的使用说明放在工具描述中,而非系统提示里。
过去:在 CLAUDE.md 文件中存储记忆;现在:自动记忆
过去,鼓励用户使用 `#` 快捷键将内容自动写入 CLAUDE.md,以保存到 Claude 的记忆中。现在,Claude 会自动保存与工作和用户相关的记忆。
过去:简单的规格说明;现在:丰富的参考资料
在计划模式下,Claude Code 严重依赖包含计划的 Markdown 文件。将这些文件作为计划存储,有助于 Claude 在需要时参考。另一个类似的最佳实践是在代码库中存储规格说明,以便 Claude 在处理长期项目时参考。但发现,Claude 能够处理越来越复杂的参考资料。现在,Claude 可以参考由新的工件功能创建的 HTML 工件,而不仅仅是简单的 Markdown 文件。还可以以代码的形式为 Claude 提供参考资料。规格说明也可以是详细的测试套件,或者是 Claude 可能移植的其他代码库中的函数。评分标准是另一种参考资料形式。评分标准允许 Claude 通过动态工作流,并利用这些标准启动验证智能体,来尝试验证在特定领域的偏好。
将经验应用到上下文中
系统提示
系统提示与产品上下文密切相关,它会告知 Claude 所处的产品环境和要完成的任务。对于 Claude Code,可能永远不需要修改系统提示,但如果正在构建自己的智能体框架,就需要在这方面投入大量时间。
CLAUDE.md
保持 CLAUDE.md 文件简洁,简要描述代码仓库用途,但将大部分令牌用于说明代码库中的注意事项。例如,可以将代码组织为将类型存储在一个单一的整体文件中,而不是其他地方。避免陈述 Claude 通过查看文件系统或代码仓库就能知道的“显而易见”的事情。大量使用渐进式披露,例如,如果有多个关于如何验证工作的独特说明,可以创建一个验证技能,并在 CLAUDE.md 中引用它。
技能
将技能视为轻量级指南,帮助 Claude 在需要时查找信息。除非在非常重要的领域,否则避免对其施加过多限制。对于较长的技能,尽量使用渐进式披露,将其拆分为多个文件。技能最好能体现你、你的团队或产品特有的观点、知识或最佳实践。
参考资料
可以使用 `@` 提及文件,将其作为参考资料包含进来。参考资料能让 Claude 参考当前计划的详细信息。这些参考资料可以是规格文件、模型,甚至是整个代码库。通常,应该优先选择代码文件,因为它们能用 Claude 熟悉的语言提供清晰、高保真的指令。例如,设计的 HTML 模型通常比设计描述或截图能产生更好的效果。
尝试简化
在系统提示、技能和 CLAUDE.md 文件中,可能需要像一样进行简化。推出了一个名为 `claude doctor` 的新命令,它可以帮助自动完成这项工作。如需了解针对更高级模型的提示的更多详细信息,可查看 Fable 指南。
相关文章
探索更多关于使用 Claude 进行团队开发的产品新闻和最佳实践。包括 2026 年 7 月 24 日发布的介绍如何为不同用例选择合适的 Claude 模型的文章;2026 年 7 月 22 日发布的讲解如何在 Claude Code 中利用技能构建验证循环的文章;2026 年 7 月 21 日发布的介绍 Anthropic 在 AI 原生软件开发中的安全保障措施的文章;2026 年 7 月 16 日发布的分享使用 Claude Code 进行大规模代码迁移的经验的文章。
借助 Claude 改变组织运营方式
可查看定价、联系销售。还可订阅开发者时事通讯,获取产品更新、操作指南、社区亮点等内容,每月发送到收件箱。
Anthropic 产品与服务介绍
产品
包括 Claude、Claude Code、Claude Code for Enterprise、Claude Cowork、@Claude、Claude Design、Claude Science、Claude Security、下载应用、定价、登录。
特性
有 Claude for Chrome、Claude for Microsoft 365、技能。
模型
包含 Mythos、Fable、Opus、Sonnet、Haiku。
解决方案
涉及 AI 智能体、代码现代化、编码、客户支持、网络安全、企业级应用、金融服务、政府机构、医疗保健、高等教育、K - 12 教师、法律领域、生命科学、非营利组织、小企业。
Claude 平台
有概述、开发者文档、定价、生态系统、市场、Claude on AWS、Google Cloud、Microsoft Foundry、区域合规性、控制台登录。
资源
包括博客、Claude 合作伙伴网络、社区、连接器、课程、客户案例、Anthropic 工程技术、活动、插件、由 Claude 提供支持、服务合作伙伴、教程、用例。
公司信息
有 Anthropic、职业机会、政策、经济前景、研究、新闻、AI 指数政策、负责任的扩展政策、安全与合规、透明度。
项目
包括初创企业、研究实验室。
帮助与安全
涉及可用性、状态、支持中心。
条款与政策
隐私选择方面,使用 Cookie 来提供和改进服务、分析网站使用情况,若同意,还会为定制或个性化体验并推广服务。可阅读 Cookie 政策,还可以自定义 Cookie 设置,拒绝或接受所有 Cookie。其中,必要 Cookie 保障安全和基本功能,必需开启;分析 Cookie 用于跟踪网站性能,默认关闭;营销 Cookie 用于广告个性化和跟踪,默认关闭。还有隐私政策、负责任的披露政策、商业服务条款、消费者服务条款、美国 K - 12 服务条款、美国 K - 12 数据处理协议、使用政策。
社交媒体
有 x.com、LinkedIn、YouTube、Instagram。
语言选择
包括 English (US)、日本語 (Japan)、Deutsch (Germany)、Français (France)、한국어 (South Korea)、Italian (Italy)。
423



被折叠的 条评论
为什么被折叠?



