Claude API

Claude Sonnet 5.5 API移行で5つの破壊的変更 — Thinking Mode無効化方法変更・Forced Tool Use廃止・Account-Bound Thinking Blocks導入でSonnet 5からの移行に注意が必要

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

Summary

9月28日のClaude Sonnet 5.5 GA時にPlatform Release Notesで5つの破壊的変更が公開。(1)Thinking Mode無効化方法変更 — `thinking: {"type": "disabled"}`ではなく`thinking: {"type": "between_tools"}`を`high` effort以下で送信する必要あり、(2)Forced Tool Use廃止 — `tool_choice`の`any`・`tool`タイプが400エラーを返却、(3)Thinking Blocksがモデル・会話に紐づけ — 異なるモデルや会話へのthinking blocks転用が不可に、(4)Computer Use Toolの旧バージョン拒否 — `computer_20251124`がClaude API・Google Cloudで非対応に、(5)Advisor Toolの旧モデル拒否 — Opus 4.8・Opus 4.7・Sonnet 5をアドバイザーとして指定すると拒否。さらにAccount-Bound Thinking Blocksが導入され、Sonnet 5.5で生成されたthinking blocksは生成アカウントまたはリンクアカウントでのみ使用可能に(他アカウントではドロップ)。蒸留対策Preserved Thinkingの強化措置。

Key Takeaways

  • ▸ 5つの破壊的変更でSonnet 5コードがSonnet 5.5で動作しないケースあり — 移行ガイドの確認が必須
  • ▸ Forced Tool Use(`tool_choice: any/tool`)が完全廃止 — プロンプト内でのツール呼び出し指示に設計変更が必要
  • ▸ Account-Bound Thinking Blocks — 蒸留対策としてthinking blocksがアカウントに紐づけられ、他アカウントへの転用が不可
  • ▸ Advisor Toolで旧モデル拒否 — Sonnet 5.5のアドバイザーにはOpus 5.5等の新モデルのみ指定可能
  • ▸ Computer Use Tool旧バージョン非対応 — `computer_toolset_20260801`への移行が必要

Best Practice Updates

  • ✓ Sonnet 5→5.5移行前にAPI互換性テストを実施 — 特にForced Tool Use・Thinking Mode無効化・Advisor Tool設定の3点を優先確認
  • ✓ Account-Bound Thinking Blocksの影響を評価 — マルチアカウント環境でthinking blocks共有が不可になるため蒸留対策の影響範囲を確認

Same Day Signals

すべて見る →

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