开源anthropic-sdk-python Releases·原文 2026年11月5日

Anthropic Python SDK发布v2.5.0:新增错误类型与工作区id过滤

anthropic-sdk-python v2.5.0在API侧新增错误详情类型和新错误类型值、为列出工作区增加ids过滤;客户端侧新增HTTP状态码与API错误码对应的错误类,并在APIStatusError上暴露error_code、details和api_message。该版本同时修复多处路径校验与线程安全问题。

anthropic-sdk-python发布v2.5.0。按仓库发布说明,该版本新增错误详情类型和新的错误类型值,为列出工作区增加ids过滤;客户端新增按HTTP状态码和API错误码划分的错误类,并在APIStatusError上提供error_code、details和api_message。

API新增错误类型与工作区ids过滤

发布说明将两项列为Features:api部分新增错误详情类型和新的错误类型值;列出工作区(list workspaces)的接口增加ids过滤参数。

同属api的修正包括:错误详情类型名中的CMEK改为大写;部分错误详情类型被移动到其所描述的资源下。

客户端错误类与错误字段

客户端侧新增对应HTTP状态码和API错误码的错误类,APIStatusError上新增error_code、details和api_message。

错误继承关系有调整:OverloadedError和ServiceUnavailableError成为InternalServerError的子类。

路径校验与Bedrock、Vertex修复

Bedrock相关调用在model为 "." 或 ".." 时抛出ValueError,不再把请求发到其他路径;model为空时同样抛出ValueError,不再请求 /model//invoke。

客户端拒绝 '..;x'、';x' 这类路径参数。Vertex请求路径中的model、project ID和region改为百分号编码。

线程安全与memory工具修复

每个响应模型的首次解析改为线程安全;在pydantic v1下跨线程的union校验被修正。

tools部分修复使memory工具不会再重命名或删除 /memories目录。测试项新增对None路径参数被拒绝的检查。

文档与其他改动

文档改动包括:澄清plugin reach值和plugin版本描述及长度;澄清若干API字段与三条错误描述;说明fallback block前后应回传哪些块;修正用量报告中Claude Tag直接消息的说明;改写Dream与RBAC角色权限描述;更新遥测目标header描述;在分析过滤文档中使用Claude Platform名称。CI增加以延迟构建pydantic模型方式运行测试。内部整理包括将错误体辅助函数移入内部工具、删除过时TODO与一个无法通过的测试。

信息来源