在 Claude Code 中固定选择 Opus 5.5 并设置 effort

一句话结论

Claude Code v2.1.280 及以上可通过 opus 别名或固定模型名选择 Opus 5.5，并用 /effort、启动参数或设置文件调整推理档位。

适用场景

• 适合的任务：在 Claude Code 会话中选择 Opus 5.5；为编码、规划等不同复杂度任务配置 effort；避免别名随 provider 或版本变化而切换到其他模型。

• 不适合的任务：把以下命令和配置直接用于 Anthropic Messages API 请求；API 请求应按 API 文档使用模型 ID 和 output_config.effort。

• 适用的模型版本：Claude Opus 5.5；官方要求 Claude Code v2.1.280 或更新版本。

• 适用的客户端、Agent 或 API：Claude Code CLI 和其模型设置。provider 会影响别名映射及可用模型；Microsoft Foundry 的 opus 目前映射为 Opus 4.6。

• 推荐的推理档位和参数：Opus 5.5 默认 medium。按任务在 low、medium、high、xhigh、max 中评估；设置文件的 modelSettings 支持 low、medium、high、xhigh，不接受 max。

可直接使用的内容

在 Claude Code 会话中选择 Opus 别名（直接输入会保存为后续会话默认值）：

/model opus

若要锁定 Opus 5.5，不依赖别名以后如何更新，可指定完整模型名：

claude --model claude-opus-5-5

启动时指定 effort：

claude --model claude-opus-5-5 --effort high

在当前会话设置 effort，或清除已保存档位并恢复模型默认值：

/effort high
/effort auto

也可以运行 /effort 打开档位滑块，或在 /model 选择模型时用左右方向键调整 effort。

测试或工作流步骤

1. 确认 Claude Code 版本至少为 v2.1.280；旧版本执行 claude update 后重启。

2. 运行 /model 查看当前可用模型。选择 opus 可使用 provider 当前映射的 Opus；若必须使用 Opus 5.5，选择完整模型名 claude-opus-5-5。直接输入命令会保存为后续会话默认值；若只切换当前会话，在模型选择器中按 s。

3. 运行 /effort，从默认 medium 开始；对代表性任务比较 low、high 或其他可用档位。

4. 如需固定启动会话，使用 claude --model claude-opus-5-5 --effort high。命令行 --model 和 --effort 仅作用于该次启动的会话。

5. 复核会话实际选中的模型和档位，并记录 Claude Code 版本、provider、任务、effort 与结果。

原始证据与数据

• 官方文档说明 Claude Code 可通过会话内 /model <alias|name>、启动参数 claude --model <alias|name>、环境变量 ANTHROPIC_MODEL、设置文件中的 model，或 ANTHROPIC_DEFAULT_MODEL 设置模型。

• 文档列出 provider 对 opus 的映射：Anthropic API、Claude Platform on AWS、Amazon Bedrock 和 Google Cloud Agent Platform 为 Opus 5.5；Microsoft Foundry 为 Opus 4.6。映射会随版本变化。

• 官方明确要求 Opus 5.5 使用 Claude Code v2.1.280 或更新版本；完整模型名示例为 claude-opus-5-5。

• Opus 5.5 支持 low、medium、high、xhigh、max effort，默认 medium。低档更快且成本更低，高档为复杂任务提供更深推理；该描述是官方说明，不是本采集者的独立测量。

• CLAUDE_CODE_EFFORT_LEVEL 可设档位名或 auto。modelSettings 可为模型设置档位，但键值只接受 low、medium、high、xhigh；max 不可用于该设置键。

• Opus 5.5 不读取旧式用户级顶层 effortLevel 默认值；可通过 /effort 或 /model 为 Opus 5.5 选择档位。项目、local、managed 设置中的顶层 effortLevel 或 --settings 传入的该设置仍可应用到所有模型。

适用边界

• opus 是会更新的 provider 别名。若 provider 映射为旧模型，官方建议使用完整模型名或对应的 ANTHROPIC_DEFAULT_OPUS_MODEL 固定版本；不可假定每个 provider 的 opus 都是 Opus 5.5。

• Microsoft Foundry 当前映射为 Opus 4.6，因此选择 opus 不会在那里得到 Opus 5.5。实际能否使用完整模型名还取决于 provider 是否提供该模型。

• 命令中的 claude-opus-5-5 是 Claude Code 接受的完整模型名；Anthropic Messages API 配置、API 模型 ID、参数结构和努力档位配置应以 API 文档为准。

• effort 影响推理深度、速度和成本。官方页面没有为每种任务提供可通用外推的质量或成本测量值，应在自己的任务集上比较。

复现说明

记录 claude --version、登录方式或 provider、完整模型名、effort、任务输入和完成结果。分别测试 /model opus 与 /model claude-opus-5-5，确认实际解析模型；从 medium 开始，对同一任务集更改 effort，比较正确率、耗时和用量。别名解析、模型可用性和设置优先级可能随 Claude Code 版本、provider 与组织策略变化；复现时应重新核对官方页面。