Claude Code 配置多個模型:opusplan、/advisor 顧問與子代理分模型協作怎麼配

在 Claude Code 裏不想全程燒最貴模型的額度,官方原生支持四套多模型分工方案:opusplan 按規劃與執行階段切模型、/advisor 在關鍵拐點請教強模型、子代理按角色單獨綁定 haiku 或 opus,以及用環境變量固定各模型家族的映射版本。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. Claude Code 原生不需要裝第三方插件就能做多模型分工,核心有三條官方路徑:階段切換(opusplan)、中途請教(/advisor)與角色分流(子代理 model 字段)。
  2. opusplan 按「規劃 / 執行」切開:進入計劃模式(Plan Mode)時自動調 opus 做架構設計與方案拆解;退出計劃模式動手改代碼時自動切回 sonnet。
  3. /advisor(顧問工具)適合不想頻繁切換主會話模型的人:主循環一直跑在較省額度的執行模型(如 sonnet)上,只在遇到歧義決策、報錯卡殼或收尾驗收時,向更強的顧問模型(如 opus 或 fable)發一次諮詢。
  4. 子代理預設繼承主會話模型,這是額度消耗快的常見盲區。在 .claude/agents/*.md 頂部加上 model: haiku,或者設環境變量 CLAUDE_CODE_SUBAGENT_MODEL,就能把掃目錄、跑測試這類體力活剝離給輕量模型。
  5. 第三方雲平台或企業統一鎖版本時,可在 settings.json 的 env 裏配置 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL,一次性改寫三個別名的底層指向。

Claude Code 四種多模型分工方式

圖:本站根據 Claude Code 官方文檔:Model configuration 整理的示意圖

本文根據 Claude Code 官方文檔《Model configuration》《Escalate hard decisions with the advisor tool》《Create custom subagents》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 搜「claude code 配置 多 個 模型」「claude code 多模型協作」的人;
  • 全程開 Opus 覺得套餐周限額掉得太快,全切 Sonnet 又擔心複雜架構容易走彎路的人;
  • 想讓主對話、規劃階段、搜尋子代理分別跑在不同檔位模型上的開發者。

如果只是想了解單個模型的切換命令、推理強度(effort)滑塊和 fast 模式,先看 /guides/claude-code-switch-model;本文專門講同一套工作流裏讓多個模型協同分工的官方配置方法。

一、方案一:opusplan 規劃用強模型、寫碼用主力模型

日常開發裏最耗腦力的是「理清改哪幾個文件、邊界怎麼處理」,真正按既定方案改寫函數反倒不需要頂級推理。官方內置的 opusplan 別名專門把這兩步拆給兩個模型:

  • 處於 Plan Mode 時:自動調用 opus 閱讀代碼、分析依賴並輸出修改方案;
  • 批准方案進入正常編碼模式後:自動切到 sonnet 完成具體文件編輯與命令驗證。

你可以直接在當前會話裏啟用,也可以寫進用戶級或項目級設定文件作為預設方案:

json
{
  "model": "opusplan"
}

設定文件的優先級與生效範圍見 /guides/claude-code-settings-json。需要注意一處細節:因為不同模型各自維護獨立的提示詞緩存(Prompt Caching),從 Plan 模式切入執行模式的第一輪請求無法複用前一個模型的緩存,適合「先集中討論清楚方案、再一次性進入執行」的節奏,不適合每隔兩句話就反覆進出 Plan 模式。

二、方案二:/advisor 顧問模式(主會話不換模型,關鍵處請教)

如果你希望整場會話一直保持在同一個執行模型(比如 sonnet)上以維持穩定的提示詞緩存,但又怕它在複雜重構裏自己鑽牛角尖,可以用官方的顧問機制(Advisor)。

開啟方式有三種:

  1. 會話中交互設定:輸入 /advisor opus 或 /advisor fable;
  2. 啟動參數指定:運行 claude --model sonnet --advisor opus;
  3. 寫進 settings.json 持久化:設定 "model": "sonnet" 搭配 "advisorModel": "opus"。

和 opusplan 硬切主模型不同,開啟顧問後,讀寫文件、調工具的主循環始終由執行模型完成;只有當執行模型遇到架構權衡、連續排錯未果或準備交付最終改動前的核驗節點時,才會調用顧問工具把上下文摘要遞給強模型拿指導意見。這樣既保住了主循環的速度與緩存命中率,又能在關鍵岔路口借用高階模型的判斷力。

不同預算與任務怎麼選多模型方案

圖:本站根據 Claude Code 官方文檔:Advisor 與 Subagents 整理的示意圖

三、方案三:給不同子代理(Subagents)分配不同模型

官方文檔明確提醒:自定義子代理如果沒有寫 model 字段,預設是 inherit(跟隨主會話模型)。也就是說,當你把主會話切到 opus 後派三個子代理去翻日誌、跑單測,這三個子代理也會全部按 opus 扣額度。

想按職責拆分模型,可以在 .claude/agents/ 下的子代理定義文件裏顯式聲明 model(支持 haiku、sonnet、opus 或 inherit)。例如建一個專門負責全局搜尋代碼引用與跑測試的輕量角色:

markdown
---
name: fast-explorer
description: 掃描目錄結構、查找函數引用與運行測試命令並彙總報錯
tools: Read, Grep, Glob, Bash
model: haiku
---

只負責檢索定位與執行只讀驗證命令,返回精確的文件路徑、行號與失敗摘要,不要修改業務源碼。

更多現成角色寫法見 /guides/claude-code-subagents 和 /guides/claude-code-custom-subagent-test-runner-debugger-examples。

如果你不想逐個修改子代理文件,想一鍵把後台派出的子代理統一指定為某個模型,可以在 ~/.claude/settings.json 的環境變量塊裏設定 CLAUDE_CODE_SUBAGENT_MODEL:

json
{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "sonnet"
  }
}

四、方案四:用家族預設環境變量統一替換底層版本號

在接入 Amazon Bedrock、Google Vertex AI、Microsoft Foundry,或者團隊需要把 opusplan、子代理和後台標題生成統一鎖死在指定代數時,可以在 settings.json 的 env 裏配置以下三個官方環境變量:

  • ANTHROPIC_DEFAULT_OPUS_MODEL:改寫 opus 別名,以及 opusplan 在規劃階段實際調用的模型 ID;
  • ANTHROPIC_DEFAULT_SONNET_MODEL:改寫 sonnet 別名,以及 opusplan 在執行階段調用的模型 ID;
  • ANTHROPIC_DEFAULT_HAIKU_MODEL:改寫 haiku 別名,同時決定會話標題生成等後台輕量輔助任務調用的小模型。

這樣配置後,團隊倉庫裏的子代理依然只需要寫 model: haiku 或 model: sonnet,不用在每個 Markdown 文件裏硬編碼一長串帶日期的模型標識。若日常多項目高強度並行仍頻繁觸及 Pro 套餐限額,也可以在 /chongzhi/claude-max 查看更高額度檔位的訂閱方式說明。

常見問題

Q:能在 Claude Code 原生設定裏直接混搭非 Claude 家族的模型(如 Gemini 或本地 Ollama)嗎?

Claude Code 原生設定(/model、opusplan、子代理 model)面向的是 Anthropic 模型協議及對應的雲託管版本。如果想在本地通過協議轉換把不同任務轉發給其他廠商的官方 API,需要藉助開源路由工具,具體配法見下一篇教學。

Q:opusplan 和 /advisor 可以同時開嗎?

兩者解決的是同一個「規劃強、執行省」的問題,一般二選一即可:習慣手動按 Shift+Tab 進 Plan 模式先審方案的人選 opusplan;習慣直接提需求讓 Claude 邊探邊改的人選 sonnet 配 /advisor opus。

Q:怎麼確認子代理和後台任務到底走了哪個模型?

在會話裏運行 /status 可以核對當前主模型與顧問設定;排查單次會話裏各模型的消耗佔比時,用 API 計費的用戶可運行 /cost 查看按模型拆分的用量明細。

相關教學

參考資料

  • Claude Code 官方文檔:Model configuration — https://code.claude.com/docs/en/model-config
  • Claude Code 官方文檔:Escalate hard decisions with the advisor tool — https://code.claude.com/docs/en/advisor
  • Claude Code 官方文檔:Create custom subagents — https://code.claude.com/docs/en/sub-agents

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~