Claude Code 可以讓 Sonnet 5.5 跑主會話、遇到關鍵決策再請 Opus 5.5 當顧問,用 /advisor opus 或 claude –advisor opus 就能開。這篇我們整理給你三種省 Opus 的設定開法、模型配對規則、還有用量算法與兩個子代理範例檔!
(前情提要:Anthropic 官方攻略:Claude 模型怎麼選?多數工作用 Opus 5.5 起步)
(背景補充:Anthropic 推出 Claude Haiku 5.5,主打最便宜、最快的小模型)
重點摘要
- advisor 在 4 月 2.1.117 版就已出現
- Sonnet 5.5 可用 Opus 5 以上當顧問
- API 評測顯示加 Opus 顧問成本降 11.9%
想讓 Sonnet 5.5 負責寫程式、遇到關鍵決策再請 Opus 5.5 看一次,Claude Code 內建的 advisor(顧問)功能就做得到。這篇照官方文件整理開法、能搭配的模型、用量算法與確認生效的方法,讀完就能自己設好。
我們這篇想要教大家用 claude --model sonnet --advisor opus 來做終端機啟動。
本篇大綱
- advisor 做什麼、適合哪種工作
- 三種開法與使用條件
- 哪些模型可以互相搭配
- 怎麼確認有生效、用量怎麼算
- 用 Haiku 子代理分擔搜尋的範例檔
- X 貼文說法逐項對照官方
- 貼文提到的 JEV 是什麼
advisor 讓主模型在關鍵時刻請教較強的模型
依 Claude Code 官方文件,advisor 讓 Claude 在任務進行中諮詢第二個、通常更強的模型。顧問會收到完整對話,包括每一次工具呼叫與結果,讀完後回傳建議,主模型參考後再繼續。這項功能目前標示為實驗性(experimental),官方註明行為、價格與可用範圍都可能變動。
官方建議用在步驟多、多數回合是例行工作、但計畫品質決定成敗的長任務。文件舉的例子是大規模重構(refactor)、同一個錯誤反覆出現的除錯,以及希望完工前有人獨立檢查的工作。短任務沒什麼好規劃,或每一回合都需要最強模型的工作,官方建議直接換主模型。
官方文件把 advisor 和另外三種混用模型的做法並列比較:
- advisor:較強的模型只在任務中途的決策點被呼叫,由 Claude 自己決定何時呼叫
- opusplan:進入計畫模式(plan mode)時用 Opus,執行時換成 Sonnet
- 指定 model 的子代理:整個委派出去的子任務都用該模型
- /model:從下一個請求起整個換模型
三種開法與使用條件
第一種是在會話(session)裡打指令。直接打 /advisor 會跳出模型選單,也可以把模型名稱接在後面。
/advisor opus
畫面會回覆 Advisor set to 加上模型名稱。這個選擇會寫進使用者設定的 advisorModel,之後的會話都會沿用。v2.1.260 以後,桌面版、Remote Control 與 -p 非互動模式也能用文字版的 /advisor。
第二種是直接改設定檔(settings.json),不用先開會話。
{
"advisorModel": "opus"
}
第三種是啟動時加旗標,只影響這一場會話,不會改到存好的設定。
claude --model sonnet --advisor opus
這一步最容易卡在找不到旗標。官方文件寫明 --advisor 不會列在 claude --help 裡。筆者在 2.1.326 版跑 claude --help,輸出確實沒有 advisor 字樣。旗標仍然有效。動區用同一版傳入不存在的模型名稱,會回 Error: The model "zzzbad" cannot be used as an advisor.。
開啟後,畫面會出現 Advisor Tool (experimental) is on and may use more tokens · /advisor 的通知。要關掉就打 /advisor off,或在選單選 No advisor。想整個停用,可以設環境變數 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。設了之後 /advisor 指令會消失,設定檔裡的 advisorModel 也會被忽略。
使用前先確認三個條件:
- 供應商:要走 Anthropic API、Claude Platform on AWS 或 Claude Models on Google Cloud(Anthropic managed),後兩者要 v2.1.300 以上。Amazon Bedrock、Google Cloud 的 Agent Platform 與 Microsoft Foundry 都不能用。
- 功能旗標:AWS 與 Google Cloud 這兩種平台以外,advisor 要向 Anthropic 抓功能旗標(feature flag)。設了
DISABLE_TELEMETRY這類關閉抓取的變數,會話就沒有這個旗標。 - 版本:模型設定文件寫明,Opus 5.5 要 v2.1.280 以上,Sonnet 5.5 要 v2.1.284 以上,Haiku 5.5 要 v2.1.293 以上,跑
claude update就能升級。
Sonnet 5.5 可以配 Opus 5.5,反過來不行
Claude Code 會替模型排名,顧問的排名必須等於或高於主模型。官方相容表裡和 5.5 世代有關的幾列如下,Fable 是官方定位處理最難、最長任務的模型系列。
- 主模型 Sonnet 5.5:可配 Fable、Opus 5 以上、Sonnet 5.5
- 主模型 Opus 5 或 Opus 5.5:可配 Fable、Opus 5 以上
- 主模型 Sonnet 5 或 Haiku 5.5:可配 Fable、Opus 4.7 以上、Sonnet 5 以上、Haiku 5.5
- 主模型 Haiku 4.5:可配 Fable、Opus、Sonnet、Haiku 5.5,但 Haiku 4.5 自己不能當顧問
- 主模型是 Fable 系列:只接受 Fable 當顧問
照這張表,Sonnet 5.5 不能替 Opus 5.5 當顧問,Haiku 5.5 也不能替 Sonnet 5.5 當顧問。
顧問可以填別名 fable、opus、sonnet,或完整型號如 claude-opus-5-5。
這邊要注意,別名會依供應商指向不同版本。在 Anthropic API 上,opus、sonnet、haiku 分別是 Opus 5.5、Sonnet 5.5、Haiku 5.5。
在 Claude Platform on AWS 上,sonnet 是 Sonnet 4.6,haiku 是 Haiku 4.5。要固定版本,就寫完整型號。
配錯時的反應有兩種,用 --advisor 指定的模型本身不能當顧問(例如 Haiku 4.5),Claude Code 啟動時會跳錯誤並結束。模型能當顧問、但排名低於主模型,會話照常啟動,只是主模型不帶顧問。
看 Advising 那一行確認生效,用量算進方案額度
Claude 呼叫顧問時,對話紀錄會出現一行 Advising,後面接顧問模型名稱。結果分三種。
- Reviewed:顧問看過對話。有可讀的建議時,按
Ctrl+O展開 - Declined:顯示
Advisor declined to advise on this request,有附理由的話同樣按Ctrl+O看 - Unavailable:呼叫失敗,顯示
Advisor unavailable (<error_code>)
何時呼叫由模型決定。官方原文寫 Claude「tends to consult」(傾向諮詢)的時機有三個:決定做法之前、錯誤反覆出現時、宣布完工之前。文件同時註明「the timing is model-driven rather than rule-based」,時機由模型判斷,不是固定規則。
官方也寫明沒有設定可以限制或強制呼叫次數,想多問或少問,就在指示裡講,例如 consult the advisor before you continue。
Claude 通常會照顧問的建議做。官方說明,建議的步驟實際跑不通,或檔案內容和建議矛盾時,Claude 會把衝突講出來,不會照單全收。
每次呼叫顧問,顧問模型都要讀一次對話。這些 token 以顧問模型的費率計算,另外加上主模型自己的用量。API 計費的帳號付顧問模型的輸入與輸出費率;訂閱方案則算進方案的用量上限,Fable 顧問在部分方案改扣 usage credits。
官方的說法是,顧問只在決策點被呼叫,所以快的主模型配強的顧問,通常比全程用強模型便宜。不過顧問自己讀對話的部分不快取,每次呼叫都重新處理整份對話,對話越長,每次諮詢讀的 token 越多。中途開關 advisor 則不會讓主模型的提示快取(prompt cache)失效。
想知道實際用了多少,打 /usage。官方文件說顧問用量會算進 /usage 顯示的會話總計。
範例:用 Haiku 子代理分擔搜尋
在專案裡建三個 Haiku 5.5 子代理(subagent),分別負責梳理程式庫、定位呼叫點與檢查 diff(程式碼差異)。這是一種自組的分工模式,Anthropic 文件裡沒有這套配方,但照 子代理文件的格式做得出來。
子代理是放在 .claude/agents/ 的 Markdown 檔,開頭用 YAML 前置資料(frontmatter)寫設定,後面寫給子代理的系統提示。必填欄位只有 name 與 description。model 可填 haiku、sonnet、opus、fable、完整型號或 inherit。
第一個檔案存成 .claude/agents/search.md,只給讀取類工具。
---
name: search
description: Read-only repository search. Use to locate files, symbols and call sites before editing.
tools: Read, Grep, Glob
model: haiku
---
You search the repository and report file paths with line numbers.
Do not edit any file. Keep the summary short.
第二個檔案存成 .claude/agents/audit.md,多給 Bash 讓它能看 git 紀錄,並設定在 worktree 裡跑。
---
name: audit
description: Reviews a diff for bugs and missing tests before the task is declared done.
tools: Read, Grep, Glob, Bash
model: haiku
isolation: worktree
---
You review the diff you are given. List concrete problems with file paths
and line numbers. Do not commit or push.
這裡有三個地方容易卡。
isolation: worktree會讓子代理在暫時的 git worktree 裡跑,沒改東西就自動清掉。官方寫明這個 worktree 預設從預設分支(default branch)建立,不是從目前會話的 HEAD 建立。你在工作分支上的改動不會自動出現在裡面,要審的 diff 得寫進委派內容。- 第一次建立
.claude/agents/資料夾後要重開會話。官方說檔案監看只涵蓋會話開始時已經存在的資料夾。 - 欄位名稱打錯不會跳錯誤,Claude Code 會直接忽略。懷疑子代理沒照設定跑,可以打
/tasks看它實際用哪個模型。
內建的 Explore 子代理預設跟主會話用同一個模型。官方文件提到,在專案裡自訂一個叫 Explore 的子代理並設 model: haiku,就能讓探索改用較便宜的模型。
另外,子代理會繼承設定好的顧問,並用自己的模型再做一次配對檢查。照相容表,Haiku 5.5 可以配 Opus 5.5 當顧問,所以 Haiku 子代理也可能去問 Opus。
加入 JEV:第三方決策模型
如果要 Claude Code 把選工具、選路徑、重試這類分叉交給 JEV 來分辨要丟給哪個層級的 Agent 的話,接著往下看。
JEV 官方寫作 Jev,是 TypeSafe AI 在 2026 年 9 月推出的決策模型,和 Anthropic 沒有關係,動區以前有一篇專文介紹。
如果要用 Jev 的話,先到 TypeSafe AI 官網申請帳號,然後複製他的 plugin 在 Claude 裡安裝好,貼上金鑰,以後只要在 CLAUDE.md 加一條規則,Claude Code 需要用到 Jev 的時候就會呼叫了。
附錄:官方文件與參考資源
- advisor 官方文件:三種開法、完整相容表、用量與快取規則
- 模型設定文件:各供應商的別名對照、opusplan 與各模型最低版本
- 子代理文件:frontmatter 全部欄位、worktree 隔離與模型選擇順序
- Claude API 的 advisor 工具文件:不透過 Claude Code、直接在 Messages API 使用 advisor
- The advisor strategy:Anthropic 4 月的官方文章與評測數字
- Claude Code 更新紀錄:advisor 每一版的修正與新增項目
疑難排解
Q1. 開了 advisor,卻一直沒看到 Advising
A:先確認主模型與顧問的配對在相容表內,再確認供應商不是 Bedrock、Agent Platform 或 Foundry。設了 DISABLE_TELEMETRY 這類變數,會話也拿不到功能旗標。顧問只在決策點被呼叫,短任務可能整場都用不到。
Q2. 用 /advisor 換了顧問,卻沒有生效
A:API 在這場對話裡已經拒絕過原本的顧問配對時,新選的顧問要等 /clear 或 /compact 之後才生效,開新會話也可以。
Q3. 能不能讓 Claude 每一步都問 Opus
A:沒有設定可以強制或限制次數,只能在提示裡要求。每一步都需要最強模型的工作,官方建議直接把主模型換成 Opus。
Q4. Haiku 4.5 可以當顧問嗎
A:不行。Haiku 4.5 可以當主模型去呼叫顧問,自己不能當顧問;用 –advisor 指定它,Claude Code 啟動時會跳錯誤。
Q5. 公司走 LLM 閘道(gateway)能用嗎
A:要看閘道會不會把請求完整轉給 Anthropic API。閘道不認得 advisor_20260301 的話,舊版每回合都會回 400 錯誤,v2.1.280 已修正。現在 Claude Code 會改成不帶顧問重送,對話不中斷,但也不會有顧問。
常見問題
Claude Code 的 advisor 顧問模式怎麼開?
會話中打 /advisor opus 會存成預設,也可在設定檔寫 advisorModel,或啟動時加 –advisor opus 只管該場。這個旗標不會列在 claude –help 裡。
Claude Code 開 advisor 會比較省額度嗎?
官方說通常比全程用強模型便宜,但顧問每次都重讀整份對話、不快取。Anthropic 公布的成本降 11.9% 是 API 上 4.6 世代模型的結果。
📍相關報導📍
Claude Code 開放自訂主題 custom-theme:一句話換配色+會動的背景(使用教學)

