Claude Code 调用 Opus 5 子模型受限？自定义 Agent 配置可实现精准切换

近日，有开发者在测试 Anthropic 推出的 AI 编程工具 Claude Code 时发现了一个关于模型调用的细节问题。由于认为 Opus 4.6 模型在写作能力和自然语言表达风格上优于后续版本，且“AI 味”较少，该用户尝试将 Claude Code 的主会话模型锁定为 Opus 4.6，仅在需要高强度推理或编程任务时调用最新的 Opus 5 子 Agent 协同工作。然而，在配置过程中遇到了工具限制：新版 Claude Code 的 Agent 调用工具中的 `model` 参数仅支持别名枚举（如 sonnet、opus、haiku 等），不支持直接输入完整的模型 ID。这导致当主模型为 Opus 4.6 时，调用 `model:”opus”` 会继续沿用旧版本，无法切换至 Opus 5。经过探索，该开发者通过创建自定义 Agent 定义文件成功绕过了这一限制。具体方法是在 `.claude/agents/` 目录下创建 Markdown 文件（如 opus5.md），并在 Frontmatter 的 `model` 字段中填入完整的模型 ID（如 `claude-opus-5`）。通过这种方式，系统会绕过别名枚举检查，直接调用指定版本的模型。测试表明，本地 JSONL 日志中 API 响应的 `message.model` 字段确认为 `claude-opus-5`。此外，分析还指出了三种子 Agent 模型指定方式的优先级：环境变量最高（但不推荐，会覆盖所有设置）、自定义 Agent 文件次之、工具参数最低。开发者需注意避免在 settings.json 中错误配置环境变量，以免失去模型切换的灵活性。

事件分析

💡 核心观点：通过自定义 Agent 配置绕过版本限制，证明了 AI 开发工具正从单一模型调用向精细化“混合编排”演进。