Anthropic Python SDK
Anthropic官方发布的Python SDK,用于调用Claude系列大语言模型API,支持企业级权限管理、插件市场、Managed Agents等功能,是开发者接入Claude的主要工具包
核心事实
时间轴 (近 90 天)
Python SDK内置的tool runner封装了完整的Agent循环,而Claude Agent SDK进一步提供驱动Claude Code的agent harness能力。
Anthropic官方Python SDK的重试逻辑默认2次重试、0.5秒起步翻倍至8秒、75%-100%抖动、遵循retry-after头;在100并发测试中仅40个成功。
迁移时建议通过 `pip install --upgrade anthropic` 将包更新到 1.0 版本,并检索所有 `import httpx` 的调用点改为使用 httpx2 对应的接口。
如果项目中其他库锁定了旧版 httpx,升级 Anthropic SDK 可能引发依赖解析失败,需要在虚拟环境中单独验证。
Anthropic Python SDK 1.0 移除了 Text Completions 接口。
Anthropic Python SDK 1.0 移除了 temperature 参数。
Anthropic Python SDK 1.0 的最低 Python 版本要求提升至 3.10。
Anthropic Python SDK 1.0 的底层 HTTP 客户端从 httpx 切换为 httpx2。
对于生产系统,建议保留旧版本 SDK 的回滚路径,直到新版本稳定运行一段时间。
API 层面新增了 user-profiles-2026-09-04 beta 值以及用户资料中的 external_user_details 字段
还有 40 条时间轴事件
全部知识事实 (20)
Anthropic 官方的 Python SDK(anthropic-sdk-python)发布了 v1.11.0 版本
90%待验证Python SDK内置的tool runner封装了完整的Agent循环,而Claude Agent SDK进一步提供驱动Claude Code的agent harness能力。
50%待验证Anthropic官方Python SDK的重试逻辑默认2次重试、0.5秒起步翻倍至8秒、75%-100%抖动、遵循retry-after头;在100并发测试中仅40个成功。
50%待验证Anthropic Python SDK 1.0 的底层 HTTP 客户端从 httpx 切换为 httpx2。
50%待验证Anthropic Python SDK 1.0 的最低 Python 版本要求提升至 3.10。
50%待验证如果项目中其他库锁定了旧版 httpx,升级 Anthropic SDK 可能引发依赖解析失败,需要在虚拟环境中单独验证。
50%待验证Anthropic Python SDK 1.0 移除了 Text Completions 接口。
50%待验证对于生产系统,建议保留旧版本 SDK 的回滚路径,直到新版本稳定运行一段时间。
50%待验证迁移时建议通过 `pip install --upgrade anthropic` 将包更新到 1.0 版本,并检索所有 `import httpx` 的调用点改为使用 httpx2 对应的接口。
50%待验证Anthropic Python SDK 1.0 移除了 temperature 参数。
50%待验证升级后开发者可通过 chmod 600 <凭证文件路径> 修正凭证文件权限以消除报错
50%待验证v1.4.0 在用户错误传入 httpx 对象(而非预期的 httpx2 对象)时会抛出清晰的错误提示
50%待验证v1.4.0 修复了 messages 资源中自定义代码(custom-code)的合并逻辑异常
50%待验证从 v1.3.0 升级到 v1.4.0 属于向后兼容的 minor 版本更新,没有破坏性变更记录
50%待验证v1.4.0 的内部改动包括打包 mock server 规范、清理代码注释、修复 detect-breaking-changes 脚本中的 mypy 不可达错误
50%待验证v1.4.0 刷新了示例代码中的平台模型 ID
50%待验证对于使用多工作区功能或依赖用量统计做成本管理的团队,建议尽快升级到 v1.4.0
50%待验证v1.6.0 文档改进包括将大部分 docstring 改用 Markdown 格式,并澄清 session_thread_id 字段仅为信息性字段
50%待验证v1.6.0 修复了重试逻辑,使客户端尊重超过 60 秒的 Retry-After 值,此前因上限限制会过早重试
50%待验证SDK 将 anyio 的最低版本要求提升至 4.1,并升级了开发锁文件中的 aiohttp、pygments 和 pytest 等组件
50%