advisor-tool changedagents-and-tools/tool-use/advisor-tool
Recorded here
Lines+243added
Lines−21removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits27to this page, all time
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) #### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) ### Required beta headers ### Data handling
The whole hunk
from line 2, old and new numbered
/
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
No line in this hunk matches that.