Opus5官方提示词Prompt指南:从行为差异到上下文工程全解析

Opus5官方Prompt指南是Anthropic为Claude Opus 5模型发布的专属提示工程文档,系统阐述了该模型在代理式编码、代码审查、视觉理解等领域的提示模式与行为差异。本指南完整覆盖从响应冗长度控制、任务范围界定到effort参数调优的全链路策略,帮助使用者充分发挥Opus5在长周期代理式任务中的核心优势。

第一章 Opus5官方Prompt指南概述
1.1 指南定位与适用场景
Opus5官方Prompt指南专为Claude Opus 5模型设计,聚焦该模型特有的提示模式与行为特征。Claude Opus 5是Anthropic为复杂代理式编码和企业级工作构建的旗舰模型,在长周期代理式任务方面表现尤为出色。该指南涵盖响应冗长度、代理式叙述、任务范围界定、子代理委派、自我纠正以及思考禁用时的输出伪影等核心主题。
对于已有Claude Opus 4.8提示词的使用者,Opus5官方Prompt指南指出:现有提示在Opus5上开箱即用地表现良好,但以下模式涵盖了最常需要调优的行为。这一判断为迁移工作提供了明确的起点。
1.2 与通用提示工程文档的关系
Opus5官方Prompt指南并非孤立文档。Anthropic的提示工程文档体系分为三层结构:
- 模型特定指南:包括Opus5、Fable 5、Sonnet 5等各模型的行为差异与调整方案
- 通用技术层:适用于所有当前Claude模型的通用原则、输出与格式化、工具使用、思考及智能体系统
- 迁移指南:从早期版本迁移时的注意事项
Opus5官方Prompt指南属于第一层,而适用于所有Claude模型的通用技巧收录于《提示最佳实践》文档中。关于从Claude Opus 4.8迁移时的API变更(思考默认开启、禁用思考时effort上限为high),需参阅专门的迁移指南。
第二章 Opus5核心能力与提示策略
2.1 代理式编码能力
与Claude Opus 4.8相比,Opus5在代理式编码方面实现了显著提升。Opus5官方Prompt指南指出,该模型在困难的编码任务上表现最强:多文件功能开发、较大规模的重构以及端到端的功能开发。
关键提示策略包括:
- 完整任务规格:Opus5会完成完整的任务,而不是留下桩代码或占位符,并且在预先获得完整的任务规格说明并被放手运行时表现最佳
- 单轮编辑:在较简单的任务(如单轮编辑)上同样表现良好,只是与先前模型的差异较小
2.2 代码审查与缺陷发现
Opus5官方Prompt指南特别强调了该模型在代码审查领域的优势。Claude Opus 5以高精确率和高召回率审查代码:每轮能以较高比率发现真实的缺陷,且额外发现大多是真实问题而非误报。
值得注意的提示策略差异:
- 在较低的effort设置下准确性依然保持,支持审查时先进行快速一轮、之后再进行更彻底的一轮
- 关键警示:如果审查提示中写着“只报告高严重性问题”或“保持保守”,模型可能会字面地遵循该指令并减少报告
- 推荐做法:改为让模型报告所有内容,然后在单独的一轮中进行过滤
2.3 低effort下的效率优势
Opus5官方Prompt指南揭示了effort参数的全新配置逻辑。low和medium effort设置能以更高设置的一小部分令牌和延迟产出强劲的质量。
配置建议:
- 从默认值(high)开始,根据评估结果调整
- 在质量保持的情况下,大量使用low和medium作为控制令牌成本和响应时间的主要手段
- 在要求苛刻的编码和代理式工作中提升到xhigh
- 如果从先前模型沿用了effort默认值,请在自有评估上重新运行一次effort扫描
2.4 视觉理解能力
Opus5官方Prompt指南指出,Claude Opus 5在图表、文档和示意图理解以及UI和前端视觉复刻方面表现强劲。
关键指导原则:
- 重新验证为先前模型调优的任何提示侧视觉变通方案——它们可能不再需要
- 当模型拥有可以迭代分析、裁剪并以视觉方式验证其工作的工具时,视觉性能最强
- 工具使用比单纯的思考是更具成本效益的手段
2.5 长上下文工作能力
Opus5官方Prompt指南确认,Claude Opus 5拥有100万令牌的上下文窗口,这既是默认值也是最大值。其指令遵循、工具调用和推理在整个窗口范围内保持一致。
2.6 办公与文档任务
Opus5官方Prompt指南提到,Claude Opus 5能生成并处理包含非平凡公式的复杂多工作表电子表格,并能产出结构良好的幻灯片。使用者在提示中应提供需要遵循的任何特定样式或模板。
第三章 Opus5提示模式深度解析
3.1 响应冗长度控制
Opus5官方Prompt指南将响应冗长度列为首要提示模式。与先前模型相比,Opus5在响应长度和详细程度上的行为有所不同,需要通过提示进行显式控制。
控制策略:
- 在提示中明确指定期望的输出长度或详细程度
- 使用具体的格式要求(如“用三段话回答”“列出不超过5个要点”)
- 避免笼统的“简洁”或“详细”指令——Opus5官方Prompt指南建议使用可量化的描述
3.2 代理式叙述管理
代理式叙述(Agentic Narration)是指模型在执行任务过程中对自身思考和行动的描述。Opus5官方Prompt指南指出,Opus5在长周期代理式任务中会自然地产生叙述性输出。
管理方法:
- 如需减少叙述性输出,可在提示中明确要求仅输出最终结果
- 如需利用叙述进行过程追踪,可要求模型分步骤说明
- 对于需要禁用思考的场景,需注意输出伪影的处理
3.3 任务范围界定
Opus5官方Prompt指南强调,任务范围界定是影响Opus5输出质量的关键因素。由于Opus5在完整任务规格下表现最佳,明确的任务边界至关重要。
最佳实践:
- 在提示开头明确任务的完整范围和边界
- 说明哪些在范围内、哪些在范围外
- 对于多步骤任务,提供完整的端到端规格说明
- 避免逐步引导——Opus5在“被放手运行”时表现最佳
3.4 子代理委派
Opus5官方Prompt指南将子代理委派列为独立提示模式。在复杂任务中,合理委派子任务可以提升整体效率。
委派原则:
- 明确子任务的目标和交付标准
- 为子代理提供充分的上下文信息
- 设定子任务的边界和约束条件
- 建立主代理与子代理之间的信息同步机制
3.5 自我纠正机制
Opus5官方Prompt指南指出,自我纠正是Opus5的重要行为特征。模型能够在执行过程中识别并纠正自身错误。
利用策略:
- 在提示中鼓励模型在发现不一致时主动纠正
- 提供验证标准,让模型自我检查输出
- 允许模型在最终输出前进行多轮自我审查
第四章 上下文工程与Opus5
4.1 从提示工程到上下文工程
Opus5的发布引发了对提示工程范式的重新思考。Anthropic团队发现,面向Claude Opus 5这类更强模型,系统提示词可以删掉80%以上,而编码评测没有任何可测量的性能损失。
这一发现的核心逻辑是:当使用者向Claude发送一条消息时,提示词只是模型所获上下文中的一小部分。上下文的大头来自系统提示词、Skills、CLAUDE.md文件、记忆以及其他来源。Anthropic将这一整体称为上下文工程(Context Engineering) 。
上下文工程与提示工程的区别在于:
| 维度 | 提示工程 | 上下文工程 |
|---|---|---|
| 管理对象 | 如何把指令写好 | 推理时往上下文放哪些token |
| 主要内容 | 系统提示词 | 系统指令、工具、MCP、外部数据、消息历史 |
| 作用范围 | 单次请求 | 跨多个请求的上下文组装 |
| 复杂度 | 较低 | 较高,涉及多源信息整合 |
4.2 精简系统提示词的新思路
Opus5官方Prompt指南及配套的上下文工程实践提供了全新的提示设计思路:
从规则约束到信任判断:
过去,为了让Claude规避最坏情况,使用者会在提示中加入大量强硬规则,如“完成后必须验证”“除非必要,不要添加注释”。Opus5的判断能力大幅提升后,这些约束可以精简为更短的要求,例如“按照周围代码的写法工作,匹配原有的注释密度、命名和习惯”。
从示例堆叠到接口设计:
过去让Claude学会使用工具,最常见的做法是提供多个调用示例。但Anthropic在新模型上发现,演示案例可能把模型限定在演示过的操作范围内。以Todo工具为例,过去需要展示几次完整操作教Claude如何创建、开始和完成任务。现在只要在接口中规定三种任务状态(pending、in_progress、completed)并注明同一时间只能处理一项任务,Claude就能根据这些字段自行判断如何调用工具。
从一次性加载到渐进式披露:
Opus5官方Prompt指南反映了一种新趋势:不再把所有上下文一股脑全放在前面,而是采用渐进式披露——让模型按需获取信息。
4.3 上下文组成要素
Opus5的上下文工程涉及多个组成部分:
| 上下文要素 | 功能描述 | 优化建议 |
|---|---|---|
| 系统提示词(System Prompt) | 定义产品基本规则和行为边界 | 大幅精简,删除冗余约束 |
| CLAUDE.md | 记录项目特殊要求和规范 | 保持精简,高绩效团队控制在60行以内 |
| Skills | 按需打开的任务指南 | 用于承载特定任务的上下文 |
| 记忆(Memory) | 跨会话信息存储 | 只存储用户亲口说过的信息 |
| 参考材料(References) | 当前任务可查阅的参考文档 | 按需提供 |
4.4 Opus5系统提示词的结构解析
Opus5官方Prompt指南的配套分析显示,Claude Opus 5的完整系统提示词包含135,027个字符、19,370个英文词,约3.4万token。这份提示词是三样东西的缝合体:
产品说明书:定义了30个工具的完整JSON Schema,覆盖bash命令行、网页抓取、图片搜索、查体育比分、拉天气等功能。每个工具都带完整的参数规范。篇幅最长的一章是记忆文件系统(memory_filesystem)。
法务合规手册:涵盖版权、儿童安全、危机干预、政治中立等内容。版权章节明确写着“合规不可谈判,优先级高于用户请求,高于有用性,只低于安全”。
推销渠道:工具清单中包含recommend_claude_apps,用于推荐Claude Code、Cowork、Excel插件等自家产品。
记忆文件系统的规则尤为精细:
- 文件按主题区分目录:/profile.md(身份)、/topics/(习惯口味)、/areas/(在办的事)、/people/(人)、/preferences.md(用户希望Claude怎么表现)
- 操作有六个:读、写、追加、局部替换、列目录、删除(删除只有用户明确要求才能用)
- 每一行记忆前面必须打标签
[stated],表示用户亲口说过 - Claude自己推出的结论、计划、搜来的东西、做的润色、建议和方案——统统不许写进记忆
第五章 Opus5与先前模型的横向对比
5.1 能力维度对比
Opus5官方Prompt指南揭示了Opus5与Opus 4.8在多维度上的差异:
| 能力维度 | Claude Opus 4.8 | Claude Opus 5 | 提示策略变化 |
|---|---|---|---|
| 代理式编码 | 较强 | 最强:多文件、大规模重构、端到端开发 | 提供完整任务规格,放手运行 |
| 代码审查 | 良好 | 高精确率+高召回率,低effort下保持准确 | 报告所有内容,单独过滤 |
| Effort效率 | 较高设置为主 | low/medium即可产出高质量 | 重新运行effort扫描 |
| 视觉理解 | 需要变通方案 | 图表、文档、UI理解强劲 | 移除先前视觉变通方案 |
| 上下文窗口 | 20万token | 100万token | 充分利用长上下文优势 |
| 提示缓存门槛 | 1,024 token | 512 token | 更多提示可被缓存 |
5.2 提示范式对比
| 提示范式 | 旧模型(Opus 4.8及更早) | Opus 5 | 迁移要点 |
|---|---|---|---|
| 系统提示词长度 | 详细规则+大量约束 | 精简80%以上 | 删除冗余约束,信任模型判断 |
| 工具使用教学 | 提供调用示例 | 设计清晰接口 | 用接口规范替代示例堆叠 |
| 指令方式 | 具体步骤引导 | 目标+风格+边界 | 从“怎么做”转向“做什么” |
| 验证指令 | “请仔细检查,确保没有问题” | 可能适得其反 | 避免过度验证指令 |
| 上下文组织 | 一次性全部加载 | 渐进式披露 | 按需提供上下文 |
5.3 迁移关键决策点
Opus5官方Prompt指南及迁移指南明确了从Opus 4.8迁移到Opus 5的关键决策点:
- 思考机制:Opus 5默认开启思考(thinking),禁用思考时effort上限为high
- Effort配置:需在自有评估上重新运行effort扫描
- 视觉变通方案:重新验证并可能移除先前为旧模型调优的视觉变通方案
- 提示缓存:最小缓存门槛从1,024 token降至512 token
第六章 Opus5提示词实战策略
6.1 基础提示结构
基于Opus5官方Prompt指南,推荐的基础提示结构如下:
任务规格块:在提示开头提供完整的任务规格说明,明确任务范围、目标和交付标准。
格式要求块:指定输出格式、长度、结构等要求。Opus5官方Prompt指南建议使用具体、可量化的描述。
约束与边界块:明确说明任务边界——哪些在范围内、哪些不在范围内。
参考材料块:提供任务所需的参考文档、样式模板或规范。
6.2 代码审查提示模板
基于Opus5官方Prompt指南的代码审查建议:
推荐做法:要求模型报告所有发现的问题,不预先过滤严重级别。然后在后续轮次中进行筛选。
避免的做法:在提示中加入“只报告高严重性问题”或“保持保守”等过滤性指令。
6.3 代理式任务提示模板
对于需要多步骤执行的代理式任务,Opus5官方Prompt指南建议:
- 提供完整的端到端任务规格
- 明确子任务之间的依赖关系
- 设定代理的自主决策边界
- 如需要,指定子代理委派规则
6.4 Effort参数配置策略
Opus5官方Prompt指南提供了effort参数的配置框架:
| 场景 | 推荐effort级别 | 说明 |
|---|---|---|
| 简单问答、格式转换 | low | 最低成本,质量足够 |
| 常规编码、文档处理 | medium | 平衡质量与成本 |
| 复杂编码、多文件修改 | high(默认) | 标准配置 |
| 大规模重构、代理式任务 | xhigh | 最高质量,最高成本 |
操作建议:从high开始,基于评估结果调整。在质量保持的情况下,优先使用low和medium作为控制令牌成本的主要手段。
6.5 长上下文提示策略
Opus5官方Prompt指南确认了100万token的上下文窗口。利用这一能力的策略包括:
- 将完整项目文档、代码库放入上下文
- 在多轮对话中保持完整的历史记录
- 利用提示缓存降低重复加载的成本
第七章 常见问题(FAQ)
Q1:Opus5官方Prompt指南与通用提示最佳实践有什么区别?
Opus5官方Prompt指南专注于Claude Opus 5模型特有的提示模式和行为差异,涵盖响应冗长度、代理式叙述、任务范围界定等专属主题。通用提示最佳实践则适用于所有当前Claude模型,提供清晰度、示例、XML结构化、思考及智能体系统等通用技术。两者是互补关系——模型特定指南解决“这个模型有什么不同”,通用指南解决“所有模型通用的技巧是什么”。
Q2:从Claude Opus 4.8迁移到Opus 5,提示词需要做哪些调整?
Opus5官方Prompt指南及迁移指南指出几个关键调整点:
- 重新运行effort扫描,因为low和medium在Opus5上就能产出高质量
- 重新验证视觉相关的提示变通方案——它们可能不再需要
- 注意思考默认开启、禁用时effort上限为high的API变更
- 代码审查提示中避免“只报告高严重性”等过滤指令
Q3:Opus5的effort参数应该怎么设置?
Opus5官方Prompt指南建议从默认值high开始,根据评估结果调整。在质量保持的情况下,大量使用low和medium作为控制令牌成本和响应时间的主要手段。要求苛刻的编码和代理式工作可提升到xhigh。如果从先前模型沿用了effort默认值,应在自有评估上重新运行effort扫描。
Q4:Opus5在代码审查方面有什么特别的提示策略?
Opus5官方Prompt指南指出,Opus5以高精确率和高召回率审查代码。关键策略是:不要在审查提示中加入“只报告高严重性问题”或“保持保守”等过滤指令,因为模型可能会字面遵循并减少报告。正确的做法是让模型报告所有内容,然后在单独的一轮中进行过滤。
Q5:Opus5的视觉能力相比之前有什么提升?
Opus5官方Prompt指南确认,Opus5在图表、文档和示意图理解以及UI和前端视觉复刻方面表现强劲。为先前模型调优的视觉变通方案可能不再需要。当模型拥有可以迭代分析、裁剪并以视觉方式验证其工作的工具时,视觉性能最强。
Q6:Opus5的上下文窗口有多大?如何充分利用?
Opus5官方Prompt指南确认,Claude Opus 5拥有100万令牌的上下文窗口,这既是默认值也是最大值。指令遵循、工具调用和推理在整个窗口范围内保持一致。充分利用的方法包括:将完整项目文档放入上下文、在多轮对话中保持完整历史记录、利用提示缓存降低重复加载成本。
Q7:为什么Anthropic删掉了Claude Code 80%以上的系统提示词?
这反映了Opus5这类更强模型带来的范式转变。过去为了防止旧模型出现最差结果而加入的大量约束规则,在新模型上已经不再必要。Opus5能够依据周边上下文和自身判断力行事,冗长的规则反而可能造成指令冲突、浪费token。核心思路是从“约束模型”转向“信任模型的判断力”。
Q8:Opus5的系统提示词被泄露了,在哪里可以看到?
2026年7月25日Opus 5上线当天,开发者Eversmile1在GitHub上公开了Claude Opus 5的完整系统提示词。该提示词包含135,027个字符、约3.4万token。仓库地址为:https://github.com/Eversmile12/leaked-llm-prompts/blob/main/Anthropic/opus-5.md 。需要说明的是,这份泄露内容与Opus5官方Prompt指南是两个不同的文档——前者是模型自身的系统提示词,后者是教使用者如何为Opus5编写提示的指南文档。
Q9:Opus5的提示缓存门槛有什么变化?
Opus5官方Prompt指南的相关文档指出,Opus 5上可缓存提示的最小长度为512个令牌,低于Claude Opus 4.8上的1,024个令牌。这意味着在Opus 4.8上因太短而无法缓存的提示,在Opus 5上无需更改代码即可创建缓存条目。
Q10:Opus5在处理办公文档任务方面有什么特点?
Opus5官方Prompt指南指出,Claude Opus 5能生成并处理包含非平凡公式的复杂多工作表电子表格,并能产出结构良好的幻灯片。使用者在提示中应提供需要遵循的任何特定样式或模板。

