Claude Code 的 /advisor 可以讓 Fable 5.1 在 Opus 5.5 寫程式時待命當顧問,顧問會讀完整段對話與每一次工具呼叫,但何時向它求助,由 Opus 5.5 自己決定。 依 2026 年 10 月 2 日讀取的 Anthropic 官方文件,Opus 5.5 搭 Fable 5.1 是文件列出的可接受配對。文件同時寫明三個設定前要知道的限制:Fable 在部分方案要先同意以用量點數計費,求助時機沒有設定可以強制或限制,顧問每次諮詢都會重新讀完整段對話,並照顧問模型的費率計費。

設定時有一步容易出錯:把 effortLevel 寫進使用者層級的 settings.json,對 Opus 5.5 並不生效。

顧問怎麼運作

顧問是在 Anthropic 基礎設施上執行的伺服器端工具,訂閱帳號與 API 計費帳號都能用。你指定哪個模型當顧問,Claude 決定何時呼叫。顧問收到完整對話,包含每一次工具呼叫與結果,回傳指引,主模型先套用再繼續。Anthropic 在 2026 年 4 月 9 日的公告裡描述,顧問不呼叫工具,也不產生給使用者看的輸出,只提供指引。

主模型不會無條件照辦。文件寫明,如果建議的步驟實際失敗,或檔案內容與建議矛盾,Claude 會把衝突攤出來,而不是照單全收。

顧問的運作方式:Opus 5.5 主對話在關鍵時刻向 Fable 5.1 顧問求助,顧問讀完整對話後只回傳指引,由 Opus 5.5 套用

啟用有三種方式:

  • 在對話中執行 /advisor,會開出選單,或直接帶模型,例如 /advisor opus。選擇會存進使用者設定的 advisorModel。
  • 在設定檔寫 advisorModel,當作持久的預設值。
  • 用 claude --advisor opus 啟動,只對該次工作階段有效,不改已儲存的設定。文件說這個旗標不會列在 claude --help 裡。

要關閉就執行 /advisor off。要完全停用,設定環境變數 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1,這時 /advisor 指令會失效,已設定的 advisorModel 也會被忽略。

顧問被呼叫時,對話記錄會出現一行 Advising,後面接顧問的模型名稱。結束後會顯示三種結果之一:Reviewed 表示顧問看過了,Declined 表示顧問拒絕給建議,Unavailable 表示呼叫失敗。按 Ctrl+O 可以讀顧問的內容。

什麼時候開口:傾向,不是規則

文件的說法是,Claude 傾向在決定做法之前、錯誤反覆出現時、宣告任務完成之前諮詢顧問,但時機由模型驅動,不是由規則驅動。沒有設定可以限制或強制次數。想讓它多問或少問,要寫在提示或指示裡,文件舉的例子是直接說「在繼續之前先諮詢顧問」。

所以三個時機只能當成預設傾向,不是保證。想讓它更穩定,就把要求寫成明確的指示。

Opus 5.5 搭 Fable 5.1:官方接受的配對

Claude Code 與 API 都要求顧問至少和主模型一樣強,而且兩邊對部分模型的排序略有不同。Opus 5.5 當主模型時,可接受的顧問是 Fable,以及 Opus 5 以上的版本。

主模型 可接受的顧問 備註
Opus 5.5 或 Opus 5 Fable,以及 Opus 5 以上 Opus 4.6 或 Sonnet 顧問會被拒絕;API 會拒絕 Opus 4.7 與 4.8 顧問
Sonnet 5.5 Fable、Opus 5 以上、Sonnet 5.5 Sonnet 4.6 顧問會被拒絕;API 會拒絕 Sonnet 5、Opus 4.6、4.7、4.8 顧問
Fable 5.1 只有 Fable 5.1 Opus 或 Sonnet 顧問會被拒絕;API 會拒絕 Fable 5 顧問
Haiku 4.5 Fable、Opus、Sonnet Haiku 可以呼叫顧問,但不能當顧問

被 API 拒絕的情況最容易踩坑。Claude Code 照樣把顧問附上,API 拒絕後,Claude Code 會把該次請求改成不帶顧問重送,之後整段對話都沒有顧問。你看不到錯誤,也不會有任何顧問呼叫。修正的方式是用 /advisor 改選可接受的顧問,改完要在 /clear 或 /compact 之後,或新的工作階段才會生效。

fable、opus、sonnet 三個別名會解析成 Claude Code 內建的各系列預設版本,這個版本會隨 Claude Code 更新而變動。要固定版本,可以填完整的模型 ID,例如 claude-opus-5-5。子代理也會繼承設定的顧問,並用自己的模型重新檢查配對。

設定前要過的四關

文件把顧問標示為實驗性功能,行為、定價與可用性都可能改變。下面四關任何一關沒過,顧問都不會如你預期運作。

關卡 文件的要求 文件寫明的後果
平台 顧問是伺服器端工具,只支援 Anthropic API,不支援 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 與 Microsoft Foundry;經 ANTHROPIC_BASE_URL 的閘道要看它是否完整轉送請求 不在支援平台上,顧問不可用
版本 Fable 5.1 需要 Claude Code v2.1.257 以上,且帳號要有 Fable 存取權;在 -p、Agent SDK、桌面版與 Remote Control 使用 /advisor,需要 v2.1.260 以上 文件未另行說明
功能旗標 Claude Code 透過向 Anthropic 抓取的功能旗標開啟顧問;DISABLE_TELEMETRY、DO_NOT_TRACK、DISABLE_GROWTHBOOK 與 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 會停止抓取 設了這些變數的工作階段,顧問保持關閉
Fable 計費同意 部分方案要先同意把 Fable 用量計入用量點數,先執行 /model fable 並選擇繼續 同意前,/advisor fable 不會儲存;claude --advisor fable 會在啟動時結束
設定顧問前要過的四關:平台、版本、功能旗標、Fable 計費同意

費用:每次諮詢都重新讀完整段對話

顧問每被呼叫一次,顧問模型就會讀一遍整段對話,這些 token 照顧問模型的費率計算,另外加在主模型的用量之外。顧問自己對對話的讀取不會被快取,每次呼叫都重新處理完整逐字稿。中途開關顧問則不會讓主模型的提示快取失效。

計費方式取決於你怎麼付費。API 計費帳號,顧問的輸入與輸出照顧問模型的費率。訂閱方案,顧問用量計入方案的用量上限,但在 Fable 用量計入用量點數的方案上,Fable 顧問改計用量點數。/usage 顯示的工作階段總計包含顧問用量。

Anthropic 公布過數字,但配對和你的不一樣。2026 年 4 月 9 日的公告說,Sonnet 4.6 搭 Opus 4.6 顧問,在 SWE-bench Multilingual 比單獨用 Sonnet 高 2.7 個百分點,每個代理任務的成本降低 11.9%。Haiku 4.5 搭 Opus 顧問,在 BrowseComp 得 41.2%,單獨用 Haiku 是 19.7%;它的成績比單獨用 Sonnet 低 29%,但每個任務的成本低 85%。這些評測用的是 API 的顧問工具,而且執行者都比顧問便宜。

Anthropic 公布的顧問評測:Sonnet 4.6 搭 Opus 4.6 顧問成績高 2.7 個百分點、成本低 11.9%,Haiku 4.5 搭 Opus 顧問在 BrowseComp 得 41.2%、單獨用 Haiku 是 19.7%;Opus 5.5 搭 Fable 5.1 沒有公開成績

Opus 5.5 搭 Fable 5.1,我們在官方文件與這篇公告裡找不到評測成績,所以它能不能省錢或提高品質,目前沒有公開數字可以引用。文件列出的常見配對裡,Opus 搭 Opus 的說明是第二個 Opus 審查第一個,適合獨立檢查比成本更重要的高風險任務,Sonnet 搭 Fable 的說明是在決策點取得 Fable 的指引,而不必全程跑 Fable。Opus 5.5 搭 Fable 5.1 沒有出現在那張表裡。

一個設定步驟對 Opus 5.5 不生效

要把主對話設成 high,直覺的寫法是在 ~/.claude/settings.json 的最上層寫 effortLevel。文件說,使用者設定檔裡這個最上層的 effortLevel,對 Opus 5.5 不算數。它是 /effort 在 Claude Code 改成按模型儲存之前的舊寫法,對 Opus 5、Fable 5.1 與更早的模型仍然有效。Opus 5.5 以及更晚發布的模型,會從自己的預設值開始,直到你用 /effort 或 /model 選單替它選定等級。Opus 5.5 的預設是 medium。

正確的做法有兩個。一是在對話裡執行 /effort high,按 Enter 儲存為預設,Claude Code 會按模型存進 modelSettings,這需要 v2.1.251 以上。二是直接寫 modelSettings:

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

專案、本機或受管設定檔裡的最上層 effortLevel,或用 --settings 傳入的,對所有模型都生效。另外,環境變數 CLAUDE_CODE_EFFORT_LEVEL 的優先順序最高,高過 --effort、/effort 與兩種設定檔,也高過子代理 frontmatter 裡的 effort。high 會花更多 token,沒有特別理由的話,保留 Opus 5.5 預設的 medium 也是合理的選擇。

可以直接貼進 Claude Code 的設定提示

目標配置是一個主對話、三個子代理,加一個待命的顧問:

主對話:Opus 5.5,effort high
├─ explorer:讀程式碼(model: opus,effort: medium)
├─ worker:修改檔案並執行測試(model: opus,effort: medium)
├─ researcher:查文件(model: opus,effort: medium)
└─ 顧問:Fable 5.1,待命

把這棵樹和下面的提示一起貼進 Claude Code。提示要求它先檢查、先給 diff,在你同意之前不動手。第 2 步用 modelSettings,原因見上一節。

請依照下面這棵樹,重建我的 Claude Code 設定:

主對話:Opus 5.5,effort high
explorer 讀程式碼,worker 修改檔案並執行測試,researcher 查文件,三者都用 medium
Fable 5.1 待命當顧問

1. 檢查 ~/.claude/agents 與 .claude/agents,找出已經符合 explorer、worker、researcher 的子代理。
   - 只為缺少的角色起草新的子代理
   - 每個子代理設定 model: opus、effort: medium
   - 已經固定使用其他模型的子代理不要動,列給我看

2. 在 ~/.claude/settings.json 的 modelSettings 底下,為 claude-opus-5-5 設定 effortLevel 為 high,並把 advisorModel 設為 fable。最上層的 effortLevel 對 Opus 5.5 不生效,不要用它。如果我的帳號需要先同意 Fable 的計費,請告訴我先執行 /model fable,不要替我處理。

3. 找出會讓顧問保持關閉的設定,包含 CLAUDE_CODE_DISABLE_ADVISOR_TOOL、DISABLE_TELEMETRY,以及任何會停止功能旗標抓取的環境變數。另外找出 CLAUDE_CODE_EFFORT_LEVEL,它會覆寫子代理的 effort。只回報,不要更動。

4. 在 ~/.claude/CLAUDE.md 加入一條規則:在進行大型計畫之前、同一個錯誤反覆出現時,以及宣告長任務完成之前,先諮詢顧問。

每一項變更都先用 diff 給我看,我說可以之前不要動手。

三個子代理也會繼承顧問,所以它們遇到難題時同樣可能向 Fable 求助,費用可能比只有主對話使用時更高。

怎麼知道顧問有沒有在運作

工作階段開始後,Claude Code 會顯示一則通知,內容是 Advisor Tool (experimental) is on and may use more tokens。沒看到這則通知,就先確認主模型支援顧問,並檢查前面四關。

長任務跑到一半,如果對話裡一次 Advising 都沒出現,優先檢查三件事:配對是否被 API 靜默拒絕,環境裡有沒有會停止功能旗標抓取的變數,以及 Fable 的計費同意是否完成。已經把 Fable 存成 advisorModel 但還沒同意時,Claude Code 會改成不帶顧問送出請求,互動模式下會顯示通知,指向 /model fable。

常見問題

/advisor fable 沒有生效怎麼辦?

先看你的帳號是否需要 Fable 計費同意:同意之前,/advisor fable 不會儲存任何設定。接著確認版本在 v2.1.257 以上、主模型與顧問是可接受的配對,並檢查環境裡有沒有 DISABLE_TELEMETRY 之類會停止功能旗標抓取的變數。

顧問會不會直接改我的程式?

不會。顧問只回傳指引,由主模型決定要不要採用。文件說,如果建議的步驟失敗,或檔案內容與建議矛盾,Claude 會把衝突攤出來。

能不能限制顧問被呼叫的次數?

Claude Code 沒有這類設定。文件說沒有設定可以限制或強制次數,想調整頻率,要寫在提示或指示裡。API 的顧問工具另有 max_uses 參數可以限制每次請求的呼叫數,但那是直接呼叫 API 才有的選項。

Amazon Bedrock、Google Cloud 或 Microsoft Foundry 能不能用顧問?

不行。顧問是伺服器端工具,只支援 Anthropic API,Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 與 Microsoft Foundry 都不支援。

Opus 5.5 預設的 effort 是多少?

medium。要改成 high,用 /effort high 或 modelSettings,不要用使用者設定檔最上層的 effortLevel。

主要來源

Author Insight

顧問模式最有價值的地方,是把審查和執行分開:動手的模型不必替自己的計畫打分數。但這個價值有個前提,就是顧問真的在關鍵時刻被叫到,而文件明說時機由模型決定。所以我會把導入當成一個要量測的實驗,而不是設定完就算升級完成。挑三到五個平常要花一兩小時的任務,各跑一次有顧問和沒有顧問,記下 /usage 的用量、顧問被呼叫的次數,以及最後需要人工重做的地方。如果顧問一次都沒被叫到,先查配對與環境變數,再談 Fable 值不值得。

術語表

  • 顧問工具(advisor tool):Claude Code 讓主模型在關鍵時刻諮詢另一個模型的伺服器端工具,目前標示為實驗性功能。
  • 主模型:負責寫程式與呼叫工具的模型,顧問只提供指引。
  • effort 等級(effort level):控制模型推理深度的設定,從 low 到 max,等級越高,花的 token 越多。
  • modelSettings:按模型儲存 effort 等級的設定欄位,需要 Claude Code v2.1.251 以上。
  • 子代理(subagent):由主對話委派、使用自己模型與設定的代理,定義在 .claude/agents 的檔案裡。
  • 提示快取(prompt cache):重複使用已處理過的對話前段,以降低重複讀取成本的機制。
  • 用量點數(usage credits):部分方案用來計算 Fable 用量的計費方式。
  • 功能旗標(feature flag):Claude Code 向 Anthropic 抓取、用來開啟特定功能的開關。
  • 伺服器端工具(server tool):在 Anthropic 伺服器上執行、不經過使用者電腦的工具。
Share this post
Ewan Mak

I'm a Full Stack Developer with expertise in building modern web applications that fast, secure, and scalable. Crafting seamless user experiences with a passion for headless CMS, Vercel and Cloudflare

Loading...