昨天我在 X 上分享了一篇文章[1],展示了 multi-agent 系统里用 Claude Opus 4.6 主 agent 搭配 Claude Opus 5.5 subagent,是怎么引发经典的混淆代理人(Confused Deputy)问题的。评论区有读者问到了一个很实际的点。如果 Claude Code 的主 session 跑在 Opus 4.6 上,该怎么生成 Opus 5.5 subagent?想在 prompt 里让主 agent 临时生成 claude-opus-5-5,直接就会碰壁。Anthropic 收紧了 Claude Code 里 Agent 工具和 context forking 的模型选择规则。目前,要在 Opus 4.6 主 agent 下运行 Opus 5.5 subagent,唯一可靠的做法是在 .claude/agents/ 下定义自定义 subagent,把 model 字段固定为 Model ID claude-opus-5-5。
1Model Name、Model Alias 和 Model ID
Claude Code 文档区分了开发者常混用的三个术语:
术语
用途
示例
可用于 model 配置?
Model Name
供人阅读的产品名称,用于菜单和文档展示。
Claude Opus 5.5、Claude Opus 4.6
不能
Model Alias
动态简写,会自动解析为对应档位的最新默认版本。
opus、sonnet、haiku、fable
可以(跟随最新版本)
Model ID
不可变的后端标识符,锁定到具体的模型快照。
claude-opus-5-5、claude-opus-4-6
可以(用于 session flags 和 subagent frontmatter)
Model Name 只是给人看的。配置文件和 CLI 参数都不接受 Claude Opus 5.5,因为 API 要求传入机器可读的标识符。
Model Alias 的指向是浮动的。Claude Code 把哪一代 Opus 设为默认,opus 就会解析到哪一代,所以单靠一个 alias 没法同时锁定同一家族的两代模型。
Model ID 则能锁定特定的一代模型。给主 session 传入 claude-opus-4-6,给自定义 subagent 传入 claude-opus-5-5,就能把每一层固定在具体的模型快照上。
2唯一可行的方案是预先定义 custom subagent
Claude Code 把自定义 subagent 保存为带 YAML frontmatter 的 Markdown 文件,放在 .claude/agents/ 下对单个仓库生效,放在 ~/.claude/agents/ 下则对所有项目生效。和临时调用 Agent 工具不同,subagent frontmatter 里的 model 字段支持直接填写完整的 Model ID。
2.1第一步,定义 opus-55 subagent
新建 .claude/agents/opus-55.md(或 ~/.claude/agents/opus-55.md),把 model 设为 claude-opus-5-5:
markdown1---2name: opus-553description: Specialized Claude Opus 5.5 worker for deep technical analysis and implementation tasks.4model: claude-opus-5-55---67You are a focused technical specialist running in an isolated subagent context.8Complete the delegated engineering or analysis task and return a clear, structured result to the main agent.
name 字段用来注册具名 subagent 类型。有了具名 agent,主 session 就能绕过通用的 context forking,直接把任务派发给 opus-55。
model 字段用来锁定具体的 Model ID。每次 opus-55 启动,model: claude-opus-5-5 都会覆盖父 session 的 claude-opus-4-6 模型。
早期版本的 Claude Code 允许内置 Agent 工具在运行时自由切换模型。到了现在,无论是用环境变量覆盖模型 alias,还是其他不新建文件的变通方案,Claude Code 要么直接拦截,要么一律路由回主 agent 的 Opus 模型,在我们的例子中是 Opus 4.6:Claude Code Subagent 模型路由(v2.1.325 实测)
通过 prompt 让 Agent 工具传裸 Model ID 会直接失败。Claude Code 限制了内置 Agent 工具单次调用的 model 参数,会在运行时拦下调用方 LLM,禁止传入 claude-opus-5-5 这类带版本号的 Model ID。
靠环境变量固定 opus alias 也行不通。一种看似很巧的绕法是先带上 ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" 启动 Claude Code(哪怕同时配上 CLAUDE_CODE_SUBAGENT_MODEL="claude-opus-5-5" 和 CLAUDE_CODE_FORK_SUBAGENT=0),接着把主 session 切到 /model claude-opus-4-6,再让 Agent 工具生成 opus subagent。
内置 subagents 依然会继承 Opus 4.6。在 Claude Code v2.1.325 上,让 Agent 工具生成 opus subagent 会派发给 @general-purpose,实际跑在 Opus 4.6(Agent(...) Opus 4.6)上,直接无视 opus alias 的覆盖设置。