SPB Git

Repository Public

whats-new-claude-4-7.md 18.7 KB 354 lines markdown

1---2title: What's new in Claude Opus 53url: https://platform.claude.com/docs/en/models/opus-5/whats-new-opus-54description: Overview of new features and behavior changes in Claude Opus 5.5---67Claude Opus 5 is a step-change improvement over Claude Opus 4.8, with the largest gains in deep reasoning, agentic and long-horizon tasks, and test-time compute scaling. This page summarizes everything new in Claude Opus 5, including mid-conversation tool changes and two breaking changes for code running on Claude Opus 4.8: thinking is on by default, and thinking can be disabled only at effort `high` or below.89## New model1011| Model         | API model ID    | Description                                    |12| ------------- | --------------- | ---------------------------------------------- |13| Claude Opus 5 | `claude-opus-5` | For complex agentic coding and enterprise work |1415Claude Opus 5 has a [1M token context window](https://platform.claude.com/docs/en/build-with-claude/context-windows) (1M tokens is both the default and the maximum; there is no smaller context variant), 128k max output tokens, and [thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) on by default. [Priority Tier](https://platform.claude.com/docs/en/api/service-tiers#supported-models) is not supported on Claude Opus 5.1617For complete pricing and specs, see the [models overview](https://platform.claude.com/docs/en/models/overview).1819## New features2021### Mid-conversation tool changes (beta)2223You can add or remove tools between turns of a conversation while preserving the prompt cache, instead of resending a fixed tool list for the life of a session. Mid-conversation tool changes are in beta: include the `mid-conversation-tool-changes-2026-07-01` beta header in your requests. See [Mid-conversation tool changes](https://platform.claude.com/docs/en/build-with-claude/mid-conversation-system-messages#mid-conversation-tool-changes) for usage.2425### Default fallbacks mode2627The `fallbacks` parameter supports a new `"default"` mode, which applies Anthropic's recommended fallback models by refusal category instead of a model list you maintain yourself. The entire `fallbacks` parameter is in beta. Use the `server-side-fallback-2026-07-01` beta header, which supports both the `"default"` mode and explicit model lists (the earlier `server-side-fallback-2026-06-01` header accepts only explicit lists). See [Refusals and fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback).2829### Lower prompt cache minimum3031The minimum cacheable prompt length on Claude Opus 5 is 512 tokens, down from 1,024 tokens on Claude Opus 4.8. Prompts that were too short to cache on Claude Opus 4.8 can now create cache entries with no code changes. See [Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-limitations) for per-model minimums.3233### Fast mode3435[Fast mode](https://platform.claude.com/docs/en/build-with-claude/fast-mode) (research preview) is available for Claude Opus 5 on the Claude API only; it is not currently available on Amazon Bedrock, Claude Platform on AWS, Google Cloud, or Microsoft Foundry. Fast mode for Claude Opus 5 is priced at $10 USD per million input tokens and $50 USD per million output tokens. See [Fast mode](https://platform.claude.com/docs/en/build-with-claude/fast-mode) for access, supported models, and pricing.3637## Behavior changes3839### Thinking on by default4041On Claude Opus 4.8, requests run without thinking unless you set `thinking: {"type": "adaptive"}`. On Claude Opus 5, the same requests run with [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) on by default: the model decides when and how much to think on each turn, and the [effort parameter](https://platform.claude.com/docs/en/build-with-claude/effort) is the control for thinking depth. The wire value is unchanged; `thinking: {"type": "adaptive"}` remains valid and equivalent to the default.4243This is a breaking change for code that ran without thinking on Claude Opus 4.8. A response can begin with one or more `thinking` blocks before the first `text` block, returned with an empty `thinking` field at the default `display: "omitted"`, so code that reads `content[0].text` or treats the first streamed content block as text must select content blocks by their `type` field instead. Tool-use loops must pass `thinking` blocks back complete and unmodified with their tool results; see [Preserving thinking blocks](https://platform.claude.com/docs/en/build-with-claude/thinking#preserving-thinking-blocks).4445Thinking tokens are billed as output tokens and count toward `max_tokens`, a hard limit on total output (thinking plus response text), so revisit `max_tokens` and re-baseline cost for workloads that ran without thinking on Claude Opus 4.8.4647The API keeps the option to disable thinking, subject to the [effort restriction](https://platform.claude.com/docs/en/models/opus-5/whats-new-opus-5#disabling-thinking-requires-effort-high-or-below) on disabling it.4849### Effort matters more5051Claude Opus 5 converts additional [effort](https://platform.claude.com/docs/en/build-with-claude/effort) into better results more reliably than any earlier Opus model, so the effort level you choose carries more weight. The full ladder is available: `low`, `medium`, `high`, `xhigh`, and `max`, with `max` as the top tier for the deepest possible reasoning. Start at the default, `high`, and adjust in either direction based on your evals: step down where quality holds to save tokens and latency, or step up for the most demanding work. When running at `xhigh` or `max` effort, set a large `max_tokens` so the model has room to think and act across subagents and tool calls.5253This request turns effort all the way up to `max`:5455<CodeGroup>56  ```bash cURL57  curl https://api.anthropic.com/v1/messages \58    -H "x-api-key: $ANTHROPIC_API_KEY" \59    -H "anthropic-version: 2023-06-01" \60    -H "content-type: application/json" \61    -d '{62      "model": "claude-opus-5",63      "max_tokens": 64000,64      "stream": true,65      "output_config": {66        "effort": "max"67      },68      "messages": [69        {70          "role": "user",71          "content": "Explain why the sum of two even numbers is always even."72        }73      ]74    }'75  ```7677  ```bash CLI78  # 64k max_tokens can run past the non-streaming time limit; stream the events.79  ant messages create --stream --format jsonl <<'YAML'80  model: claude-opus-581  max_tokens: 6400082  output_config:83    effort: max84  messages:85    - role: user86      content: Explain why the sum of two even numbers is always even.87  YAML88  ```8990  ```python Python91  client = anthropic.Anthropic()9293  with client.messages.stream(94      model="claude-opus-5",95      max_tokens=64000,96      output_config={"effort": "max"},97      messages=[98          {99              "role": "user",100              "content": "Explain why the sum of two even numbers is always even.",101          }102      ],103  ) as stream:104      response = stream.get_final_message()105106  print(response)107  ```108109  ```typescript TypeScript110  const client = new Anthropic();111112  const stream = client.messages.stream({113    model: "claude-opus-5",114    max_tokens: 64000,115    output_config: {116      effort: "max"117    },118    messages: [119      {120        role: "user",121        content: "Explain why the sum of two even numbers is always even."122      }123    ]124  });125126  const response = await stream.finalMessage();127  console.log(response);128  ```129130  ```csharp C#131  AnthropicClient client = new();132133  var parameters = new MessageCreateParams134  {135      Model = Model.ClaudeOpus5,136      MaxTokens = 64000,137      OutputConfig = new OutputConfig138      {139          Effort = Effort.Max140      },141      Messages = [new() { Role = Role.User, Content = "Explain why the sum of two even numbers is always even." }]142  };143144  var response = await client.Messages.CreateStreaming(parameters).Aggregate();145  Console.WriteLine(response);146  ```147148  ```go Go149  client := anthropic.NewClient()150151  stream := client.Messages.NewStreaming(context.TODO(), anthropic.MessageNewParams{152  	Model:     anthropic.ModelClaudeOpus5,153  	MaxTokens: 64000,154  	OutputConfig: anthropic.OutputConfigParam{155  		Effort: anthropic.OutputConfigEffortMax,156  	},157  	Messages: []anthropic.MessageParam{158  		anthropic.NewUserMessage(anthropic.NewTextBlock("Explain why the sum of two even numbers is always even.")),159  	},160  })161162  response := anthropic.Message{}163  for stream.Next() {164  	event := stream.Current()165  	if err := response.Accumulate(event); err != nil {166  		log.Fatal(err)167  	}168  }169  if err := stream.Err(); err != nil {170  	log.Fatal(err)171  }172173  fmt.Println(response)174  ```175176  ```java Java177  AnthropicClient client = AnthropicOkHttpClient.fromEnv();178179  MessageCreateParams params = MessageCreateParams.builder()180      .model(Model.CLAUDE_OPUS_5)181      .maxTokens(64000L)182      .outputConfig(OutputConfig.builder()183          .effort(OutputConfig.Effort.MAX)184          .build())185      .addUserMessage("Explain why the sum of two even numbers is always even.")186      .build();187188  MessageAccumulator accumulator = MessageAccumulator.create();189  try (var streamResponse = client.messages().createStreaming(params)) {190      streamResponse.stream().forEach(accumulator::accumulate);191  }192193  Message response = accumulator.message();194  IO.println(response);195  ```196197  ```php PHP198  $client = new Client();199200  $stream = $client->messages->createStream(201      maxTokens: 64000,202      messages: [203          ['role' => 'user', 'content' => 'Explain why the sum of two even numbers is always even.']204      ],205      model: Model::CLAUDE_OPUS_5,206      outputConfig: ['effort' => Effort::MAX],207  );208209  $accumulator = MessageAccumulator::forMessages();210  foreach ($stream as $event) {211      $accumulator->accumulate($event);212  }213214  echo $accumulator->message();215  ```216217  ```ruby Ruby218  client = Anthropic::Client.new219220  response = client.messages.stream(221    model: Anthropic::Model::CLAUDE_OPUS_5,222    max_tokens: 64000,223    output_config: {224      effort: :max225    },226    messages: [227      { role: "user", content: "Explain why the sum of two even numbers is always even." }228    ]229  ).accumulated_message230231  puts response232  ```233</CodeGroup>234235Thinking is [on by default](https://platform.claude.com/docs/en/models/opus-5/whats-new-opus-5#thinking-on-by-default) on Claude Opus 5, so no `thinking` field is needed.236237### Disabling thinking requires effort `high` or below238239On Claude Opus 5, `thinking: {"type": "disabled"}` is accepted only when the effort level is `high` or below. Setting `thinking: {"type": "disabled"}` with effort `xhigh` or `max` returns a 400 error. This rule is enforced on every request to Claude Opus 5 and later models. It is a breaking change from Claude Opus 4.8, where disabling thinking was independent of the effort level. If your Claude Opus 4.8 requests disable thinking at effort `xhigh` or `max`, either keep thinking disabled and set effort to `high` or below, or keep the effort level and remove the `thinking` field.240241With thinking disabled, Claude Opus 5 can occasionally write a tool call into its text output instead of emitting a `tool_use` block, or include internal XML tags in its visible response. Where possible, keep thinking enabled and control token cost with lower effort levels; for integrations that must keep thinking disabled, see [Running with thinking disabled](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5#running-with-thinking-disabled) for prompting mitigations.242243### Model behavior differences244245Beyond these API changes, Claude Opus 5 behaves differently from Claude Opus 4.8 in ways you may notice without changing any code. Default user-facing responses and written deliverables run longer. In agentic sessions, the model narrates its progress to the user more often. In multi-agent frameworks, it delegates to subagents more readily. It also verifies its own work without being told to, so remove verification instructions carried over from earlier models ("include a final verification step," "use a subagent to verify"); they cause over-verification on Claude Opus 5. For prompting patterns that tune each of these behaviors, see [Prompting Claude Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5).246247## Capability improvements248249Compared with Claude Opus 4.8, Claude Opus 5 is a step-change improvement rather than an incremental one, and it delivers frontier intelligence at half the cost of [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/introducing-claude-fable-5-and-claude-mythos-5). The largest gains are in:250251* **Deep reasoning**, sustaining multistep analysis across long problem chains.252* **Agentic coding and long-horizon tasks**, staying on task across extended tool-use loops and completing multi-file features, larger refactors, and end-to-end feature work without leaving stubs or placeholders.253* **Test-time compute scaling**, converting additional effort (up to the `max` level) into better results.254* **Efficiency at lower effort levels**, with `low` and `medium` [effort](https://platform.claude.com/docs/en/build-with-claude/effort) producing strong quality at a fraction of the tokens and latency of higher settings.255* **Code review and bug-finding**, surfacing real bugs at a high rate per pass with few false positives, and staying accurate at lower effort levels.256* **Vision**, understanding charts, documents, and diagrams and replicating UI and frontend visuals, strongest when given tools to iteratively analyze, crop, and verify its work.257* **Long-context work**, with a [1M token context window](https://platform.claude.com/docs/en/build-with-claude/context-windows) as both the default and the maximum, and consistent instruction following, tool calling, and reasoning throughout the window.258* **Office and document tasks**, generating and editing complex multi-sheet spreadsheets with non-trivial formulas, and producing well-structured slide decks.259* **Multi-agent coordination**, running teams of subagents with effective writer-verifier patterns and few cases of agents overwriting each other's work.260261For the prompting patterns that get the most out of these capabilities, see [Prompting Claude Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5#capability-improvements).262263## Pricing264265Claude Opus 5 is priced at $5 USD per million input tokens and $25 USD per million output tokens, unchanged from Claude Opus 4.8. Because thinking is on by default and thinking tokens are billed as output tokens, a workload that ran without thinking on Claude Opus 4.8 can produce more output tokens per request at the same per-token rates; see [Cost control](https://platform.claude.com/docs/en/build-with-claude/thinking-steering-and-cost#cost-control).266267See [Pricing](https://platform.claude.com/docs/en/about-claude/pricing) for complete pricing, including batch processing, prompt caching, and fast mode rates.268269## Availability270271Claude Opus 5 is available on:272273* **Claude API:** available to all customers, as `claude-opus-5`.274* **AWS:** available through [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), as `anthropic.claude-opus-5`, and through [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws). On Amazon Bedrock, Claude Opus 5 is also reachable through the `InvokeModel` API on `bedrock-runtime`, served by the same infrastructure; the [Claude on Amazon Bedrock (legacy)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) integration does not include it in its ARN-versioned model ID table.275* **Google Cloud:** available through [Claude on Google Cloud](https://platform.claude.com/docs/en/build-with-claude/claude-on-vertex-ai), as `claude-opus-5`.276* **Microsoft Foundry:** available through [Claude in Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry).277278Claude Opus 4.8 remains available on all of these platforms.279280## Migration guide281282To migrate from Claude Opus 4.8, update your model ID:283284<CodeGroup exclude="shell">285  ```python Python286  model = "claude-opus-4-8"  # Before287  model = "claude-opus-5"  # After288  ```289290  ```typescript TypeScript291  let model = "claude-opus-4-8"; // Before292  model = "claude-opus-5"; // After293  ```294295  ```csharp C#296  var model = Model.ClaudeOpus4_8; // Before297  model = Model.ClaudeOpus5; // After298  ```299300  ```go Go301  model := anthropic.ModelClaudeOpus4_8 // Before302  model = anthropic.ModelClaudeOpus5    // After303  ```304305  ```java Java306  Model model = Model.CLAUDE_OPUS_4_8; // Before307  model = Model.CLAUDE_OPUS_5; // After308  ```309310  ```php PHP311  $model = Model::CLAUDE_OPUS_4_8; // Before312  $model = Model::CLAUDE_OPUS_5; // After313  ```314315  ```ruby Ruby316  model = Anthropic::Model::CLAUDE_OPUS_4_8 # Before317  model = Anthropic::Model::CLAUDE_OPUS_5 # After318  ```319</CodeGroup>320321Then review the two breaking changes under [Behavior changes](https://platform.claude.com/docs/en/models/opus-5/whats-new-opus-5#behavior-changes): thinking is on by default (responses can begin with `thinking` blocks, so select content blocks by `type`), and disabling thinking with effort `xhigh` or `max` returns a 400 error. See the [migration guide](https://platform.claude.com/docs/en/models/opus-5/migration-guide#migrating-from-claude-opus-4-8-to-claude-opus-5) for step-by-step instructions and the full checklist.322323## Next steps324325<CardGroup cols={3}>326  <Card title="Models overview" icon="arrow-right" href="https://platform.claude.com/docs/en/models/overview">327    Complete specs and pricing for all current Claude models.328  </Card>329330  <Card title="Prompting Claude Opus 5" icon="terminal" href="https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5">331    Behavioral differences and prompting patterns specific to Claude Opus 5.332  </Card>333334  <Card title="Effort" icon="gauge" href="https://platform.claude.com/docs/en/build-with-claude/effort">335    Control how many tokens Claude uses when responding, from low to max.336  </Card>337338  <Card title="Thinking" icon="brain" href="https://platform.claude.com/docs/en/build-with-claude/thinking">339    How thinking works when it's on by default, and when it can be disabled.340  </Card>341342  <Card title="Task budgets" icon="database" href="https://platform.claude.com/docs/en/build-with-claude/task-budgets">343    Give Claude an advisory token budget to pace its work against.344  </Card>345346  <Card title="Migration guide" icon="code" href="https://platform.claude.com/docs/en/about-claude/models/migration-guide">347    Guide for migrating to the latest Claude models from previous Claude versions.348  </Card>349350  <Card title="Fast mode" icon="bolt" href="https://platform.claude.com/docs/en/build-with-claude/fast-mode">351    Get higher output tokens per second from Claude Opus models at premium pricing.352  </Card>353</CardGroup>354
Files main
Menu

Theme