Claude 4.5への移行

このガイドでは、Claude 4.5モデルへの2つの主要な移行パスについて説明します：

• Claude Sonnet 3.7 → Claude Sonnet 4.5：最高レベルの推論、コーディング、長時間実行エージェント機能を備えた最も知的なモデル
• Claude Haiku 3.5 → Claude Haiku 4.5：リアルタイムアプリケーションと大量の知的処理向けに、フロンティアに近いパフォーマンスを備えた最速で最も知的なHaikuモデル

どちらの移行にも、実装の更新が必要な破壊的変更が含まれています。このガイドでは、各移行パスについて段階的な手順と明確にマークされた破壊的変更を説明します。

移行を開始する前に、Claude 4.5の新機能を確認して、これらのモデルで利用可能な新機能と機能（拡張思考、コンテキスト認識、動作改善を含む）を理解することをお勧めします。

Claude Sonnet 3.7からClaude Sonnet 4.5への移行

Claude Sonnet 4.5は最も知的なモデルで、推論、コーディング、長時間実行の自律エージェント向けに最高レベルのパフォーマンスを提供します。この移行には、実装の更新が必要な複数の破壊的変更が含まれています。

移行手順

1. モデル名を更新する：

   # 前（Claude Sonnet 3.7）
   model="claude-3-7-sonnet-20250219"
   
   # 後（Claude Sonnet 4.5）
   model="claude-sonnet-4-5-20250929"

2. サンプリングパラメータを更新する

   これはClaude Sonnet 3.7からの破壊的変更です。

   temperatureまたはtop_pのいずれか一方のみを使用し、両方は使用しないでください：

   # 前（Claude Sonnet 3.7）- これはSonnet 4.5でエラーになります
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # 両方は使用できません
       ...
   )
   
   # 後（Claude Sonnet 4.5）
   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       temperature=0.7,  # temperatureまたはtop_pを使用し、両方は使用しません
       ...
   )

3. 新しいrefusal停止理由を処理する

   アプリケーションを更新して、refusal停止理由を処理します：

   response = client.messages.create(...)
   
   if response.stop_reason == "refusal":
       # 拒否を適切に処理します
       pass

4. テキストエディタツールを更新する（該当する場合）

   これはClaude Sonnet 3.7からの破壊的変更です。

   text_editor_20250728（タイプ）とstr_replace_based_edit_tool（名前）に更新します。undo_editコマンドを使用するコードを削除します。

   # 前（Claude Sonnet 3.7）
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # 後（Claude Sonnet 4.5）
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

5. コード実行ツールを更新する（該当する場合）

   code_execution_20250825にアップグレードします。レガシーバージョンcode_execution_20250522は引き続き機能しますが、推奨されません。コード実行ツールドキュメントで移行手順を参照してください。

6. トークン効率的なツール使用ベータヘッダーを削除する

   トークン効率的なツール使用はClaude 3.7 Sonnetでのみ機能するベータ機能です。すべてのClaude 4モデルには組み込みのトークン効率的なツール使用があるため、ベータヘッダーを含める必要はなくなりました。

   リクエストからtoken-efficient-tools-2025-02-19ベータヘッダーを削除します：

   # 前（Claude Sonnet 3.7）
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["token-efficient-tools-2025-02-19"],  # これを削除します
       ...
   )
   
   # 後（Claude Sonnet 4.5）
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # トークン効率的なツールベータヘッダーなし
       ...
   )

7. 拡張出力ベータヘッダーを削除する

   拡張出力用のoutput-128k-2025-02-19ベータヘッダーはClaude Sonnet 3.7でのみ利用可能です。

   リクエストからこのヘッダーを削除します：

   # 前（Claude Sonnet 3.7）
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["output-128k-2025-02-19"],  # これを削除します
       ...
   )
   
   # 後（Claude Sonnet 4.5）
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # output-128kベータヘッダーなし
       ...
   )

8. 動作変更のためにプロンプトを更新する

   Claude Sonnet 4.5はより簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示が必要です。最適化ガイダンスについては、Claude 4プロンプトエンジニアリングベストプラクティスを確認してください。

9. 複雑なタスクに対して拡張思考を有効にすることを検討する

   コーディングと推論タスクで大幅なパフォーマンス改善のために拡張思考を有効にします（デフォルトでは無効）：

   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 10000},
       messages=[...]
   )
   拡張思考はプロンプトキャッシングの効率に影響します。

10. 実装をテストする

    本番環境にデプロイする前に開発環境でテストして、すべての破壊的変更が適切に処理されていることを確認します。

Sonnet 3.7 → 4.5移行チェックリスト

• モデルIDをclaude-sonnet-4-5-20250929に更新
• 破壊的変更：サンプリングパラメータを更新して、temperatureまたはtop_pのみを使用し、両方は使用しない
• アプリケーションで新しいrefusal停止理由を処理
• 破壊的変更：テキストエディタツールをtext_editor_20250728とstr_replace_based_edit_toolに更新（該当する場合）
• 破壊的変更：undo_editコマンドを使用するコードを削除（該当する場合）
• コード実行ツールをcode_execution_20250825に更新（該当する場合）
• token-efficient-tools-2025-02-19ベータヘッダーを削除（該当する場合）

Claude Sonnet 3.7から削除された機能

• トークン効率的なツール使用：token-efficient-tools-2025-02-19ベータヘッダーはClaude 3.7 Sonnetでのみ機能し、Claude 4モデルではサポートされていません（ステップ6を参照）
• 拡張出力：output-128k-2025-02-19ベータヘッダーはサポートされていません（ステップ7を参照）

両方のヘッダーはClaude 4リクエストに含めることができますが、効果はありません。

Claude Haiku 3.5からClaude Haiku 4.5への移行

Claude Haiku 4.5は最速で最も知的なHaikuモデルで、フロンティアに近いパフォーマンスを備え、インタラクティブアプリケーション向けのリアルタイムパフォーマンスと大量の知的処理を備えたプレミアムモデル品質を提供します。この移行には、実装の更新が必要な複数の破壊的変更が含まれています。

新機能の完全な概要については、Claude 4.5の新機能を参照してください。

移行手順

1. モデル名を更新する：

   # 前（Haiku 3.5）
   model="claude-3-5-haiku-20241022"
   
   # 後（Haiku 4.5）
   model="claude-haiku-4-5-20251001"

2. ツールバージョンを更新する（該当する場合）

   これはClaude Haiku 3.5からの破壊的変更です。

   Haiku 4.5は最新のツールバージョンのみをサポートします：

   # 前（Haiku 3.5）
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # 後（Haiku 4.5）
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

Haiku 3.5 → 4.5移行チェックリスト

• モデルIDをclaude-haiku-4-5-20251001に更新
• 破壊的変更：ツールバージョンを最新に更新（例：text_editor_20250728、code_execution_20250825）- レガシーバージョンはサポートされていません
• 破壊的変更：undo_editコマンドを使用するコードを削除（該当する場合）
• 破壊的変更：サンプリングパラメータを更新して、temperatureまたはtop_pのみを使用し、両方は使用しない
• 新しいレート制限を確認および調整（Haiku 3.5とは異なります）
• アプリケーションで新しいrefusal停止理由を処理
• 複雑な推論タスクに対して拡張思考を有効にすることを検討（新機能）
• 長いセッションでのより良いトークン管理のためにコンテキスト認識を活用

Sonnet 4.5とHaiku 4.5の選択

Claude Sonnet 4.5とClaude Haiku 4.5は両方とも異なる強みを持つ強力なClaude 4モデルです：

Claude Sonnet 4.5を選択（最も知的）：

• 複雑な推論と分析：高度なタスク向けの最高レベルの知能
• 長時間実行の自律エージェント：長期間独立して動作するエージェント向けの優れたパフォーマンス
• 高度なコーディングタスク：高度な計画とセキュリティエンジニアリングを備えた最強のコーディングモデル
• 大規模なコンテキストワークフロー：メモリツールとコンテキスト編集機能を備えた強化されたコンテキスト管理
• 最大の機能が必要なタスク：知能と精度が最優先事項の場合

Claude Haiku 4.5を選択（最速で最も知的なHaiku）：

• リアルタイムアプリケーション：フロンティアに近いパフォーマンスを備えたインタラクティブなユーザー体験向けの高速応答時間
• 大量の知的処理：改善されたスピードを備えた規模での費用対効果の高い知能
• コスト重視のデプロイメント：より低い価格ポイントでのフロンティアに近いパフォーマンス
• サブエージェントアーキテクチャ：マルチエージェントシステム向けの高速で知的なエージェント
• 規模でのコンピュータ使用：費用対効果の高い自律デスクトップおよびブラウザ自動化
• スピードが必要なタスク：フロンティアに近い知能を維持しながら低レイテンシが重要な場合

拡張思考の推奨事項

Claude 4モデル、特にSonnetおよびHaiku 4.5は、コーディングと複雑な推論タスクに拡張思考を使用する場合、大幅なパフォーマンス改善を示します。拡張思考はデフォルトでは無効ですが、要求の厳しい作業に対して有効にすることをお勧めします。

重要：拡張思考はプロンプトキャッシングの効率に影響します。非ツール結果コンテンツが会話に追加されると、思考ブロックはキャッシュから削除され、マルチターン会話でコストが増加する可能性があります。パフォーマンスの利点がキャッシングのトレードオフを上回る場合に思考を有効にすることをお勧めします。

その他の移行シナリオ

上記で説明した主要な移行パス（Sonnet 3.7 → 4.5およびHaiku 3.5 → 4.5）は最も一般的なアップグレードを表しています。ただし、他のClaudeモデルからClaude 4.5に移行している場合があります。このセクションではこれらのシナリオについて説明します。

Claude Sonnet 4 → Sonnet 4.5からの移行

破壊的変更：同じリクエストでtemperatureとtop_pの両方を指定することはできません。

他のすべてのAPI呼び出しは変更なしで機能します。モデルIDを更新し、必要に応じてサンプリングパラメータを調整します：

# 前（Claude Sonnet 4）
model="claude-sonnet-4-20250514"

# 後（Claude Sonnet 4.5）
model="claude-sonnet-4-5-20250929"

Claude Opus 4.1 → Sonnet 4.5からの移行

破壊的変更なし。 すべてのAPI呼び出しは変更なしで機能します。

単にモデルIDを更新します：

# 前（Claude Opus 4.1）
model="claude-opus-4-1-20250805"

# 後（Claude Sonnet 4.5）
model="claude-sonnet-4-5-20250929"

Claude Sonnet 4.5は最も知的なモデルで、最高レベルの推論、コーディング、長時間実行エージェント機能を備えています。ほとんどのユースケースでOpus 4.1と比較して優れたパフォーマンスを提供します。

Claude Opus 4.1 → Opus 4.5からの移行

破壊的変更なし。 すべてのAPI呼び出しは変更なしで機能します。

単にモデルIDを更新します：

# 前（Claude Opus 4.1）
model="claude-opus-4-1-20250805"

# 後（Claude Opus 4.5）
model="claude-opus-4-5-20251101"

Claude Opus 4.5は最も知的なモデルで、最大の機能と実用的なパフォーマンスを組み合わせています。ビジョン、コーディング、コンピュータ使用で段階的な改善を特徴とし、Opus 4.1よりもアクセスしやすい価格ポイントで提供されます。複雑な専門的なタスクとプロフェッショナルなソフトウェアエンジニアリングに最適です。

Claude 4.5モデル間での移行

破壊的変更なし。 すべてのAPI呼び出しは変更なしで機能します。

単にモデルIDを更新します。

ヘルプが必要ですか？

• 詳細な仕様については、APIドキュメントを確認してください
• パフォーマンス比較については、モデル機能を確認してください
• APIの更新については、APIリリースノートを確認してください
• 移行中に問題が発生した場合はサポートにお問い合わせください