Anthropic 这次把 Claude Python SDK 推到 v1.0，不是一次例行小版本晋升。HTTP 层从 httpx 整体迁移到 API 兼容的 httpx2，同时砍掉 Text Completions API 和一批长期挂着“deprecated”标签的参数。对维护旧代码的人来说，v1.0 意味着你必须动手改，而不是升完级就能继续跑。破坏性变更集中在底层，但官方给了前后对照的迁移指南，逐项核对并不算难。
最值得关注的是 httpx2。它保持了对外接口的兼容性，所以大多数直接调用 httpx 的代码不会感知到变化。但如果你之前对 transport、timeout 或连接池做了深度定制，这些细节在 httpx2 里可能有不同语义。别只看包名换了个数字，实际行为差异要跑一遍测试才放心。另一边，Text Completions API 的移除属于长痛不如短痛。过去一年里 Anthropic 一直在提示迁移到 Messages API，现在终于彻底关闭了旧入口。那些还在用 `complete()` 方法的老脚本，升级后将被直接拒绝连接。
对多数项目而言，迁移路径并不陡峭：替换 SDK 包、确认消息格式、检查弃用参数是否还在使用，三步就能走完。真正的风险藏在边缘逻辑里——比如你依赖 httpx 的某个中间件，或者偷偷用未文档化的响应字段。v1.0 给了清理技术债的机会，但也逼你先搞清楚自己到底依赖了什么。开发者版本说明里那份对照表值得逐行看，它比任何博客教程都更接近真相。
