结论先说
- Claude Code 原生不需要装第三方插件就能做多模型分工,核心有三条官方路径:阶段切换(
opusplan)、中途请教(/advisor)与角色分流(子代理model字段)。 opusplan按「规划 / 执行」切开:进入计划模式(Plan Mode)时自动调opus做架构设计与方案拆解;退出计划模式动手改代码时自动切回sonnet。/advisor(顾问工具)适合不想频繁切换主会话模型的人:主循环一直跑在较省额度的执行模型(如sonnet)上,只在遇到歧义决策、报错卡壳或收尾验收时,向更强的顾问模型(如opus或fable)发一次咨询。- 子代理默认继承主会话模型,这是额度消耗快的常见盲区。在
.claude/agents/*.md顶部加上model: haiku,或者设环境变量CLAUDE_CODE_SUBAGENT_MODEL,就能把扫目录、跑测试这类体力活剥离给轻量模型。 - 第三方云平台或企业统一锁版本时,可在
settings.json的env里配置ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL和ANTHROPIC_DEFAULT_HAIKU_MODEL,一次性改写三个别名的底层指向。

图:本站根据 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)。
开启方式有三种:
- 会话中交互设置:输入
/advisor opus或/advisor fable; - 启动参数指定:运行
claude --model sonnet --advisor opus; - 写进
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 查看按模型拆分的用量明细。
相关教程
- /guides/claude-code-switch-model:Claude Code 切换模型、推理强度与 fast 模式
- /guides/claude-code-subagents:Claude Code 子代理创建与调用指南
- /guides/claude-code-custom-subagent-test-runner-debugger-examples:自定义子代理实战模板
- /guides/claude-code-settings-json:
settings.json层级与环境变量配置
参考资料
- 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
0 条评论
还没有评论,来抢沙发~