Anthropic Python SDK 1.9.0：claude-sonnet-5-5、between_tools 思考、缓存诊断 GA，流式期间可并行跑工具

核心背景与行业痛点

Agent 编排越来越依赖 Anthropic 官方 Python 客户端：既要跟上新模型 ID，又要在多轮工具调用里控制思考块策略，还要在 prompt cache 场景拿到可观测诊断。痛点集中在三处：Sonnet 新档位未进类型面导致硬编码字符串；工具间隙思考缺少 between_tools 枚举；缓存命中/未命中只能靠侧信道猜，流式回复又常被迫串行等工具跑完。

架构亮点与底层机制

v1.9.0 将 claude-sonnet-5-5 写入模型类型，并新增 between_tools thinking；在 fallback hop 上该类型会降级为 disabled，避免不兼容路径硬崩（#952）。缓存诊断升至 GA：diagnostics 可挂在 Message / MessageCreateParams，且 stream() / parse() 正式接纳（#929）。工具运行器支持在 assistant reply 仍在流式输出时可选执行 tool calls，压缩往返。Managed Agents 事件列表过滤器补齐 typed event values；工作区限速增加 include_inherited 与 source。未命名文件上传不再发送占位文件名。

权威 Benchmark 与实测跑分对比

发行说明未公布 SWE-bench 或 TTFT 对比表。工程信号来自相对 v1.8.0 的 31 commits / 266 files 变更面。请在自有链路验证：between_tools 在多工具轮次是否按预期插入思考；diagnostics 字段是否进入日志管线；流式期间并行工具是否缩短端到端延迟。勿把 changelog 规模外推为线上吞吐基准。

开发者实战落地与开箱指南

升级：pip install -U "anthropic>=1.9.0"（要求 Python≥3.10）。新会话可直接传 model="claude-sonnet-5-5"；需要工具间隙思考时配置 between_tools；开启 diagnostics 后从 Message 响应读取缓存命中细节。流式 agent 若要边回边跑工具，按发行说明启用对应 tool-runner 选项。文档见 Python SDK 与 API；完整清单见 Release v1.9.0。