thinking changedbuild-with-claude/thinking
Recorded here
Lines+71added
Lines−3removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits37to 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) ### Data handling
The whole hunk
from line 2, old and new numbered
/
from line 2
22title: Thinking
33url: https://platform.claude.com/docs/en/build-with-claude/thinking
44description: "Understand how Claude's thinking works: turn it on, read thinking output, steer thinking depth with effort, and use thinking with tools, caching, and streaming."
5featureMetadata:
6 status: ga
7 zdr:
8 eligibility: eligible
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements).
10 supportedModels:
11 - claude-fable-5-1
12 - claude-mythos-5-1
13 - claude-fable-5
14 - claude-mythos-5
15 - claude-mythos-preview
16 - claude-opus-5-5
17 - claude-opus-5
18 - claude-sonnet-5-5
19 - claude-sonnet-5
20 - claude-haiku-5-5
21 - claude-haiku-4-5-20251001
22 - claude-opus-4-8
23 - claude-opus-4-7
24 - claude-opus-4-6
25 - claude-sonnet-4-6
26 - claude-opus-4-5-20251101
27 - claude-sonnet-4-5-20250929
28 supportedPlatforms:
29 Claude API: ga
30 Claude Platform on AWS: ga
31 Claude Models on Google Cloud (Anthropic managed): ga
32 Amazon Bedrock: ga
33 Amazon Bedrock (InvokeModel): ga
34 Claude Models on Google Cloud (Google managed): ga
35 Microsoft Foundry: ga
536---
637
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>
38**API support**: Usage differs by product.
1039
40* **Messages API**: On by default. Turn it off with `thinking: {"type": "disabled"}`. Where it is off by default, set `thinking` to turn it on.
41* **Managed Agents**: Always on. Managed Agents sets the thinking configuration; the agent definition has no `thinking` field.
42
1143A model that answers in a single pass has to get everything right on the first try: no scratch work, no checking, no changing approach halfway through. For a proof, a tricky bug, or a long agentic task, the first approach is often not the best one.
1244
1345Thinking removes that constraint. When thinking is active, Claude works through the problem in its own words before answering: it restates what is being asked, tries approaches, checks intermediate results, and abandons paths that do not hold up. That up-front thinking arrives in `thinking` content blocks ahead of the response, and Claude draws on it to produce the final answer. This is why thinking improves performance on complex tasks such as math, coding, analysis, and long-running agentic work, where the quality of the answer depends on intermediate work that would otherwise be compressed into the response itself or skipped.
from line 1280
12481280 Control how many tokens Claude uses when responding with the effort parameter, trading off between response thoroughness and token efficiency.
12491281 </Card>
12501282</CardGroup>
1283
1284## Availability
1285
1286Thinking is available on every model and eligible for zero data retention and HIPAA readiness.
1287
1288### API support
1289
1290#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1291
1292* Availability: On by default
1293* Usage: Turn it off with `thinking: {"type": "disabled"}`. Where it is off by default, set `thinking` to turn it on.
1294
1295| Status | Cloud platforms |
1296| --------- | ----------------------- |
1297| Available | All supported platforms |
1298
1299#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1300
1301* Availability: Always on
1302* Usage: Managed Agents sets the thinking configuration; the agent definition has no `thinking` field.
1303
1304| Status | Cloud platforms |
1305| --------- | ----------------------- |
1306| Available | All supported platforms |
1307
1308### Data handling
1309
1310[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1311
1312| Item | Zero data retention | HIPAA |
1313| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
1314| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
1315
1316Applicable endpoints:
1317
1318* `/v1/messages` with `thinking`
12511319
No line in this hunk matches that.