API 教程 · 2026-08-22

会话中途增删工具
不炸 prompt cache 的那种

Anthropic 的 mid-conversation tool changes(beta)让 Claude 在长任务里动态装卸工具集——07-24 随 Opus 5 发布,Opus 4.8 / Fable 5 / Mythos 5 同步支持。

#mid-conversation-tool-changes#beta header#prompt cache#tool_use

要点

2026-07-24

发布日

随 Claude Opus 5 一同发布的两个 beta 之一,官方公告可查。

4 个

支持的模型

Opus 5、Opus 4.8、Fable 5、Mythos 5。其它型号暂无。

tool_addition

核心机制(+ 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 块,症状是「模型假装没看到新工具」——遇到先查链路转发。

时间线

2026-04-07

相近但不同的 beta:mid-conversation system 消息(别混淆,header 不一样)。

2026-07-24

mid-conversation tool changes 随 Opus 5 发布,header mid-conversation-tool-changes-2026-07-01。

2026-08

主流 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。

长任务的成本,从缓存开始省

QCode 透传 anthropic-beta 头,四款支持的模型同 key 可调。