claude-opus-5-5 with the native Anthropic Messages API at POST /v1/messages.
Model specifications
What changed from Opus 5
- Always-on thinking — Omit
thinkingor set it to{"type":"adaptive"}. Bothdisabledand manualenabledmodes return400. - New default effort — Requests that omit
output_config.effortusemedium, rather than thehighdefault used by Opus 5. - No forced tool use —
tool_choicesupportsautoandnone. Theanyand namedtoolmodes return400. - Preserved thinking — Keep the conversation prefix unchanged and return prior thinking blocks exactly as received during tool-use and multi-turn workflows.
- Refusal handling — A safeguard refusal can return HTTP
200withstop_reason: "refusal"and additional information instop_details.
Quick example
Core parameters
Adaptive thinking is always on. Use
output_config.effort to balance reasoning depth, latency, and token use. Leave enough room in max_tokens for both thinking and visible output, especially at xhigh or max effort.Tool use
Keeptool_choice at auto (the default) or use none. Describe each tool and its input schema precisely, then state in the prompt when the tool should be used. In a tool loop, inspect content blocks by type instead of assuming the first block contains text.
Multi-turn conversations
When an assistant turn contains thinking blocks, send the complete turn back exactly as received. Treat the system prompt, tool definitions, and earlier messages as append-only. Changing content before an Opus 5.5 thinking block can invalidate the block and return400.
Migrating from Opus 5
- Change the model ID from
claude-opus-5toclaude-opus-5-5. - Remove
thinking: {"type":"disabled"}and manualbudget_tokenssettings. - Set
output_config.effortexplicitly if you need behavior comparable across model versions. - Replace forced
tool_choicemodes withautoornone. - Update refusal handling to check
stop_reasonandstop_details, even when the HTTP status is200.
Anthropic released Claude Opus 5.5 on September 22, 2026. See the official model overview, what’s new, and announcement.
API Reference
View request fields, response blocks, and the interactive API playground.