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 (1P) | 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 (1P) | 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 参数）。
用 “consider,” “believe,” 或 “evaluate.” 等替代词替换 “think”。
参考
见 references/prompt-snippets.md 获取要添加的每个片段的全文。
见 references/effort.md 配置努力参数（仅在用户请求时）。