Claude Code 本周连发 2.1.160–2.1.166:fallback 模型、ultracode 与跨会话安全加固
本期聚焦一条对每天用 Claude Code 的人都直接相关的更新:2026 年 6 月头一周,Claude Code 从 2.1.160 一路连发到 2.1.166。其中最值得配置的是 fallbackModel 自动切换——主模型过载时自动切到备用模型,再也不用盯着 529 报错手动重试。
用 Claude Code 写代码写到一半,突然卡在"上游过载、请稍后重试"——这是高峰期几乎每个重度用户都遇到过的场景。过去只能手动等、手动换模型。本周的 2.1.166 把这件事自动化了:配置好 fallback 链,主模型不可用时 CLI 自己切到下一个。
这一周的版本更新还顺手做了几件事:把动态工作流的触发词从 workflow 改名为 ultracode、给 deny 权限规则加了通配符、加固了多会话之间的消息安全。下面逐版本讲清楚,并给出国内开发者最该先配的那一项。
说明:以下版本发布日期以 Releasebot 首次抓取时间为准(Claude Code 更新流),Anthropic 官方 changelog 未逐版标注精确日期。
一、最值得配置的:2.1.166 的 fallbackModel
版本:2.1.166(约 2026-06-06)
2.1.166 引入了 fallbackModel 设置,核心能力是:
- 可配置最多 3 个备用模型,按顺序尝试
- 当主模型过载或不可用时,自动切到下一个
--fallback-model现在在交互式会话里也生效(此前主要用于非交互场景)
这对体感的改善很直接:高峰期主模型排队时,与其干等,不如让 Opus 4.8 顶不上时自动降到 Sonnet 4.6 继续干活,任务不中断。
对开发者的影响:
- 重度用户的"过载等待"时间显著减少
- 可以做"质量优先、可用性兜底"的分层:主用最强模型,备用换更稳的次级模型
- 配合国内中转线路,能进一步把高峰期的可用性拉满
怎么配 fallback 多模型链
先把 Claude Code 指向国内可直连的接入点。API Key 在 claudeapi.com 注册获取,支持支付宝/微信充值。
环境变量配置(macOS / Linux):
export ANTHROPIC_API_KEY="sk-你的ClaudeAPI密钥"
export ANTHROPIC_BASE_URL="https://gw.claudeapi.com"
export ANTHROPIC_API_KEY="sk-你的ClaudeAPI密钥"
export ANTHROPIC_BASE_URL="https://gw.claudeapi.com"
PowerShell(Windows):
$env:ANTHROPIC_API_KEY = "sk-你的ClaudeAPI密钥"
$env:ANTHROPIC_BASE_URL = "https://gw.claudeapi.com"
$env:ANTHROPIC_API_KEY = "sk-你的ClaudeAPI密钥"
$env:ANTHROPIC_BASE_URL = "https://gw.claudeapi.com"
在 settings.json 里配置主模型 + fallback 链:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的ClaudeAPI密钥",
"ANTHROPIC_BASE_URL": "https://gw.claudeapi.com",
"ANTHROPIC_MODEL": "claude-opus-4-8"
},
"fallbackModel": [
"claude-sonnet-4-6",
"claude-haiku-4-5-20251001"
]
}
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的ClaudeAPI密钥",
"ANTHROPIC_BASE_URL": "https://gw.claudeapi.com",
"ANTHROPIC_MODEL": "claude-opus-4-8"
},
"fallbackModel": [
"claude-sonnet-4-6",
"claude-haiku-4-5-20251001"
]
}
这样配置后:主用 Opus 4.8,过载时自动切 Sonnet 4.6,再不行降到 Haiku 4.5——任务尽量不断。也可以临时用命令行指定:
claude --fallback-model claude-sonnet-4-6
claude --fallback-model claude-sonnet-4-6
二、ultracode:动态工作流的触发词改名了
版本:2.1.160(约 2026-06-02)
如果你之前在 Claude Code 里靠输入 workflow 触发动态工作流(Dynamic Workflows,让模型自动拆分任务、并行调度子 Agent),注意这个触发词已经改名为 ultracode:
workflow这个词不再触发工作流(避免误触发)- 新触发词
ultracode在输入框里以紫色高亮显示 - 通过
/effort ultracode进入:把 effort 等级设为 xhigh,并让 Claude 自动决定何时为复杂任务启动动态工作流
需要厘清一个常见误解:ultracode 不是新模型,它是 Claude Code 里的一个会话级设置,作用是"高 effort + 自动编排"。同期还修了一个相关 bug——当模型不支持 xhigh 时,/effort ultracode 不再错误地甩锅给动态工作流设置,且不再在不支持的模型上提供该选项。
三、其余版本逐条看
这一周中间几个版本也有实用改动:
| 版本 | 日期(首次抓取) | 关键改动 |
|---|---|---|
| 2.1.166 | 06-06 | fallbackModel;deny 规则通配符;SendMessage 跨会话安全加固;MAX_THINKING_TOKENS=0 可关闭默认思考 |
| 2.1.165 | 06-05 | Bug 修复与稳定性改进 |
| 2.1.163 | 06-05 | /plugin list 列插件(支持 --enabled/--disabled);Stop/SubagentStop hook 可返回 additionalContext;新增版本守护 requiredMinimumVersion/requiredMaximumVersion |
| 2.1.162 | 06-04 | Agent、后台、启动相关打磨;JSON waitingFor 状态 |
| 2.1.161 | 06-03 | OTEL_RESOURCE_ATTRIBUTES 指标标签;并行工具处理改进;Linux 剪贴板/终端渲染修复 |
| 2.1.160 | 06-02 | ultracode 触发词改名;写入 shell 启动文件前增加安全提示 |
几个值得展开的点:
deny 规则支持通配符(2.1.166):deny 权限规则的工具名位置现在支持 glob,"*" 可一次性禁用所有工具;allow 规则会拒绝非 MCP 的通配符;deny 规则里写了未知工具名会在启动时告警。批量收紧权限更方便了。
SendMessage 跨会话安全加固(2.1.166):转发的消息不再携带用户权限,接收方会拒绝被转发的权限请求,auto 模式直接拦截。多会话/多 Agent 协作场景下的越权风险被堵上。
hook 反馈不再算错误(2.1.163):Stop 和 SubagentStop 钩子可以通过 hookSpecificOutput.additionalContext 返回反馈,而不会被标记为 hook 错误——写自动化钩子的体验更顺。
四、几个值得注意的点
第一,先升级再配。 fallbackModel 需要 2.1.166 及以上;动态工作流(ultracode)需要 2.1.154 及以上。用 claude --version 确认当前版本,低了先升级。
第二,fallback 不是免费保险。 备用模型一旦顶上,按对应模型计费。把更便宜的 Sonnet 4.6 / Haiku 4.5 放进 fallback 链,既兜底可用性,又不会在降级时产生意外高成本。
第三,ultracode 是会话级设置。 它不跨会话保留,每次需要时通过 /effort ultracode 开启;且只在支持 xhigh 的模型上可用。
第四,模型分层思路。 fallback 链建议按"质量递减、可用性递增"排列:
| 角色 | 推荐模型 | 原因 |
|---|---|---|
| 主模型 | claude-opus-4-8 |
最强推理,复杂代码与架构首选 |
| 一级备用 | claude-sonnet-4-6 |
全能旗舰,质量与成本平衡 |
| 末级兜底 | claude-haiku-4-5-20251001 |
极速轻量,保证任务不中断 |
小结
- 本周 Claude Code 从 2.1.160 连发到 2.1.166,最该配的是 fallbackModel:主模型过载自动切备用,最多 3 个、按序尝试
- ultracode 取代
workflow成为动态工作流触发词,本质是"xhigh effort + 自动编排"的会话级设置,不是新模型 - 2.1.166 还加固了 deny 规则通配符与 SendMessage 跨会话安全;2.1.163 改善了插件列举与 hook 反馈
- 升级到 2.1.166 后,把 Opus 4.8 → Sonnet 4.6 → Haiku 4.5 配成 fallback 链,高峰期可用性最稳
国内开发者可通过 claudeapi.com 接入 Opus 4.8/4.7、Sonnet 4.6、Haiku 4.5 全系模型,国内直连、支付宝/微信结算、按量计费,把上面的 fallback 链直接配进 settings.json 即可生效。



