claude-opus-4-5-migration について
Sonnet 4.0、Sonnet 4.5、Opus 4.1からOpus 4.5へコードベースを一括移行するスキルです。モデル識別子の更新と未対応のベータヘッダーの削除を行い、プロンプトの動作調整は依頼や具体的な問題報告がある場合に限ります。
主な機能
- 01モデル文字列とAPI呼び出しの検索
- 02プラットフォーム別モデル識別子の更新
- 03未対応ベータヘッダーの削除
- 04effortパラメーターをhighに設定
- 05依頼時のみプロンプトを調整
活用シーン
- 01コードベースのOpus 4.5への移行
- 02未対応のcontextベータヘッダーの削除
- 03報告されたツール呼び出し過多への対処
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ anthropics/ claude-code --skill claude-opus-4-5-migrationインストール後、Claude Code で/claude-opus-4-5-migrationを入力して読み込まれたか確認します。
同梱ファイルreferences/effort.mdreferences/prompt-snippets.md
詳細
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 ではまだサポートされていません。この点を示すコメントを残してください。
# 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 タグ(例:
<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. Thinking の敏感性
拡張思考が有効になっていない場合(デフォルト)、Opus 4.5 は「think」という単語およびその派生語に対して特に敏感です。拡張思考は、API リクエストに thinking パラメータが含まれている場合にのみ有効になります。
適用条件: 拡張思考が有効になっていない(リクエストに thinking パラメータがない)状態で、ユーザーが「thinking」に関連する問題を報告した場合。
「think」を「consider」「believe」「evaluate」などの代替語に置き換えてください。
リファレンス
追加する各スニペットの全文については、references/prompt-snippets.md を参照してください。
effort パラメータの設定については、references/effort.md を参照してください(ユーザーが希望した場合のみ)。