模型、Effort 与 Fast Mode

模型配置决定 Claude Code 的能力、速度、成本和缓存命中。接入 Passion8 时,还要确认后台模型名、能力标记、context window、effort 和 fast mode 是否被网关正确支持。

Advisor 这种“主模型咨询强模型”的工作流,以及 Agent View、/goal、Ultraplan 和 Ultrareview 的选择边界,见 高级工作流与云端协作。

#模型选择优先级

恢复旧 session 时,Claude Code 会优先使用 transcript 里保存的模型。只有模型退休、被 allowlist 排除,或本次启动明确指定了 --model / ANTHROPIC_MODEL 时,才会按新的优先级解析。

#常用别名

如果 Passion8 后台使用自定义模型 ID,优先用后台实际展示的 ID。若想让 /model picker 显示网关模型,见 网关与协议。

#opusplan

opusplan 是官方的混合策略:

代价是缓存分裂。进入 plan mode 和退出 plan mode 时,如果实际模型从 Sonnet 切到 Opus 或反过来,下一轮会 miss。长任务里可以这样用:

1. 开局用 opusplan 做计划。
2. 计划确认后进入执行阶段,尽量不要频繁来回切 plan。
3. 如果只想临时问一个高阶判断,优先用 /advisor 而不是切整个会话模型。

#Effort

Effort 控制 adaptive reasoning 的深度。越高通常越慢、越贵,但复杂任务更稳。

设置方式:

claude --effort high

/effort xhigh
/effort auto

也可以在 settings.json 里设置:

{
  "effortLevel": "high"
}

#Fast Mode

Fast Mode 用于让 Opus 更快返回。官方把它描述成速度和成本的权衡,适合你愿意为低延迟付出更高请求成本的场景。

/fast

使用判断:

Fast Mode 与 effort 不等价。Fast Mode 是速度/计费模式;effort 是 reasoning 深度。你可以用较低 effort 快速处理普通任务,也可以用 Fast Mode 加速复杂 Opus 会话。

#Advisor Tool

Advisor 是“主模型继续工作,关键时刻请第二个模型给建议”。它适合不想切整个会话模型,但希望复杂决策有更强模型把关的场景。

/advisor opus
/advisor off

也可以启动时指定:

claude --advisor opus

缓存影响:

#Fallback Model

模型过载或不可用时,可以配置 fallback chain:

claude --fallback-model sonnet,haiku

或写入 settings:

{
  "fallbackModel": ["sonnet", "haiku"]
}

触发 fallback 的那一轮会使用另一个模型,因此也是 cache key 变化。它适合提高可用性,不是节省缓存成本的工具。

#1M Context

官方模型配置支持 opus[1m]、sonnet[1m] 或在完整模型名后追加 [1m] 来请求 1M context。是否可用取决于模型、账号、provider 和网关能力。

在 Passion8 下使用时要检查:

#第三方 Provider 能力声明

Claude Code 会根据模型 ID 判断 effort、thinking、tool search、1M context 等能力。自定义部署名可能不匹配。Provider 专用配置可以用 _SUPPORTED_CAPABILITIES 告诉 Claude Code 这个模型支持什么。

示例:

export ANTHROPIC_DEFAULT_OPUS_MODEL="my-opus-deployment"
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES="effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking"

注意:官方说明这些 capability 变量用于 Bedrock、Vertex、Foundry、Mantle 等 provider 配置。对普通 ANTHROPIC_BASE_URL 网关不一定生效,网关侧更重要的是完整转发 headers 和 body fields。

#Passion8 建议

#官方参考

• Model configuration
• Fast mode
• Advisor tool
• Prompt caching
• Gateway protocol reference