名称: claude-opus-4-5-迁移 描述: 从 Claude Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 迁移到 Opus 4.5 的提示和代码。当用户想要更新其代码库、提示或 API 调用以使用 Opus 4.5 时使用。处理模型字符串更新和针对已知 Opus 4.5 行为差异的提示调整。不迁移 Haiku 4.5。
Opus 4.5 迁移指南
一次性从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 迁移到 Opus 4.5。
迁移工作流程
- 搜索代码库中的模型字符串和 API 调用
- 更新模型字符串为 Opus 4.5(参见下方平台特定字符串)
- 移除不支持的 beta 头
- 添加努力参数设置为
"high"(参见references/effort.md) - 总结所有更改
- 告诉用户:“如果您在使用 Opus 4.5 时遇到任何问题,请告诉我,我可以帮助调整您的提示。”
模型字符串更新
识别代码库使用的平台,然后相应地替换模型字符串。
不支持的 Beta 头
如果存在,移除 context-1m-2025-08-07 beta 头——它目前不支持与 Opus 4.5 一起使用。留下注释说明:
# 注意:1M 上下文 beta (context-1m-2025-08-07) 目前不支持与 Opus 4.5 一起使用
目标模型字符串 (Opus 4.5)
| 平台 | Opus 4.5 模型字符串 |
|---|---|
| Anthropic API (第一方) | claude-opus-4-5-20251101 |
| AWS Bedrock | anthropic.claude-opus-4-5-20251101-v1:0 |
| Google Vertex AI | claude-opus-4-5@20251101 |
| Azure AI Foundry | claude-opus-4-5-20251101 |
要替换的源模型字符串
| 源模型 | Anthropic API (第一方) | AWS Bedrock | Google Vertex AI |
|---|---|---|---|
| Sonnet 4.0 | claude-sonnet-4-20250514 |
anthropic.claude-sonnet-4-20250514-v1:0 |
claude-sonnet-4@20250514 |
| Sonnet 4.5 | claude-sonnet-4-5-20250929 |
anthropic.claude-sonnet-4-5-20250929-v1:0 |
claude-sonnet-4-5@20250929 |
| Opus 4.1 | claude-opus-4-1-20250422 |
anthropic.claude-opus-4-1-20250422-v1:0 |
claude-opus-4-1@20250422 |
不要迁移: 任何 Haiku 模型(例如,claude-haiku-4-5-20251001)。
提示调整
Opus 4.5 与之前的模型有已知的行为差异。仅当用户明确请求或报告特定问题时应用这些修复。 默认情况下,只更新模型字符串。
集成指南: 当添加代码片段时,不要只是将它们附加到提示中。将它们整合得周到:
- 使用 XML 标签(例如,
<code_guidelines>、<tool_usage>)来组织添加内容 - 匹配现有提示的风格和结构
- 将代码片段放在逻辑位置(例如,编码指南靠近其他编码指令)
- 如果提示已经使用 XML 标签,将新内容添加到适当的现有标签内或创建一致的新标签
1. 工具过度触发
Opus 4.5 对系统提示更敏感。在先前模型上防止触发不足的激进语言现在可能导致过度触发。
应用如果: 用户报告工具被调用太频繁或不必要。
查找并软化:
CRITICAL:→ 移除或软化You MUST...→You should...ALWAYS do X→Do XNEVER skip...→Don't skip...REQUIRED→ 移除或软化
仅应用于工具触发指令。保留其他强调用法。
2. 过度工程预防
Opus 4.5 倾向于创建额外文件、添加不必要的抽象或构建未请求的灵活性。
应用如果: 用户报告不需要的文件、过度抽象或未请求的功能。添加 references/prompt-snippets.md 中的代码片段。
3. 代码探索
Opus 4.5 可能过于保守地探索代码,提出解决方案而不阅读文件。
应用如果: 用户报告模型在不检查相关代码的情况下提出修复。添加 references/prompt-snippets.md 中的代码片段。
4. 前端设计
应用如果: 用户请求改进前端设计质量或报告通用输出。
添加 references/prompt-snippets.md 中的前端美学代码片段。
5. 思考敏感性
当扩展思考未启用时(默认情况下),Opus 4.5 对单词“think”及其变体特别敏感。扩展思考仅在 API 请求包含 thinking 参数时启用。
应用如果: 用户报告与“thinking”相关的问题,而扩展思考未启用(请求中没有 thinking 参数)。
将“think”替换为替代词,如“consider”、“believe”或“evaluate”。
参考
参见 references/prompt-snippets.md 获取每个要添加的代码片段的完整文本。
参见 references/effort.md 配置努力参数(仅当用户请求时)。