Anthropic SDK v2.3.0 发布：Claude 标签端点与多项内部重构

Anthropic 官方 SDK 发布 v2.3.0 版本，为 Claude Enterprise 组织新增标签（Tag）端点，并在 Google Cloud 支持、客户端查询参数处理、文档描述等方面做出一系列修正与优化。这个版本没有引入破坏性变更，更多是对 API 能力边界和内部实现一致性的补齐。

新增 Claude Tag 端点，面向企业组织

v2.3.0 最值得关注的特性是 api 模块新增了 Claude Tag endpoints，专门用于 Claude Enterprise 组织。标签机制通常用于对组织内的资源（如对话、项目或用户分组）进行归类与检索，这一端点的加入意味着企业客户可以通过 SDK 直接管理标签数据，而不必自行拼装 HTTP 请求。

对于已经在使用 Anthropic 企业版能力的团队，这属于可直接落地的功能增量；对于个人开发者，则暂时影响有限。从这个动作也能看出，Anthropic 正在把企业级管理能力逐步下沉到官方 SDK 层，减少客户在集成层的重复工作。

Google Cloud 相关修复与产品名更新

本次发布在 Google Cloud 方向有两处调整。其一，用户档案（user profiles）请求现在会被发送到组织端点（organization endpoint），属于 Bug Fix，修正了此前请求目标不正确的问题；其二，文档中更新了产品名称，保证与当前对外命名一致。

这类修复对使用 Vertex AI 等 Google Cloud 路径接入 Claude 的开发者尤为重要——请求落到错误的端点往往表现为难以排查的 4xx 或权限错误，官方在 SDK 层直接修正，可以省去一轮调试成本。

Vertex AI 是 Google Cloud 上用于构建、部署和扩展机器学习模型的统一 AI 开发平台，Claude 模型通过 Vertex AI Model Garden 以托管形式提供，调用时使用 Google Cloud 的服务账号与 IAM 权限体系。因此 SDK 中“组织端点”的区分尤为关键：Google Cloud 上的请求若未落到组织级路径，就可能绕过预期的项目与计费归属，返回 403 或 404，而错误信息通常不会直接指出端点拼接问题。Anthropic SDK 对 Google Cloud 的支持本质上是在标准 Messages API 之外额外封装一套认证与路由逻辑，让开发者用相近的接口调用 Vertex 上的模型。理解这一层差异，有助于在升级时判断 user profiles 相关请求的目标地址是否与自身 GCP 项目结构匹配。

客户端查询参数处理方式调整

内部重构中有一条值得注意：停止在端点路径中硬编码查询参数，并把端点路径携带的查询参数上提到请求层统一处理。与之配套的是内部改为读取 beta 路由限定符（beta route qualifier），而不是依赖 beta=true 查询参数，parse 与 stream 也不再发送 beta 查询参数。

这组改动的意义在于统一请求构造路径。硬编码查询参数虽然简单直接，但一旦端点行为变化或需要复用请求层逻辑，就容易产生不一致。把参数处理收敛到请求层，是 SDK 长期可维护性的常见做法。对上层调用者而言，多数情况下 API 表面不变，但如果你有代码直接依赖了发出的原始查询字符串，需要留意行为差异。

Beta 路由限定符（beta route qualifier）是 Anthropic API 在路径中标识“该接口处于 beta 阶段”的机制，例如路径中带有 ?beta=true 或特定 beta 版本标识。早期 SDK 直接把这类标识硬编码进端点字符串，导致请求层无法感知、也无法统一改写。改为在请求层读取限定符后，SDK 可以在发送前统一决定是否附加 beta 标识、采用哪一 beta 版本，从而避免 parse 与 stream 等不同调用路径行为不一致。对于自行封装 HTTP 请求或做请求拦截、日志审计的团队，这意味着抓包看到的原始 URL 可能与旧版不同，但语义等价，需要相应调整断言或 mock 规则。

文档与示例的多处完善

文档方面的更新相当密集：改进了代码执行工具（code execution tool）及其加密结果的描述；重写了工作队列（work queue）、技能（skill）与外部密钥（external key）的说明文字；更新了按用户统计的使用量与成本报告描述；为 Bedrock 与 Vertex 的原始响应 docstring 补上了指向 SDK 文档的链接；同时更新了 README 和示例请求。

另外，文档中移除了 tool_runner 异步示例里多余的 await，这是一个典型的示例代码纠错——异步示例中的多余 await 容易误导初学者写出错误的调用链。

代码执行工具（code execution tool）是 Claude 的一项工具调用能力，允许模型在受控沙箱中运行代码并返回结果，其中间产物会以加密形式回传，以保证内容不被篡改且可被服务端校验。工作队列（work queue）与技能（skill）则属于企业级编排概念：前者用于异步任务的排队与状态跟踪，后者用于把可复用的操作封装为模型可调用的能力单元；外部密钥（external key）指由客户自行托管、供 SDK 引用的凭据，避免密钥明文进入请求体。按用户统计的用量与成本报告则依托组织与用户标识做聚合，便于企业分摊费用。这些概念的文档化程度直接影响集成方能否正确配置权限与计费口径。

内部工程与 CI 调整

工程侧还有若干维护性改动：工作流改为按 owner 与 public name 校验仓库；CI 中移除了 preview build 的上传步骤。这些改动不直接暴露给使用者，但反映出项目在持续收紧发布流程与仓库校验规则。

升级建议

对大多数使用者来说，v2.3.0 可以直接升级：新增端点属于增量能力，Bug Fix 修正了 Google Cloud 用户档案请求的目标端点，文档更新也有助于理解代码执行工具与用量报告等能力。需要额外验证的场景有两类：一是依赖 SDK 发出的具体查询参数（尤其是 beta 相关参数）的自定义封装；二是使用 Google Cloud 路径且对用户档案请求端点敏感的集成。

整体来看，这个版本是一次以企业能力补齐和内部一致性为主的常规迭代，没有激进的接口变化，适合在测试环境验证后平滑跟进。