[控场AI]
产品anthropic-sdk-python

Anthropic Python SDK

Anthropic官方发布的Python SDK,用于调用Claude系列大语言模型API,支持企业级权限管理、插件市场、Managed Agents等功能,是开发者接入Claude的主要工具包

核心事实

时间轴 (近 90 天)

10月4日

API 层面新增了 user-profiles-2026-09-04 beta 值以及用户资料中的 external_user_details 字段

待验证50%
10月4日

升级后开发者可通过 chmod 600 <凭证文件路径> 修正凭证文件权限以消除报错

待验证50%
10月4日

idempotency_key 作为已废弃的空操作(deprecated no-op)保留,现有代码不会立即报错但应准备迁移

待验证50%
10月4日

新版本中 extra_body 现在会在客户端钩子(client hooks)运行之前完成合并

待验证50%
10月4日

v1.5.0 修复了流式解析工具调用时不完整的工具输入 JSON 可能残留在 content blocks 中导致解析异常的问题

待验证50%
10月4日

新版本新增了 CredentialsError 和 IdentityTokenFileError 两个异常类型

待验证50%
10月4日

SDK 现在会拒绝可被用户组或其他用户访问的凭证文件,若凭证文件权限过于宽松将主动报错

待验证50%
10月4日

Web fetch 工具新增了 content_too_large 错误码,用于在抓取网页内容超出处理上限时返回明确错误类型

待验证50%
10月4日

新版本新增了 Message.to_param() 和 BetaMessage.to_param() 方法,可将已有消息对象转换回参数形式

待验证50%
10月4日

v1.5.0 中 messages.create、parse、stream 和 count_tokens 现在可以直接接受工具对象,无需手动转换为特定参数结构

待验证50%

还有 40 条时间轴事件

全部知识事实 (20)

部分验证

Anthropic 官方的 Python SDK(anthropic-sdk-python)发布了 v1.11.0 版本

90%
待验证

v1.6.0 为 Managed Agents 新增了 auto mode 工具权限,允许托管智能体在自动模式下管理工具调用权限

70%
待验证

升级后开发者可通过 chmod 600 <凭证文件路径> 修正凭证文件权限以消除报错

50%
待验证

v1.4.0 修复了 messages 资源中自定义代码(custom-code)的合并逻辑异常

50%
待验证

v1.4.0 在用户错误传入 httpx 对象(而非预期的 httpx2 对象)时会抛出清晰的错误提示

50%
待验证

对于使用多工作区功能或依赖用量统计做成本管理的团队,建议尽快升级到 v1.4.0

50%
待验证

v1.4.0 的内部改动包括打包 mock server 规范、清理代码注释、修复 detect-breaking-changes 脚本中的 mypy 不可达错误

50%
待验证

从 v1.3.0 升级到 v1.4.0 属于向后兼容的 minor 版本更新,没有破坏性变更记录

50%
待验证

v1.4.0 刷新了示例代码中的平台模型 ID

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%
待验证

对于非法的 Retry-After 值,SDK 现在会直接忽略,并对 maxRetries 进行校验

50%
待验证

异步客户端现在会对连接错误进行重试,并修复了协程重试循环中的阻塞问题

50%
待验证

v1.7.0 将 Ruff 的目标版本设定为 Python 3.10,并在 MCP 工具辅助函数中为 zip() 传入 strict= 参数

50%
待验证

当传入多个 anthropic-beta 值时,SDK 现在以逗号加无空格的方式拼接

50%
待验证

SDK 现在能够正确接受 X | Y 形式的联合类型进行响应解析,并且在遇到带有未知数据的 X | Y 字段时不再抛出 TypeError

50%
待验证

在 Bedrock 集成方面,SDK 现在会对 eventstream 的异常帧和错误帧抛出 API 错误,而不是静默处理

50%
待验证

v1.7.0 要求 Pydantic 1.10 或更高版本

50%
待验证

SDK 支持工具调用在回复流式传输的同时运行(可选),减少用户感知的等待时间

50%

来源文章