Claude API

Claude Sonnet 5 API移行ガイド — adaptive thinking常時有効化・手動Extended Thinking削除・サンプリングパラメータ400エラー・新トークナイザーの4つの破壊的変更

元記事を読む(platform.claude.com) ↗

Summary

6月30日のClaude Platform Changelogで、Sonnet 4.6からSonnet 5への移行時に4つの破壊的変更が公式ドキュメント化。(1)adaptive thinkingがデフォルトで有効化（Sonnet 4.6ではオプトイン）、(2)手動Extended Thinking（`thinking: {type: "enabled", budget_tokens: N}`）が削除され400エラーを返す（Sonnet 4.6で非推奨化済み）、(3)サンプリングパラメータ（temperature・top_p・top_k）の非デフォルト値設定が400エラーを返す（Opus 4.7+と同じ仕様）、(4)新トークナイザーにより同一テキストで約30%多いトークンが生成される。またPriority Tierは未対応。Fable 5・Mythos 5と同じトークナイザーを使用しており、トークン数見積もりへの影響が大きい。

Key Takeaways

  • ▸ adaptive thinking常時有効化でSonnet 5は常に推論品質が向上する一方、思考トークンのコスト増に注意
  • ▸ 手動Extended Thinking削除はSonnet 4.6で非推奨化済みのため大半のユーザーに影響なし
  • ▸ temperature/top_p/top_k非デフォルト値の400エラーはOpus 4.7+と同仕様 — 出力多様性はプロンプト指示で代替
  • ▸ 新トークナイザーで同一テキスト約30%多いトークン生成 — コスト見積もり・コンテキストウィンドウ管理に直接影響
  • ▸ Priority Tier未対応 — 高スループット要件にはOpus 4.8を継続利用
  • ▸ Token Counting API（`model: "claude-sonnet-5"`）で新トークナイザーでのトークン数を事前確認可能

Best Practice Updates

  • ✓ Sonnet 4.6→Sonnet 5移行前にToken Counting APIで既存プロンプトのトークン数変化（約30%増）を確認し、コンテキストウィンドウ・コスト見積もりを再計算すべき
  • ✓ サンプリングパラメータ依存のワークフローは移行前にプロンプトベース行動制御への置き換えが必須
  • ✓ adaptive thinking常時有効化によりeffortパラメータとの相互作用を検証し、ワークロード別の最適effort設定を再評価すべき

Same Day Signals

すべて見る →

元記事の著作権は各著作者に帰属します。