The whole hunk
from line 46, old and new numbered
/
lines
from line 46
4646* Run `/advisor` with a model, such as `/advisor opus`, to set it.
4747* Run `/advisor off` to turn it off.
4848
49Claude Code doesn't invoke a saved advisor that your organization's [`availableModels`](/docs/en/model-config#restrict-model-selection) allowlist excludes. To use the advisor, pick an allowed model with `/advisor`. Claude Code still saves an advisor that your current main model doesn't support. That advisor activates after you switch to a [compatible main model](#choose-an-advisor-model) with [`/model`](/docs/en/model-config#setting-your-model).
49Claude Code doesn't invoke a saved advisor that your organization's [`availableModels`](/docs/en/model-config#restrict-model-selection) allowlist excludes. To use the advisor, pick an allowed model with `/advisor`.
5050
51Claude Code still saves an advisor that your current main model doesn't support. That advisor activates after you switch to a [compatible main model](#choose-an-advisor-model) with [`/model`](/docs/en/model-config#setting-your-model). If the API already refused the saved advisor in the current conversation, it stays off until `/clear` or `/compact`, even after you switch models.
52
5153On some plans, Fable as the advisor also needs your one-time [consent to bill Fable usage to usage credits](/docs/en/model-config#fable-and-usage-credits). For what `/advisor fable` does before you have given that consent, see [Fable advisor and usage credits](#fable-advisor-and-usage-credits).
5254
5355### Set `advisorModel` in settings
from line 83
8183
8284The advisor must be at least as capable as the main model. The accepted advisors for each main model are:
8385
84| Main model | Accepted advisors | Notes |
85| -------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
86| Haiku 4.5 | Fable, Opus, Sonnet | Haiku can call the advisor but cannot act as one |
87| Sonnet 4.6 | Fable, Opus, Sonnet | |
88| Sonnet 5 | Fable, Opus 4.7 or later, Sonnet 5 | A Sonnet 4.6 advisor is rejected, and requests with an Opus 4.6 advisor fail with an API error |
89| Opus 4.6 | Fable, Opus, Sonnet 5 | A Sonnet 4.6 advisor is rejected |
90| Opus 4.7 or Opus 4.8 | Fable, and Opus 4.7 or later | An Opus 4.6 or Sonnet advisor is rejected |
91| Opus 5 | Fable, Opus 5 | An Opus 4.6 or Sonnet advisor is rejected, and requests with an Opus 4.7 or Opus 4.8 advisor fail with an API error |
92| Fable 5 | Fable 5.1 or Fable 5 | An Opus or Sonnet advisor is rejected |
93| Fable 5.1 | Fable 5.1 | An Opus or Sonnet advisor is rejected, and requests with a Fable 5 advisor fail with an API error |
86| Main model | Accepted advisors | Notes |
87| -------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------- |
88| Haiku 4.5 | Fable, Opus, Sonnet | Haiku can call the advisor but cannot act as one |
89| Sonnet 4.6 | Fable, Opus, Sonnet | |
90| Sonnet 5 | Fable, Opus 4.7 or later, Sonnet 5 | A Sonnet 4.6 advisor is rejected, and the API refuses an Opus 4.6 advisor |
91| Opus 4.6 | Fable, Opus, Sonnet 5 | A Sonnet 4.6 advisor is rejected |
92| Opus 4.7 or Opus 4.8 | Fable, and Opus 4.7 or later | An Opus 4.6 or Sonnet advisor is rejected |
93| Opus 5 | Fable, Opus 5 | An Opus 4.6 or Sonnet advisor is rejected, and the API refuses an Opus 4.7 or Opus 4.8 advisor |
94| Fable 5 | Fable 5.1 or Fable 5 | An Opus or Sonnet advisor is rejected |
95| Fable 5.1 | Fable 5.1 | An Opus or Sonnet advisor is rejected, and the API refuses a Fable 5 advisor |
9496
9597Fable 5.1 requires Claude Code v2.1.257 or later. Both Fable models require [Fable access](/docs/en/model-config#work-with-fable).
9698
from line 103
101103Claude Code validates the pairing before sending a request, and the API validates it again:
102104
103105* For an advisor the table lists as rejected, Claude Code doesn't attach it to the main model's requests. The `/advisor` command output and a notification show this. Subagents whose own model satisfies the pairing may still use the advisor.
104* For an advisor the table lists as failing with an API error, Claude Code attaches it and the API refuses it. Every request fails with `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` until you change the advisor with `/advisor` or turn it off.
106* For an advisor the table lists as refused by the API, Claude Code attaches it and the API refuses it. Claude Code then resends that request without the advisor, and the rest of the conversation runs without one, so you see no error and get no advisor calls. Pick an accepted advisor with `/advisor`; the change takes effect after `/clear` or `/compact` and in new sessions.
105107* If the main model or the advisor is a model Claude Code does not recognize, the advisor is not attached.
106108
107109### Fable advisor and usage credits