Anthropic 于上海时间 2026 年 9 月 23 日 00 时 27 分发布 TypeScript 官方 SDK sdk-v0.128.0。经 GitHub Release 与 Release API 归一验证,该版本 published_at 为 2026-09-22T16:27:55Z,对应北京时间 9 月 23 日 00 时 27 分,落在当日 00:00 至 23:59 窗口内。仓库为 https://github.com/anthropics/anthropic-sdk-typescript,归属 anthropics 组织即 Anthropic,包名为 @anthropic-ai/sdk,许可证为 MIT,保持不变。发布体标注 0.128.0(2026-09-22)为变更生成日期,实际首次公开以 published_at 为准,对比区间为 sdk-v0.127.0 至 sdk-v0.128.0,为正式发布而非预发布。中国开发者可通过公开仓库按标签获取源码与比较说明,或经 npm 按版本升级验证,不改变服务端模型可用范围与计费规则。

关键变化

  • 新增 Opus 5.5 支持:客户端 API 新增对 claude-opus-5-5 的支持,对应提交 eff2748,JS/TS 接入可直接传入新模型名称;新增内联工具定义与 MCP 工具列表固定能力,标注为 Beta,可在测试环境先验证工具调用链路;统一 Managed Agents 事件权限枚举:多个事件共用同一 evaluated_permission 枚举,减少类型分歧;修复 addTools 即时生效问题:对应 #773,调用后无需额外等待即可生效;修复压缩请求参数问题:对应 #769,回复专用参数不再进入工具运行器的压缩请求;文档与测试维护:补充 Dreams、用户画像与记忆存储等 API 描述,优化 Beta 消息诊断字段,并新增分段 JSON 解析的属性化测试

适用对象与访问条件

本次更新主要面向两类中国用户:一是已通过 TypeScript 或 JavaScript 对接 Anthropic Messages、工具调用与 MCP 的开发者与团队,特别是需要试用 Opus 5.5、内联工具或固定 MCP 工具列表的工程,可在升级后直接使用新参数与模型名称;二是通过 Node 网关统一封装 Claude 能力的网关维护者,可在升级后透传新标识并复用更一致的权限枚举与工具逻辑。访问条件为公开仓库,可从 GitHub Releases 页按标签 sdk-v0.128.0 获取源码与 sdk-v0.127.0 至 sdk-v0.128.0 比较说明,或经 npm 安装 @anthropic-ai/sdk@0.128.0 验证,SDK 本身无需额外购买,国内下载需自行解决网络可达性,实际调用仍需配置 API 密钥并以账户权限与后端服务为准,新 Beta 能力需按官方要求携带相应 Beta 头或配置。

兼容性、限制与注意事项

兼容性方面,本次为常规小版本功能追加加修复,发布说明未声明破坏性接口变更与许可证变更,可按小版本评估平滑升级。对未使用新模型标识与新工具参数的现有代码,理论上无行为变化;权限枚举统一与 addTools 生效时序调整多数场景为修复而非 breaking,但重度依赖自定义工具封装与压缩逻辑的项目仍建议回归。包配置显示同时支持 import 与 require,并提供浏览器构建映射,开发依赖提示 Node 20 类型环境,实际运行版本以官方文档为准。限制方面,SDK 仅完成客户端封装,不改变服务端配额、限流、内容策略、价格与区域可用性,Opus 5.5 与内联工具能否实际调用取决于服务端是否已向当前账户开放。开放客户端不等于开放模型权重,模型本身许可与使用条件仍以官方模型说明为准。本文不对安全性、长期维护与后续兼容作超出发布说明的保证。

下一步

已使用该 SDK 的项目可将版本固定至 0.128.0,在预发环境回归现有消息、流式、工具调用、压缩与 MCP 链路,重点验证 addTools 后立即调用、压缩请求参数与权限枚举类型,再验证 Opus 5.5 标识与内联工具的传入与错误分支,确认无回归后全量升级。需要试用新能力的团队,应先在官方文档与控制台确认服务端在自身账户与区域的可用状态,再在测试密钥下小流量验证 Beta 行为。遇到标识缺失或类型报错,以 Release sdk-v0.128.0 说明与 GitHub API 中 published_at 对应北京时间 2026 年 9 月 23 日的归一验证为准反馈。