Skip to main content
The advisor tool is experimental and requires the Anthropic API. It is not available on Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, or Microsoft Foundry. Behavior, pricing, and availability may change.
The advisor tool lets Claude consult a second, typically stronger model at key moments during a task, such as before committing to an approach, when stuck on a recurring error, or before declaring a task complete. The advisor receives the full conversation, including every tool call and result, and returns guidance that Claude applies before continuing. The advisor runs server-side on Anthropic’s infrastructure as a server tool, available to both subscription and API-billed accounts. You choose which model acts as the advisor, and Claude decides when to call it. This page covers how to enable the advisor, which model pairings are accepted, what Claude shows during a consultation, and how advisor usage is billed.

​
When to use the advisor

The advisor fits long, multi-step tasks where most turns are routine but plan quality determines the outcome. Examples include large refactors, debugging sessions where an error keeps recurring, and tasks you want independently checked before Claude declares them done. It adds less value on short tasks where there is little to plan, or on work where every turn needs the strongest model. For those, switch the main model instead, or see how the advisor compares with opusplan and subagents for other ways to get a second opinion.

​
Enable the advisor

You can set the advisor model in three ways:
  • /advisor command: set or change the advisor mid-session and save it as your default
  • advisorModel setting: configure a persistent default in your settings file
  • --advisor flag: set the advisor for a single session at launch
Each of these enables the advisor for sessions whose main model supports it. After the session starts, Claude Code shows an Advisor Tool (experimental) is on and may use more tokens · /advisor notification. To stop using the advisor, see Turn the advisor off. On some plans, Fable as the advisor also needs your one-time consent to bill Fable 5 usage to usage credits. For what happens before you have given that consent, see Fable advisor and usage credits.

​
Use the /advisor command

Run /advisor without arguments to open a picker listing the available advisor models, or pass the model directly:
The command confirms with Advisor set to followed by the advisor model name. Your selection is saved to advisorModel in your user settings and persists across sessions. Claude Code doesn’t invoke a saved advisor that your organization’s availableModels 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 with /model. On some plans, Fable as the advisor also needs your one-time consent to bill Fable 5 usage to usage credits. For what /advisor fable does before you have given that consent, see Fable advisor and usage credits.

​
Set advisorModel in settings

To configure the advisor as a default without opening a session, set it in your settings file:

​
Use the --advisor flag

To set the advisor for a single session without changing your saved setting, launch with the flag:
Claude Code uses the flag instead of the advisorModel setting for that session. It doesn’t list --advisor in claude --help. Claude Code exits with an error at launch if:
  • The session’s main model doesn’t support the advisor
  • The requested model, such as Haiku, can’t act as an advisor
  • Your organization’s availableModels allowlist excludes the requested model
  • You requested Fable and your account still requires the usage-credits consent
If you start a background session with --advisor and one of these applies, Claude Code starts the session without the advisor instead of exiting.

​
Choose an advisor model

The advisor must be at least as capable as the main model. The accepted advisors for each main model are: Fable 5 requires Claude Code v2.1.170 or later and Fable 5 access, whether it acts as the main model or the advisor. Set the advisor as fable, opus, or sonnet. These aliases resolve to Claude Code’s built-in default version for each model family, which advances with new Claude Code releases. You can also pass a full model ID such as claude-opus-5. Subagents inherit the configured advisor and apply the same pairing check against their own model. Claude Code validates the pairing before sending a request:
  • If the advisor is less capable than the main model, the advisor is not attached 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.
  • If the main model or the advisor is a model Claude Code does not recognize, the advisor is not attached.

​
Fable advisor and usage credits

On some plans, Fable 5 usage bills to usage credits, and Claude Code asks for your one-time consent to bill Fable 5 usage to usage credits when you select Fable 5 with /model. Fable as the advisor bills the same way, so on those plans Claude Code doesn’t apply Fable as the advisor until you have accepted that consent. Before you have accepted it, Claude Code doesn’t save Fable as the advisor when you type /advisor fable or pick Fable in the /advisor picker. It points you to /model fable instead. With claude --advisor fable, Claude Code exits at launch with a message that points to /model fable. In a background session, it starts the session without the advisor instead of exiting. With Fable already saved as your advisorModel, Claude Code sends requests without the advisor. In an interactive session whose main model supports the advisor, it also shows a notification that points to /model fable. To accept the consent, run /model fable and choose to continue on Fable 5. Claude Code records the consent and saves Fable 5 as your selected model. Then select Fable as the advisor.

​
Common model pairings

Any accepted pairing works. These combinations balance cost against capability in different ways:

​
When Claude consults the advisor

Claude decides when to call the advisor. It tends to consult before committing to an approach, when an error keeps recurring, and before declaring a task done, but the timing is model-driven rather than rule-based. You can ask for a consultation in your prompt the same way you would request any tool, for example consult the advisor before you continue. There is no setting to cap or force advisor calls; if you want Claude to consult more or less often during a task, say so in your instructions.

​
What you see during a session

When Claude calls the advisor, the transcript shows an Advising line with the advisor model name while the call is in progress. When the result returns, the line reports whether the advisor gave guidance:
  • Reviewed: the line confirms that the advisor has reviewed the conversation. Press Ctrl+O to expand it and read the advisor’s full guidance.
  • Declined: the line reads Advisor declined to advise on this request. If the advisor gave a reason, press Ctrl+O to read it.
Claude generally follows the advisor’s guidance, but adapts when its own evidence contradicts a specific claim: if a recommended step fails when tried, or the file contents contradict the advice, Claude surfaces the conflict rather than following the guidance unconditionally. The advisor always receives the full conversation, and Claude controls the timing. For more control or a different configuration, see how the advisor compares with subagents and opusplan.

​
Cost

When Claude calls the advisor, the advisor model reads the conversation, so each call consumes tokens at the advisor model’s rates in addition to your main model’s usage. With API billing, you pay the advisor model’s input and output rates for advisor tokens. On subscription plans, advisor usage counts toward your plan’s usage limits, except that a Fable 5 advisor bills to usage credits on plans where Fable 5 usage does. If your account requires the usage-credits consent, a Fable advisor bills nothing before you give it, because Claude Code doesn’t apply the selection until then. Claude calls the advisor at decision points rather than on every turn, so pairing a faster main model with a stronger advisor typically costs less than running the stronger model throughout. Advisor usage counts toward the session totals shown by /usage. For how advisor tokens are reported in API responses, see Usage and billing in the Claude API documentation.

​
Impact on prompt caching

Enabling or disabling the advisor mid-session does not invalidate your main model’s prompt cache. Unlike changing model or effort level, toggling /advisor keeps the cached prefix intact, and the advisor’s returned guidance is cached as part of the transcript on later turns. The advisor model’s own read of the conversation is not cached. Each advisor call processes the full transcript anew, with no reuse between calls.

​
Requirements

The advisor tool requires all of the following:
  • Anthropic API only: the advisor is a server-executed tool. It is not available on Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, or Microsoft Foundry. Through an LLM gateway configured with ANTHROPIC_BASE_URL, availability depends on whether the gateway forwards the request intact to the Anthropic API.
  • Supported main model: Opus 4.6 or later, Sonnet 4.6 or later, or Haiku 4.5. Fable 5 also qualifies on Claude Code v2.1.170 or later, and a Fable 5 main accepts only a Fable advisor.
  • Feature-flag fetching: Claude Code turns the advisor on through a feature flag it fetches from Anthropic. In a session where a variable that turns flag fetching off is set, such as DISABLE_TELEMETRY, the advisor stays off. See Features that need feature-flag fetching.

​
Turn the advisor off

To stop using the advisor and clear your saved advisorModel, run /advisor off or choose No advisor in the /advisor picker:
To disable the advisor tool entirely, set CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. The /advisor command becomes unavailable and any configured advisorModel is ignored. The --advisor flag is accepted but has no effect. See Environment variables. The advisor is one of several ways to combine model strengths. Pick based on when you want a second model involved.

​
See also