Claude Code主模型设为Opus 4.6时调用Opus 5子Agent的方式

个人体验发现 Opus 4.6 的写作能力和文风是目前 A÷ 系列模型里最好的，AI 味相对较少，对话中很少不说人话。Opus 4.7 之后的模型却做不到（Opus 4.5 本来更好，但已被官方停用）。所以我设置了 Claude Code 的主会话默认模型为 Opus 4.6，需要更强推理和编程能力时再派 Opus 5 子 Agent 去干活或者拓展思考。

但新版 CC 调用子 Agent 的工具限制 model 参数只接受别名枚举（sonnet/opus/haiku/fable），不接受完整 model ID。主会话是 Opus 4.6 时，model:"opus" 解析出来的还是 Opus 4.6，无法切换到 Opus 5。

绕过方法为用 .claude/agents/ 自定义 Agent 定义文件。比如在 .claude/agents/opus5.md 里写为：

---

name: opus5

description: General-purpose agent pinned to Claude Opus 5

model: claude-opus-5

---



You are a general-purpose agent powered by Claude Opus. Execute the task given in the prompt thoroughly and precisely. Return results directly — no preamble, no trailing summary.

frontmatter 的 model 字段支持完整 model ID，不受别名枚举限制。文件建好后重启 CC 生效。

然后可以在 CLAUDE.md 里加一段，让主会话模型知道怎么用：

## 子 Agent 模型切换



- Agent 工具的 `model` 参数只支持别名（sonnet/opus/haiku/fable），无法区分同系列版本（如 Opus 4.6 vs 5）

- 需要指定模型版本时，用 `.claude/agents/` 下的自定义 Agent 定义文件，通过 `subagent_type` 调用

- 当前可用：`subagent_type:"opus5"` → Claude Opus 5

验证方式：查本地 JSONL 日志（subagents/*.jsonl），API 响应里 message.model 字段返回 claude-opus-5（服务端返回）。

附：CC 自己总结的三种子 Agent 模型指定方式对比

注意不要在 .claude/settings.json 里设置 CLAUDE_CODE_SUBAGENT_MODEL 环境变量，它会覆盖所有子 Agent 的模型选择，导致无法按需切换。