会话中途增删工具
不炸 prompt cache 的那种
Anthropic 的 mid-conversation tool changes(beta)让 Claude 在长任务里动态装卸工具集——07-24 随 Opus 5 发布,Opus 4.8 / Fable 5 / Mythos 5 同步支持。
要点
发布日
随 Claude Opus 5 一同发布的两个 beta 之一,官方公告可查。
支持的模型
Opus 5、Opus 4.8、Fable 5、Mythos 5。其它型号暂无。
核心机制(+ removal)
用 tool_addition / tool_removal 块在会话中途增删工具,无需重开会话。
对 prompt cache 的影响
官方设计目标就是增删工具不清空已缓存前缀——长任务的成本关键。
这个功能解决什么
长程 agent 的老大难:任务开始时挂 50 个工具,后面每轮都为它们付 token、还稀释注意力;或者干到一半需要新工具,只能重开会话、丢掉全部上下文。mid-conversation tool changes 允许在会话进行中用 tool_addition / tool_removal 块动态装卸工具集,上下文与 prompt cache 都保住。
生态落地情况
OpenRouter 的 Opus 5 迁移指南、Vercel AI SDK 文档均已收录该 beta;openclaw 等 agent 框架在 7 月底就跟进支持。中转网关场景有个已知坑:部分网关会丢 beta header 或剥离 tool_addition 块,症状是「模型假装没看到新工具」——遇到先查链路转发。
时间线
相近但不同的 beta:mid-conversation system 消息(别混淆,header 不一样)。
mid-conversation tool changes 随 Opus 5 发布,header mid-conversation-tool-changes-2026-07-01。
主流 SDK 与网关完成适配;中转转发问题在多个 GitHub issue 被记录。
已确认 vs 易混淆
已确认
beta header 名称、支持的四款模型、tool_addition/tool_removal 机制、不使 prompt cache 失效——均见官方公告与主流 SDK 文档。
易混淆
别和 04-07 的 mid-conversation system(会话中途插入 system 消息)搞混:两者是独立 beta,header 不同、解决的问题不同。转发链路上两个 header 都要确认被透传。
用不用这个 beta
适合
长程 agent、工具集随阶段变化、对 prompt cache 成本敏感的任务——典型如多阶段迁移、分模块重构。
不必
工具集固定、会话短的场景。多一个 beta header 多一层链路不确定性,简单任务别硬上。
怎么用
请求头加 anthropic-beta: mid-conversation-tool-changes-2026-07-01;会话中用 tool_addition 块挂新工具、tool_removal 块卸工具。模型是 Opus 5 / 4.8 / Fable 5 / Mythos 5 之一即可。经网关转发时确认 header 与新增块都被透传。
在 QCode 上
QCode 的 Claude 系列路由透传 anthropic-beta 头,上述四款模型均按官方价乘服务费率在售。接入方式与直连一致:同一把 key,同一个端点,header 照常携带。
常见问题
beta header 是什么?
anthropic-beta: mid-conversation-tool-changes-2026-07-01。请求头带上即启用。
哪些模型支持?
Opus 5、Opus 4.8、Fable 5、Mythos 5。其它型号暂不支持。
会不会把 prompt cache 搞失效?
不会——这正是该功能的设计目标:增删工具不清空已缓存前缀。若发现 cache 命中率骤降,先查中转链路是否改写了请求体。
和 mid-conversation system 是一回事吗?
不是。那是 04-07 的另一个 beta(会话中途插 system 消息),header 为 mid-conversation-system-2026-04-07,解决的问题不同。
网关转发后模型看不到新工具怎么办?
典型症状对应已知坑:部分网关丢 beta header 或剥离 tool_addition 块。先用 curl 直连复现,再逐段排查转发链。
生产环境能用 beta 吗?
官方 beta 的稳定性通常可用于生产,但建议在非关键路径先验证,并盯住 changelog 里的转正/变更通知。
信息来源
Anthropic 官方公告(2026-07-24,Claude Opus 5)、OpenRouter Opus 5 迁移指南、Vercel AI SDK 文档、openclaw GitHub issue。
相关阅读
与 Anthropic 无隶属。beta 功能以官方文档为准。