10 月 21 日，Anthropic 发布了新的 API 版本 2026-10-21——这是自 2023 年以来，Claude API 的第一次正式版本更新。三年没动，一动就是“破坏性”的：开发者最常用的“随机性旋钮”被直接砍掉了。

被砍掉的三个参数

新版本从 Messages API 移除了 temperature、top_p、top_k 三个采样参数。注意，是“移除”不是“废弃”：请求里带上任何一个参数——哪怕传的是默认值——都会直接返回 400 错误。官方给出的替代方案只有一句话：用提示词控制输出风格。没有别的旋钮可调了。

这对所有 RAG、生成式应用都有直接影响：以前靠低 temperature 保证输出稳定的流程，升级后必须先改代码，否则批量调用会大面积 400。

SDK 全系大版本，许可证也换了

各语言 SDK 同步发布大版本，默认指向新 API 版本：Python 2.0.0、TypeScript 1.0.0、C# 13.0.0、Go 2.0.0、Java 3.0.0、PHP 1.0.0、Ruby 2.0.0，以及 ant CLI 2.0.0。顺带一提，SDK 的许可证从 MIT 换成了 Apache 2.0。

认证方式也有变更：API 密钥改走 Authorization: Bearer 头，旧的请求头直接失效——用了自建代理或网关的团队，记得检查代理层。凭证解析顺序固定为 ANTHROPIC_API_KEY → ANTHROPIC_AUTH_TOKEN → profile → workload identity federation；ant CLI 则删掉了 --api-key 和 --auth-token 参数。

另外两类请求也会 400：把 document 块直接放在 assistant 消息里、在 user 文本块里带非空 citations。Text Completions 从 TS/Go/Java/Ruby 的 SDK 和 CLI 中移除；Admin API 删掉了 API key 上的 workspace_id 字段，改用 scope。

升级清单：先测再升

好消息是旧版 2023-06-01 没有被废弃，依赖低 temperature 输出的应用可以继续钉住旧版本。但 Anthropic 明确表示，今后会更频繁地发布 API 版本——“钉版本”将成为生产环境的标配操作。

给技术团队的升级检查清单：

1. 全局搜索代码里的 temperature/top_p/top_k，全部移除或改走提示词控制。
2. 检查代理层、网关、CI 密钥注入是否还在用旧认证头。
3. 确认凭证解析顺序变更没有打乱多环境配置。
4. 在 staging 环境全量跑一遍迁移测试，确认没有 400，再切生产。

要点解读

• 三年未动的 API 一次性砍掉“随机性旋钮”，Anthropic 的意图很明确：把“输出风格”这件事彻底交给提示词，API 只保留确定性语义。这是在逼整个生态向“提示词即配置”迁移。
• 认证头和凭证解析链的变化是静默破坏的高发区——代码没报错，但请求在代理层就被拦了，这种故障最难查。升级前先把网关和 CI 的密钥链路盘一遍。
• 更大的信号是 Anthropic 宣布“API 版本化常态化”：以后模型和 SDK 的升级节奏会加快，生产环境钉版本、做版本升级演练，会变成和数据库迁移一样常规的操作。

（观点部分为本刊解读，仅供参考。）