Claude Code 用 opusplan 规划、Sonnet 4.6 执行的固定配置

一句话结论

把 Claude Code 设成 opusplan，规划用 Opus、落地用 Sonnet，并把 ANTHROPIC_DEFAULT_SONNET_MODEL 钉死为 claude-sonnet-4-6，才能避免 sonnet 别名在不同云平台解析成 Sonnet 5 或 4.5。

适用场景

• 适合的任务：日常编码、长会话实现、需要控制周额度的 Claude Code 工作；规划/架构用更强模型、执行用 Sonnet 4.6。

• 不适合的任务：整段会话都必须用同一模型；需要 1M 上下文却未开通 extra-usage；把别名 sonnet 当作永远等于 4.6。

• 适用的模型版本：要固定使用 Claude Sonnet 4.6 时，应写完整 ID claude-sonnet-4-6，不要只写 sonnet。

• 适用的客户端、Agent 或 API：Claude Code CLI；Anthropic API、Claude Platform on AWS、Bedrock、Vertex、Foundry 的别名解析不同。

• 推荐的推理档位和参数：日常执行用 Sonnet 4.6；规划阶段走 Opus。官方 sonnet 别名在 Anthropic API 上已解析为 Sonnet 5，在 AWS Claude Platform 上仍解析为 Sonnet 4.6。

可直接使用的内容

会话内切换到“规划用 Opus、执行用 Sonnet”：

/model opusplan

把 Sonnet 4.6 钉死为执行模型（以及可选地把 Opus 钉到 1M 窗口）写入 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

只想在当前项目使用 Sonnet 4.6、不跟随最新 sonnet 别名时，也可在启动时显式指定：

claude --model claude-sonnet-4-6

官方别名表中与本配置直接相关的条目：

测试/工作流步骤

1. 运行 /model 或检查当前会话模型，确认执行阶段实际 ID 是 claude-sonnet-4-6，而不是 sonnet 别名解析出的 Sonnet 5 / 4.5。

2. 用同一仓库分别跑 /model opusplan 与全程 /model claude-sonnet-4-6，记录周额度消耗、规划质量和落地 diff。

3. 若需要 1M 窗口，先确认套餐是否要求 /extra-usage；Max 5x 上可能返回 Extra usage is required for 1M context。

4. 固定 Claude Code 版本后再比较：官方写明 sonnet/opus 别名会随 CLI 版本和提供商变化。

原始证据与数据

• 官方文档把 opusplan 定义为：Plan 模式使用 opus，然后切换到 sonnet 执行。

• 官方提供商别名表：Anthropic API 上 sonnet → Sonnet 5；Claude Platform on AWS 上 sonnet → Sonnet 4.6；Bedrock / Agent Platform / Foundry 上 sonnet → Sonnet 4.5。

• 官方说明：别名解析到较旧模型时，可用完整模型名或 ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL 覆盖。

• 社区在 r/ClaudeCode 的配置讨论中给出了与官方环境变量一致的 settings.json 写法，并指向同一篇 model-config 文档；该配置用于解决 /opusplan 掉回 200k 窗口的问题。

适用边界

• opusplan 里的 sonnet 仍受提供商别名解析影响；不设置 ANTHROPIC_DEFAULT_SONNET_MODEL 就不能保证执行模型是 4.6。

• [1m] 不是免费能力：官方与社区都记录 1M 上下文可能触发 extra-usage。

• 本页是模型选择与窗口配置，不是可复制的任务提示词。

• 别名会随 CLI 版本更新；采集时文档已提到 Fable 5、Sonnet 5。要复现 4.6 行为必须钉 ID。

来源摘录或观察（仅做合规短引）

官方对 opusplan 的定义是：special mode that uses opus during plan mode, then switches to sonnet for execution（合规短引）。