Opus 4.5移行ガイド
Sonnet 4.0、Sonnet 4.5、またはOpus 4.1からOpus 4.5へのワンショット移行。
移行ワークフロー
- コードベース内のモデル文字列とAPI呼び出しを検索する
- モデル文字列をOpus 4.5に更新する（プラットフォーム固有の文字列は下記参照）
- サポートされていないベータヘッダーを削除する
- effortパラメータを
"high"に設定する（references/effort.md参照） - すべての変更を要約する
- ユーザーに次のように伝える：「Opus 4.5で問題が発生した場合は、お知らせください。プロンプトの調整をサポートします。」
モデル文字列の更新
コードベースが使用しているプラットフォームを特定し、それに応じてモデル文字列を置き換えます。
サポートされていないベータヘッダー
context-1m-2025-08-07ベータヘッダーが存在する場合は削除します。これはOpus 4.5ではまだサポートされていません。次のようなコメントを残します：
# 注意: 1Mコンテキストベータ（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:→ 削除または緩和絶対に...しなければなりません→...するべきです常にXを実行→Xを実行決して...をスキップしない→...をスキップしない必須→ 削除または緩和
ツール発動の指示にのみ適用してください。その他の強調表現はそのままにします。
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は「考える」という単語とそのバリエーションに特に敏感です。拡張思考は、APIリクエストにthinkingパラメータが含まれている場合にのみ有効になります。
適用条件：ユーザーが拡張思考が有効でない（リクエストにthinkingパラメータがない）状態で「考える」に関連する問題を報告した場合。
「考える」を「検討する」「判断する」「評価する」などの代替表現に置き換えます。
参考
追加する各スニペットの全文については、references/prompt-snippets.mdを参照してください。
effortパラメータの設定については、references/effort.mdを参照してください（ユーザーが要求した場合のみ）。