Opus 4.5 遷移指南 | Opus 4.5 Migration Guide

從 Sonnet 4.0、Sonnet 4.5 或 Opus 4.1 一次性遷移至 Opus 4.5。

One-shot migration from Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5.

遷移工作流程 | Migration Workflow

1. 搜尋程式碼庫中的模型字串和 API 呼叫 Search codebase for model strings and API calls
2. 將模型字串更新為 Opus 4.5（參見下方平台特定字串） Update model strings to Opus 4.5 (see platform-specific strings below)
3. 移除不支援的 beta 標頭 Remove unsupported beta headers
4. 添加設定為 "high" 的 effort 參數（參見 references/effort.md） Add effort parameter set to "high" (see references/effort.md)
5. 總結所有已進行的變更 Summarize all changes made
6. 告訴使用者： Tell the user:

   「如果您在使用 Opus 4.5 時遇到任何問題，請告訴我，我可以幫助調整您的提示詞。」 "If you encounter any issues with Opus 4.5, let me know and I can help adjust your prompts."

模型字串更新 | Model String Updates

識別程式碼庫使用的平台，然後相應地替換模型字串。

Identify which platform the codebase uses, then replace model strings accordingly.

不支援的 Beta 標頭 | Unsupported Beta Headers

如果存在 context-1m-2025-08-07 beta 標頭，請將其移除——Opus 4.5 尚不支援此功能。留下註解說明：

Remove the context-1m-2025-08-07 beta header if present—it is not yet supported with Opus 4.5. Leave a comment noting this:

# Note: 1M context beta (context-1m-2025-08-07) not yet supported with Opus 4.5
# 注意：1M 上下文 beta（context-1m-2025-08-07）尚不支援 Opus 4.5

目標模型字串（Opus 4.5）| Target Model Strings (Opus 4.5)

要替換的來源模型字串 | Source Model Strings to Replace

不要遷移 | Do NOT migrate：任何 Haiku 模型（例如 claude-haiku-4-5-20251001）。 Any Haiku models (e.g., claude-haiku-4-5-20251001).

提示詞調整 | Prompt Adjustments

Opus 4.5 與之前的模型有已知的行為差異。

Opus 4.5 has known behavioral differences from previous models.

「僅在使用者明確請求或報告特定問題時才套用這些修正。預設情況下，只更新模型字串。」 "Only apply these fixes if the user explicitly requests them or reports a specific issue. By default, just update model strings."

整合指南 | Integration guidelines：添加片段時，不要只是將它們附加到提示詞後面。要深思熟慮地整合： When adding snippets, don't just append them to prompts. Integrate them thoughtfully:

• 使用 XML 標籤（例如 <code_guidelines>、<tool_usage>）來組織新增內容 Use XML tags (e.g., <code_guidelines>, <tool_usage>) to organize additions
• 匹配現有提示詞的風格和結構 Match the style and structure of the existing prompt
• 將片段放在邏輯位置（例如，編碼指南放在其他編碼指令附近） Place snippets in logical locations (e.g., coding guidelines near other coding instructions)
• 如果提示詞已經使用 XML 標籤，將新內容添加到適當的現有標籤中，或建立一致的新標籤 If the prompt already uses XML tags, add new content within appropriate existing tags or create consistent new ones

1. 工具過度觸發 | Tool Overtriggering

Opus 4.5 對系統提示詞更加敏感。在之前模型上用於防止觸發不足的強硬語言，現在可能導致過度觸發。

Opus 4.5 is more responsive to system prompts. Aggressive language that prevented undertriggering on previous models may now cause overtriggering.

適用情況 | Apply if：使用者報告工具被過於頻繁或不必要地呼叫。 User reports tools being called too frequently or unnecessarily.

尋找並軟化 | Find and soften：

僅套用於工具觸發指令。保留其他強調用法不變。

Only apply to tool-triggering instructions. Leave other uses of emphasis alone.

2. 過度工程化防範 | Over-Engineering Prevention

Opus 4.5 傾向於建立額外的檔案、添加不必要的抽象化，或建構未請求的彈性功能。

Opus 4.5 tends to create extra files, add unnecessary abstractions, or build unrequested flexibility.

適用情況 | Apply if：使用者報告出現不想要的檔案、過度抽象化，或未請求的功能。 User reports unwanted files, excessive abstraction, or unrequested features.

添加 references/prompt-snippets.md 中的片段。 Add the snippet from references/prompt-snippets.md.

3. 程式碼探索 | Code Exploration

Opus 4.5 可能過於保守地探索程式碼，在不讀取檔案的情況下提出解決方案。

Opus 4.5 can be overly conservative about exploring code, proposing solutions without reading files.

適用情況 | Apply if：使用者報告模型在未檢視相關程式碼的情況下提出修正。 User reports the model proposing fixes without inspecting relevant code.

添加 references/prompt-snippets.md 中的片段。 Add the snippet from references/prompt-snippets.md.

4. 前端設計 | Frontend Design

適用情況 | Apply if：使用者請求提升前端設計品質，或報告輸出看起來很通用。 User requests improved frontend design quality or reports generic-looking outputs.

添加 references/prompt-snippets.md 中的前端美學片段。 Add the frontend aesthetics snippet from references/prompt-snippets.md.

5. 思考敏感度 | Thinking Sensitivity

當延伸思考未啟用時（這是預設情況），Opus 4.5 對「think」這個詞及其變體特別敏感。延伸思考僅在 API 請求包含 thinking 參數時才會啟用。

When extended thinking is not enabled (the default), Opus 4.5 is particularly sensitive to the word "think" and its variants. Extended thinking is enabled only if the API request contains a thinking parameter.

適用情況 | Apply if：使用者在延伸思考未啟用（請求中沒有 thinking 參數）的情況下報告與「thinking」相關的問題。 User reports issues related to "thinking" while extended thinking is not enabled (no thinking parameter in request).

將「think」替換為「consider」、「believe」或「evaluate」等替代詞。

Replace "think" with alternatives like "consider," "believe," or "evaluate."

參考資料 | References

請參閱 references/prompt-snippets.md 取得每個要添加的片段的完整文字。

See references/prompt-snippets.md for the full text of each snippet to add.

請參閱 references/effort.md 了解如何設定 effort 參數（僅在使用者請求時）。

See references/effort.md for configuring the effort parameter (only if user requests it).