このガイドでは、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（type）とstr_replace_based_edit_tool（name）に更新してください。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のベータ機能です。すべての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",
    # token-efficient-toolsベータヘッダーなし
    ...
)
  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ベータヘッダーを削除（該当する場合）
  • output-128k-2025-02-19ベータヘッダーを削除（該当する場合）
  • Claude 4ベストプラクティスに従ってプロンプトを確認・更新
  • 複雑な推論タスクに対して拡張思考の有効化を検討
  • model_context_window_exceeded停止理由を処理（Sonnet 4.5固有）
  • 長時間実行エージェントに対してメモリツールの有効化を検討（ベータ）
  • コンテキスト編集のための自動ツール呼び出しクリアの使用を検討（ベータ）
  • 本番デプロイ前に開発環境でテスト

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

  • トークン効率的ツール使用: token-efficient-tools-2025-02-19ベータヘッダーはサポートされていません（手順6を参照）
  • 拡張出力: output-128k-2025-02-19ベータヘッダーはサポートされていません（手順7を参照）
両方のヘッダーはリクエストに含めることができますが、効果はありません。

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

Claude Haiku 4.5は、フロンティアレベルの性能を持つ最速かつ最も知的なHaikuモデルで、インタラクティブアプリケーションと大量の知的処理のためのリアルタイム性能でプレミアムモデル品質を提供します。この移行には、実装の更新が必要な複数の破壊的変更が含まれています。 新機能の完全な概要については、Claude 4.5の新機能を参照してください。
Haiku 4.5の価格は入力トークン100万あたり1ドル、出力トークン100万あたり5ドルです。詳細についてはClaude価格を参照してください。

​
移行手順

  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"}]
    • テキストエディタ: text_editor_20250728とstr_replace_based_edit_toolを使用
    • コード実行: code_execution_20250825を使用
    • undo_editコマンドを使用するコードを削除
  3. サンプリングパラメータを更新する
    これはClaude Haiku 3.5からの破壊的変更です。
    temperatureまたはtop_pのいずれか一方のみを使用し、両方は使用しないでください： 
    # 変更前（Haiku 3.5） - これはHaiku 4.5でエラーになります
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # 両方は使用できません
    ...
)

# 変更後（Haiku 4.5）
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # temperatureまたはtop_pのいずれか一方を使用
    ...
)
  4. 新しいレート制限を確認する Haiku 4.5はHaiku 3.5とは別のレート制限があります。詳細についてはレート制限ドキュメントを参照してください。
  5. 新しいrefusal停止理由を処理する 拒否停止理由を処理するようにアプリケーションを更新してください。
  6. 複雑なタスクに対して拡張思考の有効化を検討する コーディングと推論タスクで大幅な性能向上のために拡張思考を有効にしてください（デフォルトでは無効）： 
    response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
    拡張思考はプロンプトキャッシュ効率に影響します。
  7. 新機能を探索する コンテキスト認識、出力容量の増加（64Kトークン）、知能の向上、速度の改善の詳細については、Claude 4.5の新機能を参照してください。
  8. 実装をテストする すべての破壊的変更が適切に処理されることを確認するため、本番環境にデプロイする前に開発環境でテストしてください。

​
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停止理由を処理
  • 複雑な推論タスクに対して拡張思考の有効化を検討（新機能）
  • 長いセッションでのより良いトークン管理のためにコンテキスト認識を活用
  • より大きなレスポンスに備える（最大出力が8Kから64Kトークンに増加）
  • Claude 4ベストプラクティスに従ってプロンプトを確認・更新
  • 本番デプロイ前に開発環境でテスト

​
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 4.5と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と比較して優れた性能を提供します。

​
サポートが必要ですか？

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