Anthropic Python SDK v1.0 发布
Anthropic 于 2026 年 8 月 20 日发布 Python SDK v1.0.0，这是该 SDK 的首个大版本里程碑。主要变更包括 HTTP 层从 httpx 迁移到 httpx2、Python 3.10+ 基线要求、以及长期废弃的表面移除。
关键事实
- v1.0.0 是首个非 beta 版本，parse、stream 和 tool_runner 辅助工具的 beta 警告被移除
- HTTP 层从 httpx 迁移到 httpx2（API 兼容 fork，由 Pydantic Services Inc. 维护）
- Python 基线从 3.9 提升到 3.10+（支持 3.10 到 3.14）
- 移除 Text Completions API、temperature/top_p/top_k 参数、compaction_control
- AnthropicBedrock 未配置 AWS region 时报错而非默认 us-east-1
- Skills API 和 Files API 同步上线 Microsoft Foundry，Vertex AI 即将跟进
事件背景
httpx 是 Anthropic 和 OpenAI Python SDK 的 HTTP 传输层，但自 2024 年以来未发布新版本，issues 被关闭无解决，成为供应链风险。httpx2 由 Pydantic Services Inc. 维护，原始作者 Tom Christie 参与，是 API 兼容的 fork。Starlette 已于 2026 年 5 月迁移到 httpx2。
Anthropic SDK v1.0 跟随这一趋势，将 HTTP 层迁移到 httpx2。同时，这是首个 1.0 版本，标志着 API 表面稳定，parse、stream 和 tool_runner 辅助工具的 beta 警告被移除。
核心变更
| 变更 | 描述 |
|---|---|
| HTTP 层 | httpx → httpx2（API 兼容 fork） |
| Python 基线 | 3.10+（3.10 到 3.14） |
| 移除表面 | Text Completions API、temperature/top_p/top_k 参数、compaction_control |
| Bedrock | AnthropicBedrock 未配置 AWS region 时报错而非默认 us-east-1 |
| 平台同步 | Skills API 和 Files API 上线 Microsoft Foundry，Vertex AI 即将跟进 |
迁移注意事项
大多数调用代码无需修改。以下情况需要特别注意：
- 自定义 client/transport/timeout：需从 httpx2 或 DefaultHttpxClient 辅助工具构建
- tracing/mocking 库：OpenTelemetry、Sentry、respx、pytest-httpx 通过 patch httpx 工作，迁移后可能静默失效。需在启动时调用 httpx2.alias_httpx()（在任何 httpx import 之前）
- Python 3.10 基线：旧 CI 环境可能需要升级
战略意义
- API 稳定：1.0 版本标志 API 表面稳定，beta 警告移除
- 供应链安全：httpx→httpx2 解决维护停滞风险
- 多平台同步：Skills/Files API 同步上线 Foundry 和即将上线 Vertex
风险边界与后续观察
- Python 3.10 基线可能影响旧 CI 环境
- httpx2.alias_httpx() 必须在任何 httpx import 之前调用，且不能在库代码中调用
- 自定义 client/transport/timeout 需手动迁移
- OpenAI SDK 使用相同 Stainless 模板，迁移进度待跟踪
AI Master 解读
核心事件
Anthropic 发布 Python SDK v1.0，HTTP 层从 httpx 迁移到 httpx2（维护中的 API 兼容 fork）。要求 Python 3.10+。依赖 tracing/mocking 库的用户需在启动时调用 httpx2.alias_httpx()。Skills API 和 Files API 同步上线 Microsoft Foundry，Vertex AI 即将跟进。
行业影响
为什么重要： 这是 Anthropic SDK 的首个 1.0 版本，标志着 API 表面稳定。HTTP 层从 httpx 迁移到 httpx2 是因为 httpx 自 2024 年以来未发布新版本，issues 被关闭无解决，成为供应链风险。httpx2 由 Pydantic Services Inc. 维护，原始作者 Tom Christie 参与。迁移对大多数调用代码透明，但依赖 tracing/mocking 库（OpenTelemetry、Sentry、respx、pytest-httpx）的用户需特别注意：这些工具通过 patch httpx 工作，迁移后可能静默失效——测试通过但实际未拦截任何请求。
影响分析：
| 维度 | 影响 |
|---|---|
| SDK 稳定性 | 1.0 版本标志 API 表面稳定 |
| 供应链安全 | httpx→httpx2 解决维护停滞风险 |
| 迁移成本 | 大多数代码透明，tracing/mocking 需特殊处理 |
| 平台同步 | Skills/Files API 上线 Foundry，Vertex 即将跟进 |
风险边界： Python 3.10 基线可能影响旧 CI 环境；httpx2.alias_httpx() 必须在任何 httpx import 之前调用，且不能在库代码中调用；自定义 client/transport/timeout 需手动迁移到 httpx2。
AI Master 建议
评估自有代码是否使用 httpx 自定义 client 或 tracing/mocking 库；在测试环境中先验证迁移；关注 httpx2.alias_httpx() 的调用时机；跟踪 OpenAI SDK 的 httpx2 迁移进度（两者使用相同 Stainless 模板）。 **来源:** Anthropic / ReleaseBot **链接:** https://releasebot.io/updates/anthropic