One read of Claude Developer Platformapi-20261028T203725Z
116 pages moved out of 821 read.
Pages moved
116
significant first
Pages read
821
in this capture
Captured
20:37 UTC
Corpus hash
82e28663d5c2
corpus-hash
What this read moved
1-25 of 116, page 1 of 5This capture is too large to show at once. Changes 1-25 of 116 are below, significant first; the rest are on the following screens.
about-claude/models/optimizing-for-cost-and-intelligence Changed · +14 / -4 lines
from line 575
575575
576576## Combine models
577577
578Tune one model before you add a second: sweep effort on your current model first, because most workloads end there, and if the sweep shows a gap, price the stronger model alone at low effort. Build a pairing only if it beats the single model’s whole curve of score against spend. The multi-model results on this page were judged against the same model at lower effort and against the next model down running alone, which is the comparison to run on your own workload.
578Tune one model before you add a second: sweep effort on your current model first, because most workloads end there, and if the sweep shows a gap, price the stronger model alone at low effort. Build a pairing only if it beats the single model’s whole curve of score against spend. On your own workload, judge a pairing against the same model at lower effort and against the next model down running alone.
579579
580580The following table compares the two strategies:
581581
from line 630
630630* Routine work with a long cost tail (an easy slice of BrowseComp[4](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs))
631631* Work larger than one context window (an internal defect-search benchmark[8](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs))
632632
633When the work is one dependent chain, or fits in a single context without a long cost tail, the orchestrator’s model alone at lower effort came out ahead in every case measured, also on earlier models (the harder BrowseComp set and DeepWideSearch[6](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs)); independent external work reports the same pattern[5](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs).
633When the work is one dependent chain, or fits in a single context without a long cost tail, the orchestrator’s model alone at lower effort came out ahead in every case measured on earlier models (the harder BrowseComp set and DeepWideSearch[6](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs)); independent external work reports the same pattern[5](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs).
634634
635635To build an orchestrator, use [multiagent orchestration](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) in Claude Managed Agents: configure an orchestrator agent and worker agents that it can call, each with its own model.
636636
from line 638
638638 
639639</Frame>
640640
641The [Model selection matrix](https://platform.claude.com/docs/en/about-claude/models/choosing-a-model#model-selection-matrix) lists Claude Haiku 5.5 for sub-agent tasks; before you use it as a worker, [measure it on your own workload](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#measure-on-your-own-workload).
642
643641The following chart plots the defect-search benchmark’s configurations by cost and score:
644642
645643<Frame>
from line 648
650648
651649* **Routine work with a long cost tail:** measure this case first, for accuracy as well as cost. The measurement behind it covers only problems that the delegated configuration answered correctly in every run (reference 4).
652650* **Work larger than one context window:** delegate partitions to workers. Lowering effort cannot help, because the bill is the reading itself: on the defect-search benchmark[8](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs), Claude Fable 5.1 alone cost $468 USD to $552 USD per run across its three effort settings and took 15 to 20 hours. With earlier-model workers, delegation cost less and finished sooner, for a lower score.
651* **Claude Haiku 5.5 subagents on coding tasks:** compare them with lower effort first. On an internal coding benchmark on Claude Managed Agents, they were an alternative to lowering effort, not better. Adding them to Claude Opus 5.5 at `medium`, with a short delegation prompt, cut cost per attempt by 32% and the pass rate by about 4 percentage points (95% interval 1.3 to 7.1), about what a mix of `low` and `medium` without subagents would give at that cost[29](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence#refs).
653652
654653## Measure on your own workload
655654
from line 1131
11321131 * **Results, 20-issue run:** On the 20-issue run, where the job with no lever cost $0.42 USD a run, context editing cost 73% more, compaction ran once near the end of each run and cost 7% less, and the prune rewrote nothing, because no search result was over its 2,000-character threshold.
11331132 * **Results, long run:** On the long run, where the job with no lever cost $1.09 USD a run, the prune cost 39% less, compaction 32% less, and context editing 4% more.
11341133 * **Cache reads, long runs:** In the long runs with the prune, 89% of prompt tokens were read from the cache on the first request after a task boundary and 81% on the other requests. Over the whole of the long runs, 85% of prompt tokens were read from the cache with the prune and 85% with context editing, against 95% with no lever.
1134
113529. **Internal coding benchmark (subagent measurement):**
1136
1137 * **What was measured:** 134 repository coding tasks, each graded pass or fail by tests the agent cannot see, five attempts per task in each of three runs, October 21 to 23, 2026, on [Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) with its own [multiagent orchestration](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) (the `multiagent_20261001` type): one predefined agent as the subagent, with inline agents and dynamic workflows turned off.
1138 * **Configurations:** Claude Opus 5.5 alone at `medium`, its default, and at `low`; and Claude Opus 5.5 at `medium` with Claude Haiku 5.5 subagents at `medium`, once with no added prompt and once with a 113-word delegation prompt as the orchestrator’s system prompt. A fifth configuration, with a longer prompt, is not reported. The evaluation set no thinking option, so thinking ran at its default: on, with the model choosing when to think.
1139 * **Tools:** Every agent used two custom tools, a shell and a file editor that the evaluation runs in each attempt’s own sandbox, in place of the platform’s built-in tools. As part of the evaluation’s safety setup, their calls went through an extra check. In the documented setup, [permission policies do not apply to custom tools](https://platform.claude.com/docs/en/managed-agents/permission-policies#custom-tools).
1140 * **Results:** Attempts passed and cost per attempt were 72.1% and $4.78 USD for Claude Opus 5.5 alone at `medium`; 68.8% and $3.35 USD with subagents and no added prompt; 67.9% and $3.27 USD with subagents and the prompt; and 63.0% and $1.84 USD alone at `low`.
1141 * **Compared with Claude Opus 5.5 alone at `medium`:** With the prompt, 32% less cost (95% interval 29% to 35%) and 4.2 percentage points fewer passed (1.3 to 7.1). With no added prompt, 30% less (27% to 33%) and 3.3 fewer (0.8 to 5.8). Alone at `low`, 62% less (59% to 64%) and 9.1 fewer (5.0 to 13.3), a comparison added after the runs. Differences are paired by task within each run, and the intervals are bootstrap intervals over the 134 tasks.
1142 * **Compared with lower effort:** Sending a share of tasks to `low` and the rest to `medium` gives a straight line between those two results, a calculation and not a run. At their own cost, the configurations with subagents passed 0.5 percentage points more than that line with the prompt (2.3 fewer to 3.2 more) and 1.1 more with no added prompt (1.2 fewer to 3.3 more): neither above nor below it. The cost per passed attempt was $6.63 USD alone at `medium`, $4.86 USD with subagents and no added prompt, $4.81 USD with the prompt, and $2.92 USD at `low`.
1143 * **How priced:** Costs are token costs at list prices with 5-minute prompt caching, each request priced on its own prompt length ([Long context pricing](https://platform.claude.com/docs/en/about-claude/pricing#long-context-pricing)), and exclude session runtime. The costs leave out the evaluation’s extra check on tool calls; with it counted, the saving with the prompt is 27% (25% to 30%).
1144 * **What counts as a failure:** An attempt counts as a failure if a safety check stopped it, if the platform’s safeguard refused a turn, or if the evaluation voided it because it could not confirm that its safety checks saw every step. Voided attempts fell only on the configurations with subagents: 72 of 2,010 with the prompt, 57 of them in one run. With that configuration’s part of the run made again, it passed 3.6 percentage points fewer than Claude Opus 5.5 alone (1.0 to 6.3). With every attempt that a safety check stopped or the evaluation voided left out on both sides instead, it passed 1.7 fewer (4.4 fewer to 1.1 more). So part of the loss, but not all of it, comes from the evaluation’s own rules. One attempt of Claude Opus 5.5 alone at `medium`, cut at the three-hour limit, has no result and is left out; with subagents, the same cut counts as a failure.
11351145
11361146## Next steps
11371147
agents-and-tools/agent-skills/overview Changed · +77 / -7 lines
## 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
from line 2
22title: Agent Skills
33url: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
44description: Agent Skills are modular capabilities that extend Claude's functionality. Each Skill packages instructions, metadata, and optional resources (scripts, templates) that Claude uses automatically when relevant.
5featureMetadata:
6 status: ga
7 zdr:
8 eligibility: not-eligible
9 note: Skill data retained according to standard policy.
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 Microsoft Foundry (hosted on Anthropic):
33 availability: ga
34 note: Hosted on Anthropic deployments only; the skill version download endpoint (`GET /v1/skills/{skill_id}/versions/{version}/content`) is not supported on Foundry.
535---
636
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>
37**API support**: Usage differs by product.
1038
39* **Messages API**: List `skill_ids` in the `container` parameter and include the code execution tool, whose container the skills run in.
40* **Managed Agents**: Attach skills in the agent’s `skills` array, or load them from a GitHub repository mounted on the session.
41
1142## Why use Skills
1243
1344Skills are reusable, filesystem-based resources that give Claude domain-specific expertise: workflows, context, and best practices that turn a general-purpose agent into a specialist. Unlike prompts (conversation-level instructions for one-off tasks), Skills load on demand, so you don’t have to repeat the same guidance across conversations.
from line 300
269300
270301Agent Skills is not covered by ZDR arrangements. Skill definitions and execution data are retained according to Anthropic’s standard data retention policy.
271302
272For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
273
274303For audit logging of Skills API operations, see [Audit logging](https://platform.claude.com/docs/en/build-with-claude/skills-guide#audit-logging) in Using Agent Skills with the API.
275304
276305## Limitations and constraints
from line 365
336365 Learn how to write effective Skills that Claude can discover and use successfully.
337366 </Card>
338367</CardGroup>
368
369## Availability
370
371Agent Skills are available on every model.
372
373### API support
374
375#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
376
377* Availability: Available
378* Usage: List `skill_ids` in the `container` parameter and include the code execution tool, whose container the skills run in.
379
380| Status | Cloud platforms |
381| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
382| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed) |
383| Available<sup>1</sup> | [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
384
3851. Hosted on Anthropic deployments only; the skill version download endpoint (`GET /v1/skills/{skill_id}/versions/{version}/content`) is not supported on Foundry.
386
387#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
388
389* Availability: Available
390* Usage: Attach skills in the agent’s `skills` array, or load them from a GitHub repository mounted on the session.
391
392| Status | Cloud platforms |
393| --------- | ----------------------- |
394| Available | All supported platforms |
395
396### Data handling
397
398[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
399
400| Item | Zero data retention | HIPAA |
401| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
402| Status | Not eligible | Not eligible |
403| Details | Skill data retained according to standard policy. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#data-retention) | — |
404
405Applicable endpoints:
406
407* `/v1/skills`
408* `/v1/messages` with `skills`
339409
agents-and-tools/mcp-connector Changed · +76 / -4 lines
## 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) ### Required beta headers ### Data handling
from line 4
44description: Connect to remote MCP servers directly from the Messages API without an MCP client, and allowlist, denylist, or configure individual tools.
55featureMetadata:
66 status: beta
7 betaHeader: mcp-client-2025-11-20
8 zdr: not-eligible
7 betaHeader: mcp-client-2026-09-15, mcp-client-2025-11-20
8 zdr:
9 eligibility: not-eligible
10 note: Data retained according to standard policy.
11 supportedModels:
12 - claude-fable-5-1
13 - claude-mythos-5-1
14 - claude-fable-5
15 - claude-mythos-5
16 - claude-mythos-preview
17 - claude-opus-5-5
18 - claude-opus-5
19 - claude-sonnet-5-5
20 - claude-sonnet-5
21 - claude-haiku-5-5
22 - claude-haiku-4-5-20251001
23 - claude-opus-4-8
24 - claude-opus-4-7
25 - claude-opus-4-6
26 - claude-sonnet-4-6
27 - claude-opus-4-5-20251101
28 - claude-sonnet-4-5-20250929
929 supportedPlatforms:
1030 Claude API: beta
1131 Claude Platform on AWS: beta
32 Claude Models on Google Cloud (Anthropic managed): beta
1233 Microsoft Foundry: beta
1334---
1435
36**API support**: Usage differs by product.
37
38* **Messages API**: Pass `mcp_servers` and a matching `mcp_toolset` in `tools` on each request.
39* **Managed Agents**: Declare MCP servers on the agent. Each session supplies credentials by referencing a vault, so secrets stay out of the agent definition.
40
1541Claude’s Model Context Protocol (MCP) connector feature allows you to connect to remote MCP servers directly from the Messages API without a separate MCP client.
1642
1743<Note>
from line 2014
19882014
19892015The MCP connector is not covered by ZDR arrangements. Data exchanged with MCP servers, including tool definitions and execution results, is retained according to Anthropic’s standard data retention policy.
19902016
1991For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
1992
19932017## Migration guide
19942018
19952019If you’re using the deprecated `mcp-client-2025-04-04` beta header, follow this guide to migrate to the new version.
from line 2127
21032127| `tool_configuration` | object | **Deprecated:** Use MCPToolset in the `tools` array instead |
21042128| `tool_configuration.enabled` | boolean | **Deprecated:** Use `default_config.enabled` in MCPToolset |
21052129| `tool_configuration.allowed_tools` | array | **Deprecated:** Use allowlist pattern with `configs` in MCPToolset |
2130
2131## Availability
2132
2133MCP connector is in beta on every model.
2134
2135### API support
2136
2137#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2138
2139* Availability: Available
2140* Usage: Pass `mcp_servers` and a matching `mcp_toolset` in `tools` on each request. For OAuth servers you get and refresh the access token yourself and pass it as `authorization_token`.
2141
2142| Status | Cloud platforms |
2143| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2144| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2145
2146#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
2147
2148* Availability: Available
2149* Usage: Declare MCP servers on the agent. Each session supplies credentials by referencing a vault, so secrets stay out of the agent definition.
2150
2151| Status | Cloud platforms |
2152| ------ | ----------------------- |
2153| Beta | All supported platforms |
2154
2155### Required beta headers
2156
2157[Beta headers overview](https://platform.claude.com/docs/en/api/beta-headers)
2158
2159Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.
2160
2161| Header | APIs | Cloud platforms |
2162| -------------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2163| `mcp-client-2026-09-15` or `mcp-client-2025-11-20` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) | Claude API |
2164| `mcp-client-2025-11-20` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) | [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2165
2166### Data handling
2167
2168[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2169
2170| Item | Zero data retention | HIPAA |
2171| ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
2172| Status | Not eligible | Not eligible |
2173| Details | Data retained according to standard policy. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector#data-retention) | — |
2174
2175Applicable endpoints:
2176
2177* `/v1/messages` with `mcp_servers`
21062178
agents-and-tools/mcp-tunnels/overview Changed · +79 / -6 lines
## 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) ### Required beta headers ### Data handling
from line 2
22title: MCP tunnels
33url: https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/overview
44description: Securely connect Claude to MCP servers running in your private network without opening inbound ports or exposing services to the public internet.
5featureMetadata:
6 status: research-preview
7 betaHeader: mcp-client-2026-09-15, mcp-client-2025-11-20
8 zdr:
9 eligibility: not-eligible
10 note: Research preview. The MCP tunnels security page describes the data-flow boundary and subprocessor details.
11 supportedModels:
12 - claude-fable-5-1
13 - claude-mythos-5-1
14 - claude-fable-5
15 - claude-mythos-5
16 - claude-mythos-preview
17 - claude-opus-5-5
18 - claude-opus-5
19 - claude-sonnet-5-5
20 - claude-sonnet-5
21 - claude-haiku-5-5
22 - claude-haiku-4-5-20251001
23 - claude-opus-4-8
24 - claude-opus-4-7
25 - claude-opus-4-6
26 - claude-sonnet-4-6
27 - claude-opus-4-5-20251101
28 - claude-sonnet-4-5-20250929
29 supportedPlatforms:
30 Claude API: research-preview
531---
632
7MCP tunnels let you connect Claude to Model Context Protocol (MCP) servers that run inside your private network. Traffic flows over an outbound-only connection, so you don’t need to open inbound firewall ports, expose services to the public internet, or allowlist Anthropic’s IP ranges on your origin.
8
933<Note>
10 MCP tunnels are in research preview. [Request access](https://claude.com/form/mcp-tunnels) to try them. They are provided “as-is” without any uptime, support, or continuity commitment, and they depend on a third-party network provider (Cloudflare) that makes no availability commitment for the underlying transport. Anthropic may modify or discontinue MCP tunnels at any time.
34 MCP tunnels are in research preview.
35
36 MCP tunnels are in research preview. They are provided “as-is” without any uptime, support, or continuity commitment, and they depend on a third-party network provider (Cloudflare) that makes no availability commitment for the underlying transport. Anthropic may modify or discontinue MCP tunnels at any time.
37
38 * [Request access](https://claude.com/form/mcp-tunnels)
1139</Note>
1240
13For Zero Data Retention and HIPAA BAA eligibility, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility).
41MCP tunnels let you connect Claude to Model Context Protocol (MCP) servers that run inside your private network. Traffic flows over an outbound-only connection, so you don’t need to open inbound firewall ports, expose services to the public internet, or allowlist Anthropic’s IP ranges on your origin.
1442
1543## How it works
1644
from line 424
396424 Use tunneled servers from the Messages API.
397425 </Card>
398426</CardGroup>
427
428## Availability
429
430MCP tunnels are in research preview on every model.
431
432### API support
433
434#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
435
436* Availability: Available
437
438| Status | Cloud platforms |
439| ---------------- | --------------- |
440| Research preview | Claude API |
441
442#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
443
444* Availability: Available
445
446| Status | Cloud platforms |
447| ---------------- | --------------- |
448| Research preview | Claude API |
449
450### Required beta headers
451
452[Beta headers overview](https://platform.claude.com/docs/en/api/beta-headers)
453
454Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.
455
456| Header | APIs |
457| -------------------------------------------------- | ------------------------------------------------------------------------------------------- |
458| `mcp-client-2026-09-15` or `mcp-client-2025-11-20` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) |
459
460### Data handling
461
462[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
463
464| Item | Zero data retention | HIPAA |
465| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
466| Status | Not eligible | Not eligible |
467| Details | Research preview. The MCP tunnels security page describes the data-flow boundary and subprocessor details. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/security) | — |
468
469Applicable endpoints:
470
471* `/v1/tunnels`
399472
agents-and-tools/tool-use/advisor-tool Changed · +243 / -21 lines
## 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) ### Required beta headers ### Data handling
from line 2
22title: Advisor tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool
44description: Pair a faster executor model with a higher-intelligence advisor model that provides strategic guidance mid-generation.
5featureMetadata:
6 status: beta
7 betaHeader: advisor-tool-2026-03-01
8 zdr:
9 eligibility: eligible
10 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Advisor model output is returned in the API response; nothing is stored server-side after the response.
11 supportedModels:
12 - claude-fable-5-1
13 - claude-mythos-5-1
14 - claude-fable-5
15 - claude-mythos-5
16 - claude-mythos-preview
17 - claude-opus-5-5
18 - claude-opus-5
19 - claude-sonnet-5-5
20 - claude-sonnet-5
21 - claude-haiku-5-5
22 - claude-haiku-4-5-20251001
23 - claude-opus-4-8
24 - claude-opus-4-7
25 - claude-opus-4-6
26 - claude-sonnet-4-6
27 supportedPlatforms:
28 Claude API: beta
29 Claude Platform on AWS: beta
30 Claude Models on Google Cloud (Anthropic managed): beta
531---
632
33**API support**: Usage differs by product.
34
35* **Messages API**: Add an advisor tool (type `advisor_20260301`) to the request’s `tools`.
36* **Managed Agents**: Set `advisor` in the agent’s `multiagent` block; there are no `max_uses` or `max_tokens` options.
37
738The advisor tool lets a faster, lower-cost **executor model** consult a higher-intelligence **advisor model** mid-generation for strategic guidance. The advisor reads the full conversation and produces a plan or course correction, and the executor continues with the task.
839
940This pattern fits long-horizon agentic workloads (coding agents, computer use, multistep research pipelines) where most turns are mechanical but having an excellent plan is crucial. You get close to advisor-solo quality while the bulk of token generation occurs at executor-model rates. For measured results, including how the benefit shrinks as the executor’s own capability approaches the advisor’s, see [Optimizing for cost and intelligence](https://platform.claude.com/docs/en/about-claude/models/optimizing-for-cost-and-intelligence).
from line 56
2556 E-->>U: Response
2657```
2758
28<Note>
29 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).
30</Note>
31
3259## When to use it
3360
3461The advisor fits these configurations:
from line 369
342369| `advisor_redacted_result` | `encrypted_content`, `stop_reason` | The advisor model returns encrypted output. |
343370
344371<Note>
345 Claude Sonnet 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Fable 5, Claude Mythos 5, and Claude Haiku 5.5 advisors return the encrypted `advisor_redacted_result`. Every other advisor model in the [compatibility table](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#model-compatibility) returns the plaintext `advisor_result`. To read the advice text in your own responses, use an advisor that returns plaintext, such as `claude-opus-4-8`, where your executor’s row in the [compatibility table](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#model-compatibility) lists one. Claude Sonnet 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Fable 5, and Claude Mythos 5 executors pair only with advisors that return the encrypted form, so on those executors the advice text isn’t readable in the response.
372 Claude Sonnet 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Fable 5, Claude Mythos 5, and Claude Haiku 5.5 advisors return the encrypted `advisor_redacted_result`. Every other advisor model in [Model compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#model-compatibility) returns the plaintext `advisor_result`. To read the advice text in your own responses, use an advisor that returns plaintext, such as `claude-opus-4-8`, where [Model compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#model-compatibility) lists one for your executor. Claude Sonnet 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Fable 5, and Claude Mythos 5 executors pair only with advisors that return the encrypted form, so on those executors the advice text isn’t readable in the response.
346373</Note>
347374
348375Here is the same request sent twice, identical except for the advisor `model` in the tool definition, showing both variants.
from line 1833
18061833
18071834The executor model (the top-level `model` field) and the advisor model (the `model` field inside the tool definition) must form a valid pair. The advisor must be Claude Sonnet 4.6 or a more capable model, and it must be at least as capable as the executor. Models of equal capability (for example, Claude Opus 4.7 and Claude Opus 4.8) can advise each other.
18081835
1809| Executor models | Advisor models |
1810| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1811| Claude Haiku 4.5 (claude-haiku-4-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Opus 4.6 (claude-opus-4-6)<br />Claude Sonnet 5.5 (claude-sonnet-5-5)<br />Claude Sonnet 5 (claude-sonnet-5)<br />Claude Sonnet 4.6 (claude-sonnet-4-6)<br />Claude Haiku 5.5 (claude-haiku-5-5) |
1812| Claude Haiku 5.5 (claude-haiku-5-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Sonnet 5.5 (claude-sonnet-5-5)<br />Claude Sonnet 5 (claude-sonnet-5)<br />Claude Haiku 5.5 (claude-haiku-5-5) |
1813| Claude Sonnet 4.6 (claude-sonnet-4-6) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Opus 4.6 (claude-opus-4-6)<br />Claude Sonnet 5.5 (claude-sonnet-5-5)<br />Claude Sonnet 5 (claude-sonnet-5)<br />Claude Sonnet 4.6 (claude-sonnet-4-6)<br />Claude Haiku 5.5 (claude-haiku-5-5) |
1814| Claude Sonnet 5 (claude-sonnet-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Sonnet 5.5 (claude-sonnet-5-5)<br />Claude Sonnet 5 (claude-sonnet-5)<br />Claude Haiku 5.5 (claude-haiku-5-5) |
1815| Claude Sonnet 5.5 (claude-sonnet-5-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Sonnet 5.5 (claude-sonnet-5-5) |
1816| Claude Opus 4.6 (claude-opus-4-6) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Opus 4.6 (claude-opus-4-6)<br />Claude Sonnet 5.5 (claude-sonnet-5-5)<br />Claude Sonnet 5 (claude-sonnet-5)<br />Claude Haiku 5.5 (claude-haiku-5-5) |
1817| Claude Opus 4.7 (claude-opus-4-7) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Sonnet 5.5 (claude-sonnet-5-5) |
1818| Claude Opus 4.8 (claude-opus-4-8) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5)<br />Claude Opus 4.8 (claude-opus-4-8)<br />Claude Opus 4.7 (claude-opus-4-7)<br />Claude Sonnet 5.5 (claude-sonnet-5-5) |
1819| Claude Opus 5 (claude-opus-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5) |
1820| Claude Opus 5.5 (claude-opus-5-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5) |
1821| Claude Fable 5 (claude-fable-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5) |
1822| Claude Mythos 5 (claude-mythos-5) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1)<br />Claude Mythos 5 (claude-mythos-5)<br />Claude Fable 5 (claude-fable-5)<br />Claude Opus 5.5 (claude-opus-5-5)<br />Claude Opus 5 (claude-opus-5) |
1823| Claude Fable 5.1 (claude-fable-5-1) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1) |
1824| Claude Mythos 5.1 (claude-mythos-5-1) | Claude Mythos 5.1 (claude-mythos-5-1)<br />Claude Fable 5.1 (claude-fable-5-1) |
1836**[Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) & [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview)** — *For demanding reasoning and long-horizon agentic work*
18251837
1838**Supported advisor models**
1839
1840* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1841* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1842
1843**[Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview)** — *For long-running agentic coding and knowledge work*
1844
1845**Supported advisor models**
1846
1847* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1848* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1849* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1850* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1851* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1852* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1853
1854**[Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)** — *The best combination of speed and intelligence*
1855
1856**Supported advisor models**
1857
1858* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1859* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1860* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1861* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1862* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1863* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1864* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1865
1866**[Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview)** — *For high-volume, latency-sensitive tasks such as classification, extraction, and routing*
1867
1868**Supported advisor models**
1869
1870* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1871* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1872* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1873* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1874* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1875* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1876* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1877* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1878* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1879* [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview) (claude-sonnet-5)
1880* [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) (claude-haiku-5-5)
1881
1882**[Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) & [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview)**
1883
1884**Supported advisor models**
1885
1886* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1887* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1888* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1889* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1890* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1891* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1892
1893**[Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview)**
1894
1895**Supported advisor models**
1896
1897* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1898* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1899* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1900* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1901* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1902* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1903
1904**[Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview)**
1905
1906**Supported advisor models**
1907
1908* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1909* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1910* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1911* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1912* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1913* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1914* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1915* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1916* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1917
1918**[Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview)**
1919
1920**Supported advisor models**
1921
1922* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1923* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1924* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1925* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1926* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1927* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1928* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1929* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1930* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1931
1932**[Claude Opus 4.6](https://platform.claude.com/docs/en/models/opus-4-6/overview)**
1933
1934**Supported advisor models**
1935
1936* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1937* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1938* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1939* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1940* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1941* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1942* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1943* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1944* [Claude Opus 4.6](https://platform.claude.com/docs/en/models/opus-4-6/overview) (claude-opus-4-6)
1945* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1946* [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview) (claude-sonnet-5)
1947* [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) (claude-haiku-5-5)
1948
1949**[Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview)**
1950
1951**Supported advisor models**
1952
1953* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1954* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1955* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1956* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1957* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1958* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1959* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1960* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1961* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1962* [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview) (claude-sonnet-5)
1963* [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) (claude-haiku-5-5)
1964
1965**[Claude Sonnet 4.6](https://platform.claude.com/docs/en/models/sonnet-4-6/overview)**
1966
1967**Supported advisor models**
1968
1969* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1970* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1971* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1972* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1973* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1974* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1975* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1976* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1977* [Claude Opus 4.6](https://platform.claude.com/docs/en/models/opus-4-6/overview) (claude-opus-4-6)
1978* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1979* [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview) (claude-sonnet-5)
1980* [Claude Sonnet 4.6](https://platform.claude.com/docs/en/models/sonnet-4-6/overview) (claude-sonnet-4-6)
1981* [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) (claude-haiku-5-5)
1982
1983**[Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview)**
1984
1985**Supported advisor models**
1986
1987* [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview) (claude-mythos-5-1)
1988* [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview) (claude-fable-5-1)
1989* [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview) (claude-mythos-5)
1990* [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview) (claude-fable-5)
1991* [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview) (claude-opus-5-5)
1992* [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview) (claude-opus-5)
1993* [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) (claude-opus-4-8)
1994* [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview) (claude-opus-4-7)
1995* [Claude Opus 4.6](https://platform.claude.com/docs/en/models/opus-4-6/overview) (claude-opus-4-6)
1996* [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview) (claude-sonnet-5-5)
1997* [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview) (claude-sonnet-5)
1998* [Claude Sonnet 4.6](https://platform.claude.com/docs/en/models/sonnet-4-6/overview) (claude-sonnet-4-6)
1999* [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) (claude-haiku-5-5)
2000
18262001If you request an invalid pair, the API returns a `400 invalid_request_error` naming the unsupported combination.
18272002
18282003### Platform availability
from line 2027
18522027 Control how many tokens Claude uses when responding with the `effort` parameter, trading off between response thoroughness and token efficiency.
18532028 </Card>
18542029</CardGroup>
2030
2031## Availability
2032
2033Advisor tool is in beta on select models and eligible for zero data retention.
2034
2035### API support
2036
2037#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2038
2039* Availability: Available
2040* Usage: Add an advisor tool (type `advisor_20260301`) with the advisor model to the request’s `tools`. It takes `max_uses`, `max_tokens` and caching options.
2041
2042| Status | Cloud platforms | Models |
2043| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2044| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview), [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) |
2045
2046#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
2047
2048* Availability: Available
2049* Usage: Set `advisor` to `{"type": "enabled", "model": …}` in the agent’s `multiagent` block. There are no `max_uses`, `max_tokens` or caching options, and advice arrives as thread events on the session’s event stream.
2050
2051| Status | Cloud platforms | Models |
2052| ------ | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2053| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview), [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) |
2054
2055### Required beta headers
2056
2057[Beta headers overview](https://platform.claude.com/docs/en/api/beta-headers)
2058
2059Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.
2060
2061| Header | APIs |
2062| ------------------------- | ------------------------------------------------------------------------------------------- |
2063| `advisor-tool-2026-03-01` | [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) |
2064
2065### Data handling
2066
2067[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2068
2069| Item | Zero data retention | HIPAA |
2070| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
2071| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Not eligible |
2072| Details | Advisor model output is returned in the API response; nothing is stored server-side after the response. | — |
2073
2074Applicable endpoints:
2075
2076* `/v1/messages` with `advisor` tool
18552077
agents-and-tools/tool-use/bash-tool Changed · +57 / -4 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 2
22title: Bash tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/bash-tool
44description: Let Claude request shell commands that your application runs in a persistent bash session and returns as tool results.
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). Client-side tool run in your environment.
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
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
1137The bash tool is a [client tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/how-tool-use-works): Claude doesn’t run commands itself. When you include the tool in a request, Claude replies with a `tool_use` block that names the command to run. Your application runs that command in a bash session it owns and returns the output in a `tool_result` block.
1238
1339Your application keeps one bash process alive across tool calls, so state persists between commands. The working directory, environment variables, and any files a command creates are still there for the next command.
from line 2000
19742000 Connect Claude to external tools and APIs. See where tools run, when Claude calls them, and which tool fits your task.
19752001 </Card>
19762002</CardGroup>
2003
2004## Availability
2005
2006Bash tool is available on every model and eligible for zero data retention and HIPAA readiness.
2007
2008### API support
2009
2010#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2011
2012* Availability: Available
2013
2014| Status | Cloud platforms |
2015| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2016| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2017
2018### Data handling
2019
2020[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2021
2022| Item | Zero data retention | HIPAA |
2023| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
2024| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
2025| Details | Client-side tool run in your environment. | — |
2026
2027Applicable endpoints:
2028
2029* `/v1/messages` with `bash` tool
19772030
agents-and-tools/tool-use/browser-use-sdk Changed · +35 / -0 lines
## 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)
from line 2
22title: Browser and computer use with the SDK toolsets
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-sdk
44description: Run the browser use tool or the computer use tool from the Python or TypeScript SDK. The SDK runs the loop and the checks you configure, and you supply the browser or the desktop.
5featureMetadata:
6 status: beta
7 supportedModels:
8 - claude-fable-5-1
9 - claude-mythos-5-1
10 - claude-fable-5
11 - claude-mythos-5
12 - claude-mythos-preview
13 - claude-opus-5-5
14 - claude-opus-5
15 - claude-sonnet-5-5
16 - claude-sonnet-5
17 - claude-haiku-5-5
18 - claude-opus-4-8
19 supportedPlatforms:
20 Claude API: beta
21 Claude Models on Google Cloud (Google managed): beta
522---
623
724With the browser and computer toolsets in the Python and TypeScript SDKs, you can build an agent that works in a web browser or on a desktop. It can use applications with no programmatic interface. Through the [browser use tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool), Claude navigates, reads, and interacts with webpages. Through the [computer use tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool), Claude receives screenshots of a desktop and uses the mouse and keyboard.
from line 1375
13581375 Guardrails for any application that reads untrusted content.
13591376 </Card>
13601377</CardGroup>
1378
1379## Availability
1380
1381Browser and computer use SDK toolsets are in beta on select models.
1382
1383### API support
1384
1385#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1386
1387* Availability: Available
1388
1389| Status | Cloud platforms | Models |
1390| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1391| Beta | Claude API, [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) |
1392
1393#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1394
1395* Availability: Not available
13611396
agents-and-tools/tool-use/browser-use-tool Changed · +35 / -3 lines
## 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
from line 6
66 status: ga
77 zdr:
88 eligibility: eligible
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements).
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Client-side tool. Anthropic does not run browser actions or retain page content beyond standard API handling.
1010 supportedModels:
1111 - claude-fable-5-1
1212 - claude-mythos-5-1
1313 - claude-fable-5
1414 - claude-mythos-5
15 - claude-mythos-preview
1516 - claude-opus-5-5
1617 - claude-opus-5
1718 - claude-sonnet-5-5
1819 - claude-sonnet-5
19 - claude-opus-4-8
2020 - claude-haiku-5-5
21 - claude-opus-4-8
2122 supportedPlatforms:
2223 Claude API: ga
2324 Claude Models on Google Cloud (Google managed): ga
from line 1558
15571558| A `browser_state` block that breaks a rule in [Track tabs with `browser_state`](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#track-tabs-and-page-state), for example, one on an `is_error: true` result or on a result that doesn’t answer a browser member call, more than one in a result, a non-empty `tabs` without exactly one `active: true` entry, a duplicate `tab_id`, an empty `state_changes` array, a `tab_opened` whose `tab_id` isn’t in `tabs`, two state changes for one `download_id` or a state-change field its `type` doesn’t declare ([Report downloads](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#report-downloads)), or a field over its limits | Fix the block. “Nothing to report” is expressed by omitting the block or the `state_changes` field, never by an empty value. |
15581559| A successful `new_tab`, `switch_tab`, `close_tab`, or `list_tabs` result whose `content` isn’t exactly one `browser_state` block, or a `new_tab` result without exactly one `tab_opened` matching the active tab | The API renders these results from the block and needs it in that exact shape; see [Tab management results](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#tab-management-results). |
15591560| An `image` in a result over your model’s [image size limits](https://platform.claude.com/docs/en/build-with-claude/vision#evaluate-image-size), or over the stricter per-image limit that applies once the request holds [more than 20 images](https://platform.claude.com/docs/en/build-with-claude/vision#request-limits), counting screenshots and `zoom` images in earlier results | The API doesn’t downscale toolset images. Resize screenshots before returning them ([Size screenshots to fit image limits](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#handle-coordinate-scaling-for-higher-resolutions)). |
1560| A `model` that doesn’t support `browser_toolset_20260801` | See [Compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#compatibility) for the supported models. |
1561| A `model` that doesn’t support `browser_toolset_20260801` | See [API support](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#availability-feature-support) for the supported models. |
15611562
15621563## Limitations
15631564
from line 1604
16031604 Browse client toolsets and every other Anthropic-provided tool, with their versions and parameters.
16041605 </Card>
16051606</CardGroup>
1607
1608## Availability
1609
1610Browser use tool is available on select models and eligible for zero data retention.
1611
1612### API support
1613
1614#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1615
1616* Availability: Available
1617
1618| Status | Cloud platforms | Models |
1619| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1620| Available | Claude API, [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) |
1621
1622#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1623
1624* Availability: Not available
1625
1626### Data handling
1627
1628[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1629
1630| Item | Zero data retention | HIPAA |
1631| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
1632| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Not eligible |
1633| Details | Client-side tool. Anthropic does not run browser actions or retain page content beyond standard API handling. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool#data-retention) | Not covered under HIPAA readiness; requests that include the browser use tool are not blocked. |
1634
1635Applicable endpoints:
1636
1637* `/v1/messages` with `browser` toolset
16061638
agents-and-tools/tool-use/code-execution-tool Changed · +43 / -15 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 4
44description: Run Python and Bash code in a sandboxed container to analyze data, generate files, and iterate on solutions.
55featureMetadata:
66 status: ga
7 zdr: not-eligible
7 zdr:
8 eligibility: not-eligible
9 note: Container data retained up to 30 days.
810 supportedModels:
911 - claude-fable-5-1
1012 - claude-mythos-5-1
1113 - claude-fable-5
1214 - claude-mythos-5
15 - claude-mythos-preview
1316 - claude-opus-5-5
1417 - claude-opus-5
18 - claude-sonnet-5-5
19 - claude-sonnet-5
20 - claude-haiku-5-5
21 - claude-haiku-4-5-20251001
1522 - claude-opus-4-8
1623 - claude-opus-4-7
1724 - claude-opus-4-6
18 - claude-opus-4-5-20251101
19 - claude-sonnet-5-5
20 - claude-sonnet-5
2125 - claude-sonnet-4-6
26 - claude-opus-4-5-20251101
2227 - claude-sonnet-4-5-20250929
23 - claude-haiku-5-5
24 - claude-haiku-4-5-20251001
2528 supportedPlatforms:
2629 Claude API: ga
2730 Claude Platform on AWS: ga
28 Microsoft Foundry:
29 availability: ga
30 note: On [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry), code execution requires a [Hosted on Anthropic deployment](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure).
31 Claude Models on Google Cloud (Anthropic managed): ga
32 Microsoft Foundry (hosted on Anthropic): ga
3133 details:
3234 - Every supported model accepts all three [tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions). On Claude Haiku 4.5, programmatic tool calling and REPL state persistence aren't available, so the newer versions behave like `code_execution_20250825` there.
33 - For [Claude Mythos Preview](https://anthropic.com/glasswing), code execution is supported on the Claude API and Microsoft Foundry.
3435---
3536
3637Claude can analyze data, create visualizations, perform complex calculations, run system commands, create and edit files, and process uploaded files directly within the API conversation. The code execution tool allows Claude to run Bash commands and manipulate files, including writing code, in a secure, sandboxed environment.
from line 46
4546
4647## Tool versions
4748
48The code execution tool has three current versions, and every [supported model](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#compatibility) accepts all three. Each version builds on the previous one:
49The code execution tool has three current versions, and every [supported model](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#availability-feature-support) accepts all three. Each version builds on the previous one:
4950
5051* `code_execution_20250825` supports Bash commands and file operations.
5152* `code_execution_20260120` adds REPL state persistence and [programmatic tool calling](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) from within the sandbox. Claude Haiku 4.5 accepts the `code_execution_20260120` and `code_execution_20260521` tool types, but programmatic tool calling and the REPL state persistence that depends on it aren’t available on it, so the newer versions behave like `code_execution_20250825` there.
5253* `code_execution_20260521` is the same runtime as `code_execution_20260120`. The difference is that the tool description tells Claude about the 90-second wall-clock limit on each Python cell in programmatic tool calling, so Claude can budget long-running cells. A cell that exceeds the limit returns a normal code execution result with a non-zero `return_code` and a `detection_timeout` status message in its output. This is separate from the `execution_time_exceeded` [error code](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#errors), which the API returns when a whole tool call exceeds the maximum execution time.
5354
55For [Claude Mythos Preview](https://anthropic.com/glasswing), code execution is supported on the Claude API and Microsoft Foundry.
56
5457None of the three tool versions requires an `anthropic-beta` header. The legacy code execution beta headers remain valid opt-ins.
5558
5659The examples on this page use `code_execution_20250825`, which covers the Bash and file operations they demonstrate and behaves the same way on every supported model; use `code_execution_20260120` or later when you need programmatic tool calling or REPL state persistence. The current [web search](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) and [web fetch](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool) tools (`web_search_20260209`, `web_fetch_20260209`, and later) require `code_execution_20260120` or later as their code execution version.
5760
58Older tool versions aren’t guaranteed to stay compatible with newer models. When you adopt a new model, check [Tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) and [Compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#compatibility), and prefer the newest tool version your integration supports.
61Older tool versions aren’t guaranteed to stay compatible with newer models. When you adopt a new model, check [Tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) and [API support](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#availability-feature-support), and prefer the newest tool version your integration supports.
5962
6063To check whether a model accepts the code execution tool before you send a request, read its `capabilities.server_tools.code_execution.supported` value from the Models API. Don’t use the top-level `capabilities.code_execution` value for this. It reports whether code running in this tool can call your request’s other tools, as in programmatic tool calling. [Using the Models API](https://platform.claude.com/docs/en/models/overview#using-the-models-api) describes both fields.
6164
from line 1492
14891492
14901493## Upgrade to latest tool version
14911494
1492The latest tool version is `code_execution_20260521`. To move between the three current versions, update the `type` string in your request: all three return the response blocks documented in [Response format](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#response-format). See [Tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) for what each version adds and [Compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#compatibility) for the models that support them.
1495The latest tool version is `code_execution_20260521`. To move between the three current versions, update the `type` string in your request: all three return the response blocks documented in [Response format](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#response-format). See [Tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) for what each version adds and [API support](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#availability-feature-support) for the models that support them.
14931496
14941497The rest of this section covers migrating from the legacy Python-only `code_execution_20250522` to the current tool versions.
14951498
from line 1528
15251528
15261529Code execution runs in server-side sandbox containers. Container data, including execution artifacts, uploaded files, and outputs, is retained for up to 30 days. This retention applies to all data processed within the container environment. Files that code execution creates in the [Files API](https://platform.claude.com/docs/en/build-with-claude/files) (retrievable with `client.files.download()` (csharp, go: `client.Files.Download()`; java: `client.files().download()`; php: `$client->files->download()`)) persist until explicitly deleted.
15271530
1528For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
1529
15301531## Next steps
15311532
15321533<CardGroup cols={2}>
from line 1547
15461547 Learn how to use Agent Skills to extend Claude’s capabilities through the API.
15471548 </Card>
15481549</CardGroup>
1550
1551## Availability
1552
1553Code execution tool is available on every model.
1554
1555### API support
1556
1557#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1558
1559* Availability: Available
1560
1561| Status | Cloud platforms |
1562| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1563| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
1564
1565### Data handling
1566
1567[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1568
1569| Item | Zero data retention | HIPAA |
1570| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
1571| Status | Not eligible | Not eligible |
1572| Details | Container data retained up to 30 days. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#data-retention) | — |
1573
1574Applicable endpoints:
1575
1576* `/v1/messages` with `code_execution` tool
15491577
agents-and-tools/tool-use/computer-use-tool Changed · +61 / -7 lines
## 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) ### Required beta headers ### Data handling
from line 3
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool
44description: Give Claude screenshot, mouse, and keyboard control of a desktop environment with the computer use tool, the computer_toolset_20260801 client toolset.
55featureMetadata:
6 status: ga
6 betaHeader: computer-use-2025-11-24, computer-use-2025-01-24
77 zdr:
88 eligibility: eligible
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements).
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Client-side tool where screenshots and files are captured and stored in your environment, not by Anthropic.
1010 supportedModels:
1111 - claude-fable-5-1
1212 - claude-mythos-5-1
1313 - claude-fable-5
1414 - claude-mythos-5
15 - claude-mythos-preview
1516 - claude-opus-5-5
1617 - claude-opus-5
1718 - claude-sonnet-5-5
1819 - claude-sonnet-5
19 - claude-opus-4-8
2020 - 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
2128 supportedPlatforms:
2229 Claude API: ga
2330 Claude Platform on AWS: beta
2431 Amazon Bedrock: beta
32 Amazon Bedrock (InvokeModel): beta
2533 Claude Models on Google Cloud (Google managed): ga
2634 Microsoft Foundry: beta
2735 details:
from line 36
2836 - On the Claude API and Claude Models on Google Cloud (Google managed), Claude 5.5 and later models support computer use only through the `computer_toolset_20260801` toolset and return an error for the earlier `computer_20251124` and `computer_20250124` tool versions. To move an existing integration, see [Migrate from `computer_20251124`](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). To move from `computer_20250124`, see [Move computer use to the toolset](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide#computer-use-toolset) in the Claude Haiku 5.5 migration guide.
2937 - On Amazon Bedrock, Claude Opus 5.5, Claude Sonnet 5.5, and Claude Haiku 5.5 accept the earlier `computer_20251124` tool version as Claude Opus 5 and Claude Sonnet 5 do.
3038 - Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 4.6, and Claude Opus 4.5 support computer use only through the earlier `computer_20251124` tool version, which requires a beta header; see [Earlier tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions).
31 - On Claude Platform on AWS, Amazon Bedrock, and Microsoft Foundry, computer use is available only through the [earlier beta tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions).
3239---
3340
3441<Note>
from line 49
4249For tasks that stay inside webpages, the [browser use tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/browser-use-tool) is the closer fit: its member tools read and act on the page itself, and it doesn’t need a full desktop environment.
4350
4451<Note>
45 Computer use is available on the Claude API and [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed) as the `computer_toolset_20260801` toolset; see [Compatibility](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#compatibility) for the supported models.
52 Computer use is available on the Claude API and [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed) as the `computer_toolset_20260801` toolset; see [API support](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#availability-feature-support) for the supported models.
4653
4754 Existing `computer_20251124` integrations keep working on the models listed for it under [Earlier tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions), and earlier tool versions remain available in beta for models and platforms that don’t support the toolset. See [Migrate from `computer_20251124`](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124) to upgrade, or [Earlier tool versions](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions) for the beta headers.
4855</Note>
from line 2178
21712178
21722179## Earlier tool versions
21732180
2174Two earlier versions of the computer use tool remain available in beta for existing integrations, for models that don’t support the toolset, and on platforms where the toolset isn’t currently available. Each requires its [beta header](https://platform.claude.com/docs/en/api/beta-headers) on every request, and their parameters are documented in the [beta Messages API reference](https://platform.claude.com/docs/en/api/beta/messages/create). With the SDK, pass the header through `betas` (csharp, go: `Betas`; java: `.addBeta()`) and use the beta namespace; only the computer use tool needs the header, not the bash or text editor tools in the same request.
2181Two earlier versions of the computer use tool remain available in beta for existing integrations, for models that don’t support the toolset, and on platforms where the toolset isn’t currently available. On Claude Platform on AWS, Amazon Bedrock, and Microsoft Foundry, computer use is available only through these earlier versions. Each requires its [beta header](https://platform.claude.com/docs/en/api/beta-headers) on every request, and their parameters are documented in the [beta Messages API reference](https://platform.claude.com/docs/en/api/beta/messages/create). With the SDK, pass the header through `betas` (csharp, go: `Betas`; java: `.addBeta()`) and use the beta namespace; only the computer use tool needs the header, not the bash or text editor tools in the same request.
21752182
21762183| Tool version | Beta header | Use with | Parameters |
21772184| ------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
from line 2204
21972204
21982205Computer use is a client-side tool. All screenshots, mouse actions, keyboard inputs, and any files involved in a session are captured and stored in your environment, not by Anthropic. Anthropic processes the screenshot images and action requests in real time as part of the API call. Retention for those API requests is governed by [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
21992206
2200Because your application controls where and how computer use data is stored, computer use is ZDR eligible. For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
2207Because your application controls where and how computer use data is stored, computer use is ZDR eligible.
22012208
22022209## Pricing
22032210
from line 2253
22462253 Let Claude navigate, read, and interact with webpages in your own browser environment, for tasks that stay inside the browser.
22472254 </Card>
22482255</CardGroup>
2256
2257## Availability
2258
2259Computer use tool is available or in beta on select models and eligible for zero data retention and HIPAA readiness.
2260
2261### API support
2262
2263#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2264
2265* Availability: Available
2266
2267| Status | Cloud platforms | Models |
2268| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2269| Available | Claude API, [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) |
2270| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview), [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview), [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), [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) |
2271| Beta | [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) |
2272| Beta | [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) |
2273
2274#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
2275
2276* Availability: Not available
2277
2278### Required beta headers
2279
2280[Beta headers overview](https://platform.claude.com/docs/en/api/beta-headers)
2281
2282Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.
2283
2284| Header | Cloud platforms | Models |
2285| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2286| `computer-use-2025-11-24` | [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview) |
2287| `computer-use-2025-11-24` | [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview) |
2288| `computer-use-2025-11-24` | All supported platforms | [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview), [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), [Claude Opus 4.5](https://platform.claude.com/docs/en/models/opus-4-5/overview) |
2289| `computer-use-2025-01-24` | All supported platforms | [Claude Haiku 4.5](https://platform.claude.com/docs/en/models/haiku-4-5/overview), [Claude Sonnet 4.5](https://platform.claude.com/docs/en/models/sonnet-4-5/overview) |
2290
2291### Data handling
2292
2293[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2294
2295| Item | Zero data retention | HIPAA |
2296| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
2297| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
2298| Details | Client-side tool where screenshots and files are captured and stored in your environment, not by Anthropic. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#data-retention) | — |
2299
2300Applicable endpoints:
2301
2302* `/v1/messages` with `computer` toolset or tool
22492303
agents-and-tools/tool-use/define-tools Changed · +57 / -0 lines
## 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)
from line 2
22title: Define tools
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools
44description: Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
5featureMetadata:
6 status: ga
7 supportedModels:
8 - claude-fable-5-1
9 - claude-mythos-5-1
10 - claude-fable-5
11 - claude-mythos-5
12 - claude-mythos-preview
13 - claude-opus-5-5
14 - claude-opus-5
15 - claude-sonnet-5-5
16 - claude-sonnet-5
17 - claude-haiku-5-5
18 - claude-haiku-4-5-20251001
19 - claude-opus-4-8
20 - claude-opus-4-7
21 - claude-opus-4-6
22 - claude-sonnet-4-6
23 - claude-opus-4-5-20251101
24 - claude-sonnet-4-5-20250929
25 supportedPlatforms:
26 Claude API: ga
27 Claude Platform on AWS: ga
28 Claude Models on Google Cloud (Anthropic managed): ga
29 Amazon Bedrock: ga
30 Amazon Bedrock (InvokeModel): ga
31 Claude Models on Google Cloud (Google managed): ga
32 Microsoft Foundry: ga
533---
634
35**API support**: Usage differs by product.
36
37* **Messages API**: Define them in the request’s `tools`, and send the results as `tool_result` blocks.
38* **Managed Agents**: Declare them on the agent with `type` `"custom"`; calls arrive as `agent.custom_tool_use` events.
39
740## Prerequisites
841
942* Familiarity with the [tool use overview](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview)
from line 939
906939 Directory of Anthropic-provided tools and optional properties.
907940 </Card>
908941</CardGroup>
942
943## Availability
944
945Custom tools are available on every model.
946
947### API support
948
949#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
950
951* Availability: Available
952* Usage: Define them in the request’s `tools`. Claude’s response contains `tool_use` blocks, and you send the results as `tool_result` blocks in the next request.
953
954| Status | Cloud platforms |
955| --------- | ----------------------- |
956| Available | All supported platforms |
957
958#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
959
960* Availability: Available
961* Usage: Declare them on the agent with `type` `"custom"`. Calls arrive as `agent.custom_tool_use` events, and you reply with `user.custom_tool_result` events.
962
963| Status | Cloud platforms |
964| --------- | ------------------------------------------------------------------------------------------------------------------ |
965| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
909966
agents-and-tools/tool-use/fine-grained-tool-streaming Changed · +56 / -4 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 2
22title: Fine-grained tool streaming
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/fine-grained-tool-streaming
44description: Stream tool inputs without server-side JSON buffering for latency-sensitive applications.
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
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
1137Fine-grained tool streaming delivers a tool’s input to your client as Claude generates it, without server-side buffering or JSON validation. Skipping the buffering step reduces the time to the first fragment of a large parameter, such as a document or a block of code, and the fragments arrive through the same [Streaming messages](https://platform.claude.com/docs/en/build-with-claude/streaming) events as standard tool use.
1238
1339<Warning>
from line 964
938964 Directory of Anthropic-provided tools and reference for optional tool definition properties.
939965 </Card>
940966</CardGroup>
967
968## Availability
969
970Fine-grained tool streaming is available on every model and eligible for zero data retention and HIPAA readiness.
971
972### API support
973
974#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
975
976* Availability: Available
977
978| Status | Cloud platforms |
979| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
980| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
981
982### Data handling
983
984[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
985
986| Item | Zero data retention | HIPAA |
987| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
988| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
989
990Applicable endpoints:
991
992* `/v1/messages`
941993
agents-and-tools/tool-use/memory-tool Changed · +58 / -4 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 2
22title: Memory tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/memory-tool
44description: Let Claude store and retrieve information across conversations by implementing the memory tool's file operations in your application.
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). Client-side memory storage where you control data retention.
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
738The memory tool lets Claude store and retrieve information across conversations in a directory of memory files. Claude can create, read, update, and delete files that persist between sessions, building up knowledge over time without keeping everything in the context window.
from line 45
1445 Use the [feedback form](https://forms.gle/YXC2EKGMhjN1c4L88) to share your feedback on this feature.
1546</Note>
1647
17<Note>
18 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).
19</Note>
20
2148## Use cases
2249
2350* Maintain project context across multiple agent sessions
from line 1046
10191046 Directory of Anthropic-provided tools and reference for optional tool definition properties.
10201047 </Card>
10211048</CardGroup>
1049
1050## Availability
1051
1052Memory tool is available on every model and eligible for zero data retention and HIPAA readiness.
1053
1054### API support
1055
1056#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1057
1058* Availability: Available
1059
1060| Status | Models |
1061| --------- | ----------------------------------------------------------------- |
1062| Available | [All models](https://platform.claude.com/docs/en/models/overview) |
1063
1064### Data handling
1065
1066[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1067
1068| Item | Zero data retention | HIPAA |
1069| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
1070| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
1071| Details | Client-side memory storage where you control data retention. | — |
1072
1073Applicable endpoints:
1074
1075* `/v1/messages` with `memory` tool
10221076
agents-and-tools/tool-use/parallel-tool-use Changed · +49 / -0 lines
## 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)
from line 2
22title: Parallel tool use
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/parallel-tool-use
44description: Enable, format, and disable parallel tool calls, with message-history guidance and troubleshooting.
5featureMetadata:
6 supportedModels:
7 - claude-fable-5-1
8 - claude-mythos-5-1
9 - claude-fable-5
10 - claude-mythos-5
11 - claude-mythos-preview
12 - claude-opus-5-5
13 - claude-opus-5
14 - claude-sonnet-5-5
15 - claude-sonnet-5
16 - claude-haiku-5-5
17 - claude-haiku-4-5-20251001
18 - claude-opus-4-8
19 - claude-opus-4-7
20 - claude-opus-4-6
21 - claude-sonnet-4-6
22 - claude-opus-4-5-20251101
23 - claude-sonnet-4-5-20250929
24 supportedPlatforms:
25 Claude API: ga
26 Claude Platform on AWS: ga
27 Amazon Bedrock: ga
28 Amazon Bedrock (InvokeModel): ga
29 Claude Models on Google Cloud (Google managed): ga
30 Microsoft Foundry: ga
531---
632
733By default, Claude may call multiple tools in a single response. This page covers how to run those calls, how to format the message history so parallelism keeps working, and how to disable parallel tool use when you need to. For the single-call flow, see [Handle tool calls](https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls).
from line 1617
15911617 Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
15921618 </Card>
15931619</CardGroup>
1620
1621## Availability
1622
1623Parallel tool use is available or in beta, depending on the API.
1624
1625### API support
1626
1627#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1628
1629* Availability: On by default
1630* Usage: To turn it off, set `disable_parallel_tool_use: true` inside `tool_choice`.
1631
1632| Status | Cloud platforms |
1633| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1634| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
1635
1636#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1637
1638* Availability: Always on
1639
1640| Status | Cloud platforms |
1641| ------ | ------------------------------------------------------------------------------------------------------------------ |
1642| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
15941643
agents-and-tools/tool-use/programmatic-tool-calling Changed · +41 / -12 lines
## 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
from line 4
44description: Let Claude call your tools from code in the code execution container, cutting model round trips and token use in multi-tool workflows.
55featureMetadata:
66 status: ga
7 zdr: not-eligible
7 zdr:
8 eligibility: not-eligible
9 note: Built on code execution containers; data retained up to 30 days.
810 supportedModels:
911 - claude-fable-5-1
1012 - claude-mythos-5-1
1113 - claude-fable-5
1214 - claude-mythos-5
15 - claude-mythos-preview
1316 - claude-opus-5-5
1417 - claude-opus-5
18 - claude-sonnet-5-5
19 - claude-sonnet-5
20 - claude-haiku-5-5
1521 - claude-opus-4-8
1622 - claude-opus-4-7
1723 - claude-opus-4-6
18 - claude-opus-4-5-20251101
19 - claude-sonnet-5-5
20 - claude-sonnet-5
2124 - claude-sonnet-4-6
25 - claude-opus-4-5-20251101
2226 - claude-sonnet-4-5-20250929
23 - claude-haiku-5-5
2427 supportedPlatforms:
2528 Claude API: ga
2629 Claude Platform on AWS: ga
27 Microsoft Foundry:
28 availability: ga
29 note: On [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry), programmatic tool calling requires a [Hosted on Anthropic deployment](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure).
30 Microsoft Foundry (hosted on Anthropic): ga
3031 details:
3132 - Programmatic tool calling requires the code execution tool with the `code_execution_20260120` or later [tool version](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions).
32 - Claude Haiku 4.5 accepts the `code_execution_20260120` and later tool versions but doesn't support programmatic tool calling.
3333---
3434
3535Programmatic tool calling allows Claude to write code that calls your tools programmatically within a [code execution](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool) container, rather than requiring round trips through the model for each tool call. This reduces latency for multi-tool workflows and decreases token consumption by allowing Claude to filter or process data before it reaches the model’s context window. On agentic search benchmarks such as [BrowseComp](https://arxiv.org/abs/2504.12516) and [DeepSearchQA](https://github.com/google-deepmind/deepsearchqa), which test multistep web research and complex information retrieval, adding programmatic tool calling on top of basic search tools improved performance by an average of 11 percent while using 24 percent fewer input tokens (see [Improved web search with dynamic filtering](https://claude.com/blog/improved-web-search-with-dynamic-filtering)).
from line 40
4040 For a deeper look at the inference and context costs that programmatic tool calling addresses, see [Advanced tool use](https://www.anthropic.com/engineering/advanced-tool-use).
4141</Tip>
4242
43Programmatic tool calling requires the [code execution tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool) with tool version `code_execution_20260120` or later. To check whether a model supports programmatic tool calling before you send a request, read its `capabilities.code_execution.supported` value from the Models API. [Using the Models API](https://platform.claude.com/docs/en/models/overview#using-the-models-api) describes the field.
43Programmatic tool calling requires the [code execution tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool) with tool version `code_execution_20260120` or later. Claude Haiku 4.5 accepts the `code_execution_20260120` and later tool versions but doesn’t support programmatic tool calling. To check whether a model supports programmatic tool calling before you send a request, read its `capabilities.code_execution.supported` value from the Models API. [Using the Models API](https://platform.claude.com/docs/en/models/overview#using-the-models-api) describes the field.
4444
4545## Quick start
4646
from line 1551
15511551
15521552Programmatic tool calling is built on the code execution infrastructure and uses the same sandbox containers. Container data, including execution artifacts and outputs, is retained for up to 30 days.
15531553
1554For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
1555
15561554## Next steps
15571555
15581556<CardGroup cols={2}>
from line 1570
15721570 Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
15731571 </Card>
15741572</CardGroup>
1573
1574## Availability
1575
1576Programmatic tool calling is available on select models.
1577
1578### API support
1579
1580#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1581
1582* Availability: Available
1583
1584| Status | Cloud platforms | Models |
1585| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1586| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [Claude Fable 5.1](https://platform.claude.com/docs/en/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/en/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/en/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/en/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/en/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/en/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/en/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/en/models/opus-4-7/overview), [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), [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) |
1587
1588#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1589
1590* Availability: Not available
1591
1592### Data handling
1593
1594[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1595
1596| Item | Zero data retention | HIPAA |
1597| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
1598| Status | Not eligible | Not eligible |
1599| Details | Built on code execution containers; data retained up to 30 days. [Learn more](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling#data-retention) | — |
1600
1601Applicable endpoints:
1602
1603* `/v1/messages` with `code_execution` tool
15751604
agents-and-tools/tool-use/strict-tool-use Changed · +57 / -2 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 2
22title: Strict tool use
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/strict-tool-use
44description: Enforce JSON Schema compliance on Claude's tool inputs with grammar-constrained sampling.
5featureMetadata:
6 status: ga
7 zdr:
8 eligibility: qualified
9 note: "Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Your prompts and Claude's outputs are not stored. Only the JSON schema is cached, for up to 24 hours since last use. This also covers strict tool use (`strict: true` on tools), which uses the same grammar pipeline."
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
737Setting `strict: true` on a tool definition guarantees Claude’s tool inputs match your JSON Schema by constraining the model’s token sampling to schema-valid outputs (a technique called grammar-constrained sampling). This page covers why strict mode matters for agents, how to enable it, and common use cases. For the supported JSON Schema subset, see [JSON Schema limitations](https://platform.claude.com/docs/en/build-with-claude/structured-outputs#json-schema-limitations). For non-strict schema guidance, see [Define tools](https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools).
from line 1151
11211151
11221152Strict tool use is HIPAA eligible, but **protected health information (PHI) must not be included in tool schema definitions**. The API caches compiled schemas separately from message content, and these cached schemas do not receive the same PHI protections as prompts and responses. Do not include PHI in `input_schema` property names, `enum` values, `const` values, or `pattern` regular expressions. PHI should only appear in message content (prompts and responses), where it is protected under HIPAA safeguards.
11231153
1124For ZDR and HIPAA eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
1125
11261154## Next steps
11271155
11281156<CardGroup cols={2}>
from line 1170
11421170 Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
11431171 </Card>
11441172</CardGroup>
1173
1174## Availability
1175
1176Strict tool use is available on every model and eligible for HIPAA readiness.
1177
1178### API support
1179
1180#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1181
1182* Availability: Available
1183
1184| Status | Cloud platforms | Models |
1185| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
1186| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [All models](https://platform.claude.com/docs/en/models/overview) |
1187
1188### Data handling
1189
1190[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1191
1192| Item | Zero data retention | HIPAA |
1193| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1194| Status | Eligible (qualified; excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
1195| Details | Your prompts and Claude’s outputs are not stored. Only the JSON schema is cached, for up to 24 hours since last use. This also covers strict tool use (`strict: true` on tools), which uses the same grammar pipeline. [Learn more](https://platform.claude.com/docs/en/build-with-claude/structured-outputs#data-retention) | PHI must not be included in JSON schema definitions; see PHI handling guidelines. [Learn more](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#phi-handling-guidelines) |
1196
1197Applicable endpoints:
1198
1199* `/v1/messages`
11451200
agents-and-tools/tool-use/text-editor-tool Changed · +57 / -4 lines
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) ### Data handling
from line 2
22title: Text editor tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool
44description: Give Claude the Anthropic-defined text editor tool to view, create, and edit files, and handle its view, str_replace, create, and insert commands.
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). Client-side tool run in your environment.
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
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
1137Claude can use an Anthropic-schema text editor tool to view and modify text files, helping you debug, fix, and improve your code or other text documents. This allows Claude to directly interact with your files, providing hands-on assistance rather than just suggesting changes.
1238
1339For model support, see the [Tool reference](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-reference).
from line 2301
22752301 Run shell commands with Claude.
22762302 </Card>
22772303</CardGroup>
2304
2305## Availability
2306
2307Text editor tool is available on every model and eligible for zero data retention and HIPAA readiness.
2308
2309### API support
2310
2311#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2312
2313* Availability: Available
2314
2315| Status | Cloud platforms |
2316| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2317| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2318
2319### Data handling
2320
2321[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2322
2323| Item | Zero data retention | HIPAA |
2324| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
2325| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
2326| Details | Client-side tool run in your environment. | — |
2327
2328Applicable endpoints:
2329
2330* `/v1/messages` with `text_editor` tool
22782331
agents-and-tools/tool-use/tool-runner Changed · +50 / -0 lines
## 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)
from line 2
22title: Tool runner (SDK)
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner
44description: Use the SDK's tool runner to handle the agentic loop, error wrapping, and type safety automatically.
5featureMetadata:
6 status: beta
7 supportedModels:
8 - claude-fable-5-1
9 - claude-mythos-5-1
10 - claude-fable-5
11 - claude-mythos-5
12 - claude-mythos-preview
13 - claude-opus-5-5
14 - claude-opus-5
15 - claude-sonnet-5-5
16 - claude-sonnet-5
17 - claude-haiku-5-5
18 - claude-haiku-4-5-20251001
19 - claude-opus-4-8
20 - claude-opus-4-7
21 - claude-opus-4-6
22 - claude-sonnet-4-6
23 - claude-opus-4-5-20251101
24 - claude-sonnet-4-5-20250929
25 supportedPlatforms:
26 Claude API: beta
27 Claude Platform on AWS: beta
28 Amazon Bedrock: beta
29 Amazon Bedrock (InvokeModel): beta
30 Claude Models on Google Cloud (Google managed): beta
31 Microsoft Foundry: beta
532---
633
734The tool runner handles the agentic loop, error wrapping, and type safety so you don’t have to. When you need human-in-the-loop approval, custom logging, or conditional execution, use the [manual loop](https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls) instead.
from line 1810
17831810 Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
17841811 </Card>
17851812</CardGroup>
1813
1814## Availability
1815
1816Tool runner is in beta on every model.
1817
1818### API support
1819
1820#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1821
1822* Availability: Available
1823
1824| Status | Cloud platforms |
1825| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1826| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
1827
1828#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1829
1830* Availability: Available
1831* Usage: The Python, TypeScript and Go SDKs have a session tool runner that runs your tools for a session’s custom tool calls. The session itself runs the agent loop.
1832
1833| Status | Cloud platforms |
1834| ------ | ------------------------------------------------------------------------------------------------------------------ |
1835| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
17861836
agents-and-tools/tool-use/tool-search-tool Changed · +66 / -4 lines
## 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
from line 2
22title: Tool search tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool
44description: Scale to hundreds or thousands of tools by letting Claude search your tool catalog and load only the tools it needs.
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). Server-side tool run by Anthropic; the tool definitions in the request are searched in memory per call and nothing is stored after the response.
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel):
33 availability: ga
34 note: On Amazon Bedrock it is not available through the Converse API.
35 Claude Models on Google Cloud (Google managed): ga
36 Microsoft Foundry: ga
537---
638
739The tool search tool lets Claude work with hundreds or thousands of tools by discovering and loading them on demand. Instead of loading all tool definitions into the context window up front, Claude searches your tool catalog (including tool names, descriptions, argument names, and argument descriptions) and loads only the tools it needs.
from line 55
2355 Share feedback on this feature through the [feedback form](https://forms.gle/MhcGFFwLxuwnWTkYA).
2456</Note>
2557
26<Note>
27 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).
28</Note>
29
3058<Warning>
3159 On Amazon Bedrock, server-side tool search is available only through the [InvokeModel API](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-runtime_example_bedrock-runtime_InvokeModel_AnthropicClaude_section.html), not the Converse API.
3260</Warning>
from line 899
871899 Specify tool schemas, write effective descriptions, and control when Claude calls your tools.
872900 </Card>
873901</CardGroup>
902
903## Availability
904
905Tool search tool is available on every model and eligible for zero data retention.
906
907### API support
908
909#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
910
911* Availability: Available
912
913| Status | Cloud platforms | Models |
914| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
915| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) | [All models](https://platform.claude.com/docs/en/models/overview) |
916| Available<sup>1</sup> | [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) | [All models](https://platform.claude.com/docs/en/models/overview) |
917
9181. On Amazon Bedrock it is not available through the Converse API.
919
920#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
921
922* Availability: Not available
923
924### Data handling
925
926[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
927
928| Item | Zero data retention | HIPAA |
929| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
930| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Not eligible |
931| Details | Server-side tool run by Anthropic; the tool definitions in the request are searched in memory per call and nothing is stored after the response. | — |
932
933Applicable endpoints:
934
935* `/v1/messages` with `tool_search` tool
874936
agents-and-tools/tool-use/web-fetch-tool Changed · +74 / -3 lines
## 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
from line 2
22title: Web fetch tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool
44description: Fetch and read content from specific URLs to augment Claude's context with live web content.
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). Fetched web content returned in the API response. Dynamic filtering for web fetch is not eligible for ZDR or HIPAA. Website publishers might retain request data (such as fetched URLs and request metadata) according to their own policies.
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 Microsoft Foundry:
33 availability: ga
34 note: "Deployments hosted on Azure support only `web_fetch_20250910`: no dynamic filtering, response inclusion or cache bypass."
535---
636
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>
37**API support**: Usage differs by product.
1038
39* **Messages API**: Add a `web_fetch` tool to the request’s `tools`.
40* **Managed Agents**: On by default in the agent toolset, without `max_uses`, `citations` or `cache_control`.
41
1142The web fetch tool allows Claude to retrieve full content from specified webpages and PDF documents.
1243
1344The latest web fetch tool version (`web_fetch_20260318`) supports **dynamic filtering**: Claude can write and execute code to filter fetched content before it reaches the context window, keeping only relevant information and discarding the rest. This reduces token consumption while maintaining response quality. Dynamic filtering is available with Claude 4.6 and later models and [Claude Mythos Preview](https://anthropic.com/glasswing). `web_fetch_20260318` also adds [response inclusion](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool#response-inclusion) control for agentic workflows. The previous versions (`web_fetch_20260309` for dynamic filtering and [cache bypass](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool#cache-bypass), `web_fetch_20260209` for dynamic filtering only, `web_fetch_20250910` for basic fetch) remain available.
from line 1065
10341065 Directory of Anthropic-provided tools and reference for optional tool definition properties.
10351066 </Card>
10361067</CardGroup>
1068
1069## Availability
1070
1071Web fetch tool is available on every model and eligible for zero data retention.
1072
1073### API support
1074
1075#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
1076
1077* Availability: Available
1078* Usage: Add a `web_fetch` tool to the request’s `tools`. Settings such as `max_uses`, domain lists, `citations` and `max_content_tokens` go on that tool.
1079
1080| Status | Cloud platforms |
1081| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1082| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
1083| Available<sup>1</sup> | [Microsoft Foundry (hosted on Azure)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
1084
10851. Deployments hosted on Azure support only `web_fetch_20250910`: no dynamic filtering, response inclusion or cache bypass.
1086
1087#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
1088
1089* Availability: Available
1090* Usage: Part of the agent toolset, and on by default once the toolset is added. Domain lists (with no paths) and `max_content_tokens` go on the toolset’s `web_fetch` entry; `max_uses`, `citations` and `cache_control` are not available.
1091
1092| Status | Cloud platforms |
1093| --------- | ------------------------------------------------------------------------------------------------------------------ |
1094| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
1095
1096### Data handling
1097
1098[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
1099
1100| Item | Zero data retention | HIPAA |
1101| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
1102| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Not eligible |
1103| Details | Fetched web content returned in the API response. Dynamic filtering for web fetch is not eligible for ZDR or HIPAA. Website publishers might retain request data (such as fetched URLs and request metadata) according to their own policies. | — |
1104
1105Applicable endpoints:
1106
1107* `/v1/messages` with `web_fetch` tool
10371108
agents-and-tools/tool-use/web-search-tool Changed · +77 / -3 lines
## 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
from line 2
22title: Web search tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
44description: Give Claude access to current web content with cited sources, optional dynamic filtering, and domain controls.
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). Real-time web search results returned in the API response. Dynamic filtering for web search is not eligible for ZDR or HIPAA.
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 Claude Models on Google Cloud (Google managed):
33 availability: ga
34 note: Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
35 Microsoft Foundry:
36 availability: ga
37 note: Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
538---
639
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>
40**API support**: Usage differs by product.
1041
42* **Messages API**: Add a `web_search` tool to the request’s `tools`. Settings such as `max_uses`, domain lists and `user_location` go on that tool.
43* **Managed Agents**: On by default in the agent toolset, without `max_uses`, `citations` or `cache_control`.
44
1145The web search tool gives Claude direct access to real-time web content, allowing it to answer questions with up-to-date information beyond its knowledge cutoff. The response includes citations for sources drawn from search results.
1246
1347With `web_search_20260209` and later versions, Claude can write and run code that filters the search results before they reach the context window (**dynamic filtering**), keeping only relevant information. Dynamic filtering is available with Claude 4.6 and later models and [Claude Mythos Preview](https://anthropic.com/glasswing).
from line 723
689723 Directory of Anthropic-provided tools and reference for optional tool definition properties.
690724 </Card>
691725</CardGroup>
726
727## Availability
728
729Web search tool is available on every model and eligible for zero data retention and HIPAA readiness.
730
731### API support
732
733#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
734
735* Availability: Available
736* Usage: Add a `web_search` tool to the request’s `tools`. Settings such as `max_uses`, domain lists and `user_location` go on that tool.
737
738| Status | Cloud platforms |
739| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
740| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
741| Available<sup>1</sup> | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry (hosted on Azure)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
742
7431. Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
744
745#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
746
747* Availability: Available
748* Usage: Part of the agent toolset, and on by default once the toolset is added. Domain lists and `user_location` go on the toolset’s `web_search` entry; `max_uses`, `citations` and `cache_control` are not available.
749
750| Status | Cloud platforms |
751| --------- | ------------------------------------------------------------------------------------------------------------------ |
752| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
753
754### Data handling
755
756[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
757
758| Item | Zero data retention | HIPAA |
759| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
760| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
761| Details | Real-time web search results returned in the API response. Dynamic filtering for web search is not eligible for ZDR or HIPAA. | Dynamic filtering for web search is not eligible for ZDR or HIPAA. |
762
763Applicable endpoints:
764
765* `/v1/messages` with `web_search` tool
692766
api/errors Changed · +4 / -4 lines
from line 42
4242
4343## Request size limits
4444
45The API enforces request size limits:
45The first-party Claude API enforces these request size limits. For other platforms, see the [API overview](https://platform.claude.com/docs/en/api/overview#request-size-limits).
4646
4747| Endpoint type | Maximum request size |
4848| ----------------------------------------------------------------------------------- | -------------------- |
49| Messages API | 32 MB |
50| Token Counting API | 32 MB |
49| Messages API | 128 MB |
50| Token Counting API | 128 MB |
5151| [Batch API](https://platform.claude.com/docs/en/build-with-claude/batch-processing) | 256 MB |
5252| [Files API](https://platform.claude.com/docs/en/build-with-claude/files) | 500 MB |
5353
54If you exceed these limits, you’ll receive a 413 `request_too_large` error. On the direct Claude API, Cloudflare returns this error before the request reaches the API servers.
54If you exceed these limits, you’ll receive a 413 `request_too_large` error. On the first-party Claude API, Cloudflare returns this error before the request reaches the API servers.
5555
5656## Error shapes
5757
api/opentelemetry/spans Changed · +27 / -1 lines
from line 7
77 title: OpenTelemetry
88 url: https://platform.claude.com/docs/en/manage-claude/opentelemetry
99 status: beta
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: beta
30 Claude Platform on AWS: beta
31 Claude Models on Google Cloud (Anthropic managed): beta
32 Amazon Bedrock: beta
33 Amazon Bedrock (InvokeModel): beta
34 Claude Models on Google Cloud (Google managed): beta
35 Microsoft Foundry: beta
1036---
1137
1238<Note>
from line 84
5884| `url.query` | `string` | The URL’s query string, with only the query parameters that the endpoint defines. Absent when there are none. |
5985| `url.full` | `string` | The request’s URL. |
6086
61On Claude Platform on AWS, API spans don’t have `server.address`, `server.port`, or `url.full`.
87API spans for requests sent through a cloud platform, such as Claude Platform on AWS, don’t have `server.address`, `server.port`, or `url.full`.
6288
6389### Session attributes
6490
api/overview Changed · +6 / -4 lines
from line 74
7474
7575## Claude API versus cloud platforms
7676
77Claude is available through the direct Claude API and through cloud platforms. Choose based on your infrastructure, feature availability, compliance requirements, and pricing preferences.
77Claude is available through the first-party Claude API and through cloud platforms. Choose based on your infrastructure, feature availability, compliance requirements, and pricing preferences.
7878
7979### Claude API
8080
from line 99
9999| Microsoft Foundry | Microsoft Azure (Anthropic-operated) | [Claude in Microsoft Foundry](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
100100
101101<Note>
102 Claude Managed Agents is available through the direct Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), and [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed). For feature availability across platforms, see the [Features overview](https://platform.claude.com/docs/en/build-with-claude/overview).
102 Claude Managed Agents is available through the first-party Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), and [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed). For feature availability across platforms, see the [Features overview](https://platform.claude.com/docs/en/build-with-claude/overview).
103103</Note>
104104
105105## Request and response format
from line 106
106106
107107### Request size limits
108108
109The first-party Claude API enforces these request size limits:
110
109111| Endpoint | Maximum request size |
110112| -------------------------------------------------------------------------------------------------------------------- | -------------------- |
111| Messages, Token Counting | 32 MB |
113| Messages, Token Counting | 128 MB |
112114| Message Batches API (see [Batch processing](https://platform.claude.com/docs/en/build-with-claude/batch-processing)) | 256 MB |
113115| [Files API](https://platform.claude.com/docs/en/build-with-claude/files) | 500 MB |
114116| Sessions, Agents, Environments | 32 MB |
from line 118
116118If you exceed these limits, you’ll receive a 413 `request_too_large` error.
117119
118120<Note>
119 Partner-operated platforms have their own request size limits: Bedrock limits requests to 20 MB, and Claude Models on Google Cloud (Google managed) limits requests to 30 MB. Claude Platform on AWS uses the same limits as the direct Claude API. Consult your platform’s documentation for current values.
121 Partner-operated platforms have their own request size limits: Bedrock limits requests to 20 MB, and Claude Models on Google Cloud (Google managed) limits requests to 30 MB. Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), and Microsoft Foundry support Messages and Token Counting requests of up to 32 MB. Consult your platform’s documentation for current values.
120122</Note>
121123
122124### Response headers
api/service-tiers Changed · +45 / -0 lines
## 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)
from line 2
22title: Service tiers
33url: https://platform.claude.com/docs/en/api/service-tiers
44description: Different tiers of service allow you to balance availability, performance, and predictable costs based on your application's needs.
5featureMetadata:
6 status: ga
7 supportedModels:
8 - claude-fable-5-1
9 - claude-mythos-5-1
10 - claude-fable-5
11 - claude-mythos-5
12 - claude-mythos-preview
13 - claude-opus-5-5
14 - claude-opus-5
15 - claude-sonnet-5-5
16 - claude-sonnet-5
17 - claude-haiku-5-5
18 - claude-haiku-4-5-20251001
19 - claude-opus-4-8
20 - claude-opus-4-7
21 - claude-opus-4-6
22 - claude-sonnet-4-6
23 - claude-opus-4-5-20251101
24 - claude-sonnet-4-5-20250929
25 supportedPlatforms:
26 Claude API: ga
527---
628
729<Warning>
30 Service tiers are legacy.
31</Warning>
32
33<Warning>
834 Priority Tier capacity commitments are no longer available for purchase. Organizations with an existing commitment can continue to use Priority Tier through their contract end date, and this page remains available as a reference for them. If you need guaranteed capacity, [contact sales](https://claude.com/contact-sales).
935</Warning>
1036
from line 256
230256Priority Tier is supported on all available Claude models except Claude Fable 5.1, Claude Haiku 5.5, Claude Mythos 5.1, Claude Mythos 5, [Claude Mythos Preview](https://anthropic.com/glasswing), Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, and Claude Sonnet 5.
231257
232258Check the [Models overview](https://platform.claude.com/docs/en/models/overview) for more details on available models.
259
260## Availability
261
262Service tiers are available on every model.
263
264### API support
265
266#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
267
268* Availability: Available
269* Usage: Needs a Priority Tier commitment, which is no longer sold. With one, requests use Priority Tier by default; set `service_tier` to `"standard_only"` to use only standard capacity.
270
271| Status | Cloud platforms |
272| --------- | --------------- |
273| Available | Claude API |
274
275#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
276
277* Availability: Not available
233278