[ PROMPT_NODE_23896 ]
claude-opus-4-5-migration
[ SKILL_DOCUMENTATION ]
# Opus 4.5 迁移指南
从 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 一键迁移至 Opus 4.5。
## 迁移工作流
1. 在代码库中搜索模型字符串和 API 调用
2. 将模型字符串更新为 Opus 4.5(参见下方的平台特定字符串)
3. 移除不受支持的 beta 请求头
4. 添加 `effort` 参数并设置为 `"high"`(参见 `references/effort.md`)
5. 总结所做的所有更改
6. 告知用户:“如果您在使用 Opus 4.5 时遇到任何问题,请告诉我,我可以帮助调整您的提示词。”
## 模型字符串更新
识别代码库使用的平台,然后相应地替换模型字符串。
### 不受支持的 Beta 请求头
如果存在 `context-1m-2025-08-07` beta 请求头,请将其移除 — Opus 4.5 尚不支持该功能。留下注释说明这一点:
python
# Note: 1M context beta (context-1m-2025-08-07) not yet supported with 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 标签(例如 ``, ``)来组织新增内容
- 匹配现有提示词的风格和结构
- 将片段放置在逻辑位置(例如,将编码指南放在其他编码说明附近)
- 如果提示词已经使用了 XML 标签,请将新内容添加到适当的现有标签内,或创建一致的新标签
### 1. 工具过度触发