Claude 各语言 SDK 和 ant 出了新的小版本,七种语言的 SDK 文档都加了 OpenTelemetry tracing
10 月 24 日官方 SDK 总览页的版本表整体往前走了一到两个小版本,七种语言的 SDK 文档都新加了“OpenTelemetry tracing”一节,PHP 还加了中间件。tracing 仍是 beta,升级前先固定版本。
2026 年 10 月 24 日,Claude 开发平台文档的 SDK 总览页更新了版本表,各语言的 SDK 页也改了一轮。这条只记两件事:版本号,和 OpenTelemetry tracing 写进了每种语言的文档。本站没有实测新版本。
版本号
官方 SDK 总览页列的最新版本(本站 10 月 24 日北京时间 08:00 存下的那一版):
| SDK | 10 月 24 日 | 10 月 23 日 |
|---|---|---|
| ant(命令行) | 2.2.0 | 2.1.0 |
Python(anthropic) |
2.3.0 | 2.1.0 |
TypeScript(@anthropic-ai/sdk) |
1.3.0 | 1.1.0 |
C#(Anthropic) |
13.3.0 | 13.1.0 |
Go(anthropic-sdk-go/v2) |
2.3.0 | 2.1.0 |
Java(anthropic-java) |
3.3.0 | 3.1.0 |
PHP(anthropic-ai/sdk) |
1.3.0 | 1.1.0 |
Ruby(anthropic) |
2.3.0 | 2.1.0 |
这张表当天上午就改了不止一次:早上 7 点半日报抓取时,TypeScript、C#、Java 还是 1.2.0、13.2.1、3.2.0,半小时后已经是上表的数字。快速上手、托管智能体等页面示例里写的版本号也跟着变了,有的页还没统一。装的时候以包管理器上的最新版为准。
这些都是 10 月 21 日 API 新版本那次大版本之后的小版本,各版本具体改了什么看各 SDK 仓库的更新日志,本站没有逐个核对。大版本的改动见那条快讯。各语言 SDK 和 ant 的基本用法见 Claude 的 SDK 和命令行。
七种语言的 SDK 文档都加了 OpenTelemetry tracing
C#、Go、Java、PHP、Python、Ruby、TypeScript 的 SDK 页都新加了一节 “OpenTelemetry tracing”,说法一致:你的程序注册了 OpenTelemetry 的 tracer provider,SDK 就为它发出的每个请求生成一个 span(C# 是把 SDK 的源 com.anthropic.sdk.csharp* 加进 tracer provider)。怎么把 span 送到观测平台,统一指向《Set up OpenTelemetry with the Claude SDK》那一页;那一页给 Java 写的最低版本是 3.3.0,Java 还要求 opentelemetry-api 在 1.57.0 以上,否则 span 发不出来。
同一天,tracing 的概览页改名为 “OpenTelemetry tracing for the Claude API”。它仍然是 beta:文档提醒新版本的 SDK 可能改掉 span、属性、选项或环境变量的名字,所以要在依赖里固定 SDK 的版本,自己决定什么时候升级。
本站 10 月 15 日用 Python SDK 实测过 tracing,做法和看到的 span 见给 Claude API 接上 OpenTelemetry。
PHP SDK 加了中间件
PHP 的 SDK 页新加了 Middleware 一节和 Anthropic\Middleware 接口。中间件是在请求发出之前、响应回来之后运行你自己的代码,用来记日志、自定义重试、给请求打标记,或者处理拒绝回答时的退路。别的语言的写法在《SDK middleware》那一页。