Claude Sonnet 5.5 Released: How It Differs from Sonnet 5, 5 Breaking Changes That Return 400 Errors, and How to Choose Between It and Opus 5.5
On September 28, 2026, Anthropic released Claude Sonnet 5.5, and Sonnet 5 moved to Legacy. This article checks the official documentation (Models overview, the Sonnet 5.5 page, What's new, the migration guide, Pricing, Thinking, Effort and Prompt caching), the announcement, the Claude Code documentation and CHANGELOG, and the GitHub changelog against each other in the original text. It covers the core specs (claude-sonnet-5-5, a 1M context, 128K max output, a June 2026 knowledge cutoff, and retirement not before September 28, 2027), pricing ($2 input and $10 output, the same as Sonnet 5, with cache reads cut from $0.20 at launch to $0.10 on October 7, 2026, while the minimum cacheable length dropped from 1,024 to 512 tokens), and the figures in Anthropic's comparison table (70.6% on Terminal-Bench 4.0, and 1844 on GDPval-AA v2.1, 2 points behind Opus 5.5, though the announcement itself says Opus 5.5 is clearly stronger on complex, open-ended work). It then walks through the five changes that make code that worked on Sonnet 5 fail with a 400 error (turning thinking off moves to between_tools with effort high or below, forced tool use, thinking blocks bound to the model and the conversation, the legacy computer use tool on the Claude API and Google Cloud, and advisor tool pairings) and how to fix them, changes that happen without an error such as text between tool calls moving into thinking blocks, the difference in default effort (high on the API, medium in Claude Code), how to choose between it, Opus 5.5 and Haiku, how to use it in Claude Code (/model sonnet from v2.1.284) and GitHub Copilot, and the migration steps.