extended-thinking changedbuild-with-claude/extended-thinking
Recorded here
Lines+42added
Lines−11removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) #### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
The whole hunk
from line 2, old and new numbered
/
from line 2
22title: Extended thinking
33url: https://platform.claude.com/docs/en/build-with-claude/extended-thinking
44description: Configure manual extended thinking with a fixed budget_tokens budget on Claude models that support it, and migrate to adaptive thinking.
5featureMetadata:
6 supportedModels:
7 - claude-mythos-preview
8 - claude-haiku-4-5-20251001
9 - claude-opus-4-6
10 - claude-sonnet-4-6
11 - claude-opus-4-5-20251101
12 - claude-sonnet-4-5-20250929
13 supportedPlatforms:
14 Claude API: ga
15 Claude Platform on AWS: ga
16 Claude Models on Google Cloud (Anthropic managed): ga
17 Amazon Bedrock: ga
18 Amazon Bedrock (InvokeModel): ga
19 Claude Models on Google Cloud (Google managed): ga
20 Microsoft Foundry: ga
521---
622
7<Note>
8 To learn how zero data retention (ZDR) applies to this feature, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
9</Note>
10
1123<Warning>
12 Extended thinking (`thinking.type: "enabled"` with `budget_tokens`) is deprecated on the Claude 4.6 models (requests using it still succeed). Claude 4.7 and later models do not support it and reject requests that use it, returning a 400 error. On Claude 4.5 and earlier models that support thinking, extended thinking is the only available thinking mode. Claude Mythos Preview supports both modes. Where both modes are available, use [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking) instead.
24 Extended thinking is a legacy feature.
1325
14 See [Migrating to adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#migrating-to-adaptive-thinking) to move to adaptive thinking. If your model supports only extended thinking, this page describes the supported configuration; no change is needed until you move to a newer model.
26 Extended thinking (`thinking.type: "enabled"` with `budget_tokens`) is deprecated. Claude 4.7 and later models do not support it and reject requests that use it, returning a 400 error.
27
28 * Recommended alternative: [Adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking-steering-and-cost)
29 * Migration guide: [Migrating to adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#migrating-to-adaptive-thinking)
1530</Warning>
1631
17<Note>
18 If a request fails with a 400 error whose message starts with `"thinking.type.enabled" is not supported`, your model uses adaptive thinking instead. See [Troubleshooting thinking](https://platform.claude.com/docs/en/build-with-claude/thinking-troubleshooting#error-thinking-type-enabled), or jump to [Migrating to adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#migrating-to-adaptive-thinking).
19</Note>
20
2132Extended thinking in manual mode gives you direct control over how much Claude thinks. You set a thinking token budget on each request with `thinking: {type: "enabled", budget_tokens: N}`, and Claude thinks against that budget before it starts its final answer. Manual mode remains useful when your workload requires predictable latency or precise control over thinking costs. This page covers how to set and tune the budget, how manual mode interacts with interleaved thinking and prompt caching, and how to migrate to adaptive thinking.
2233
2334To learn how thinking itself works, including thinking blocks and the response shape, the `display` parameter, streaming, thinking with tool use, and encryption, see the [thinking overview](https://platform.claude.com/docs/en/build-with-claude/thinking).
from line 416
405416 Preserve thinking blocks and manage thinking across tool calls and turns.
406417 </Card>
407418</CardGroup>
419
420## Availability
421
422Extended thinking is available or deprecated on select models.
423
424### API support
425
426#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
427
428* Availability: Available
429
430| Status | Models |
431| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
432| Available | Claude Mythos Preview, [Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview), [Claude Opus 4.5](https://platform.claude.com/docs/en/models/opus-4-5/overview), [Claude Sonnet 4.5](https://platform.claude.com/docs/en/models/sonnet-4-5/overview) |
433| Deprecated | [Claude Opus 4.6](https://platform.claude.com/docs/en/models/opus-4-6/overview), [Claude Sonnet 4.6](https://platform.claude.com/docs/en/models/sonnet-4-6/overview) |
434
435#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
436
437* Availability: Not available
438* Usage: On Claude 4.5 models, Managed Agents turns on manual thinking itself with a fixed budget you can’t change. On newer models it uses adaptive thinking. Use [Effort](https://platform.claude.com/docs/en/build-with-claude/effort) instead.
408439
No line in this hunk matches that.