Claude API 出正式版本 2026-10-21 了：Claude Code 用 `/claude-api` 升级 SDK，temperature 再传会 400

Anthropic 在 2026-10-21 发布了 API 正式版本 2026-10-21。据 Claude Developers 官方帖（约 7.6 万次曝光、1400+ 赞），这是自 2023-06-01 以来的首个正式版本发布；旧版本不会因此被弃用。

对写 Messages 请求、用 Anthropic SDK，或用 Claude Code / Cursor / AI Agent 调 Claude 兼容端点的人，最直接的影响是三件事：

1. 新 major SDK 与 ant CLI 默认发送 anthropic-version: 2026-10-21。
2. Messages 请求里再传 temperature、top_p、top_k，官方会返回 400。
3. Claude Code 可用内置 skill：/claude-api（以及 upgrade、migrate 等子命令）按项目语言改代码。

官方迁移步骤与破坏性变更清单见 Migrating to API version 2026-10-21；发布说明见 Release notes · October 21, 2026。

创建 API Key →　查看 Claude 定价 →

这个版本改了什么

版本怎么选

官方迁移指南写明：

If you use an SDK, your requests use the API version that was current when your SDK's major version was released. … If you call the API without an SDK, set the anthropic-version header to 2026-10-21.

首个默认发送 2026-10-21 的 major 版本包括：Python SDK 2.0.0、TypeScript SDK 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（见 Release notes）。

旧 SDK 可以继续停在 2023-06-01。官方帖也写了：2023-06-01 is not deprecated.

Messages：采样参数被移除

官方原文：

In 2026-10-21, a request that sends temperature, top_p, or top_k returns a 400 error, even at the parameter's default value. Remove the three parameters from your requests.

没有这些参数时，采样按默认值进行（含 temperature 为 1.0），与旧版不传这些参数时一致。若业务必须依赖非默认采样值，官方建议：要么停发该参数，要么该请求继续留在 2023-06-01。

另外两条 Messages 破坏性变更也要一起看：

• assistant 消息里直接塞 document 块会 400；文档应放在 user 消息里。
• user 消息的 text 块带非空 citations 会 400；assistant 回复里回传的 citations 仍可接受。

鉴权头：新 SDK 默认改 Bearer

官方原文：

The SDK and the CLI send your API key as Authorization: Bearer <key> instead of in the X-Api-Key header … The Claude API accepts a key in either header.

若你的代理、网关或自建中间层仍只读 X-Api-Key，升级新 major SDK 后要改读 Authorization，或按官方示例在客户端把 Key 改回 X-Api-Key。Claude API 本身两种头都收。

升级步骤

1. 换 SDK / 设版本头

无 SDK：升到上表对应的 major 版本，发布时默认就会带 2026-10-21。

不用 SDK、直接打 HTTP：

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

上面示例来自官方迁移指南的 cURL 段（模型名可换成你实际在用的 ID）。旧代码若必须停在旧行为，把 anthropic-version 留在 2023-06-01，并暂时不要升到上述 major SDK。

2. Claude Code：用 /claude-api 按 skill 迁

claude-api skill 随 Claude Code 附带，也可从 Anthropic skills 仓库安装。在 Claude Code 里直接输入：

/claude-api

按语言升级时可指定，例如：

/claude-api upgrade python

做模型迁移时：

/claude-api migrate this project to the latest Claude Opus model

官方说明 skill 会处理模型 ID、破坏性参数（含去掉 temperature / top_p / top_k）、beta 头清理等；改完后它会给出需人工核对的清单。

把本站 Claude 兼容端点写进全局个人设置，而不是项目目录。macOS / Linux：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 AICodeWith Key",
    "ANTHROPIC_API_KEY": ""
  }
}

路径是 ~/.claude/settings.json。ANTHROPIC_BASE_URL 不要带 /v1；Claude Code 会自己拼 Messages 路径。更完整的第三方接入说明见《Claude Code 如何接入第三方 API》。

3. 手改清单（没有 Claude Code 时）

按官方 Breaking changes，逐项改你的请求构造代码：

1. Messages / Message Batches 请求体删除 temperature、top_p、top_k。
2. 不要在 assistant 消息里直接放 document 块；改放到 user。
3. 不要在 user 的 text 块上带非空 citations。
4. 若读 Admin / Enterprise Analytics 字段，按迁移指南表格换成新字段名（例如 API key 的 workspace_id → scope）。
5. 升级 SDK 后，确认代理是否仍只认 X-Api-Key；不认的话改读 Bearer，或按官方示例把 Key 写回 X-Api-Key。

4. 配本站 Key

本站提供 Claude 兼容的 Anthropic 格式端点。全局配置示例与上一节相同：ANTHROPIC_BASE_URL=https://api.aicodewith.ai，Key 放进 ANTHROPIC_AUTH_TOKEN。

直接用 HTTP 自测时，两种鉴权头在本站都能通（见下文实测）：

export ANTHROPIC_BASE_URL=https://api.aicodewith.ai
export ANTHROPIC_AUTH_TOKEN='你的 Key'

curl "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Reply with exactly: OK"}]
  }'

模型 ID 以控制台与模型价目为准。排错可对照《Claude Haiku 5.5 API 报错排查》和《Claude Code 响应慢与 gzip》。

创建 API Key →　打开定价 / 充值 →

5. 验证：升级前后各打一请求，再故意带 temperature

官方要求：在发布前对 2026-10-21 做集成测试。建议顺序：

1. 旧版头 anthropic-version: 2023-06-01、不带采样参数 → 应成功。
2. 新版头 anthropic-version: 2026-10-21、不带采样参数 → 应成功。
3. 新版头 + "temperature": 0.2 → 按官方文档应返回 400。

官方对第 3 步的描述是：

a request that sends temperature, top_p, or top_k returns a 400 error, even at the parameter's default value.

请只记录 HTTP 状态、报错原文和耗时，不要把单次花费写进笔记或对外文档。

本站对照实测

测试目录：独立环境，请求打本站 https://api.aicodewith.ai/v1/messages，模型先用 claude-haiku-5-5 探路，再用官方仍允许非默认采样的 claude-sonnet-4-6 做三项对照。鉴权用本站测试 Key（x-api-key 与 Authorization: Bearer 各跑通过）。测完已删除含 Key 的配置与会话日志。

补充：claude-haiku-5-5 在 2026-10-21 / 2023-06-01、带或不带 temperature、以及 Bearer / x-api-key 下均为 HTTP 200，首次成功对话返回的模型 id 为 claude-haiku-5-5。

结论： 三项对照里，带 temperature 的请求在本站仍返回 200，与官方「应返回 400」不一致，因此本文不声称本站中转已按 2026-10-21 拒绝采样参数。官方行为以迁移指南为准；本站侧目前能确认的是——用本站 Key + Claude 兼容端点可以成功发 Messages。升级代码时仍应按官方清单删掉三个采样参数，避免将来直连 Anthropic 或网关策略收紧后突然失败。

本站 Claude 档位与充值入口

公开模型接口（/api/models）当前可见的 Claude 相关档位（单位：USD / 百万 Tokens，以页面实时数为准）：

充值与选模型入口：定价页。注册并创建 Key：登录 / 注册。接入 Claude Code 的逐步说明见第三方 API 教程。

常见问题

旧项目必须马上升到 2026-10-21 吗？

不必。官方明确 2023-06-01 未弃用。可以先在分支用新 SDK / 新版本头跑回归，确认已去掉三个采样参数、document / citations 布局符合新规则，再合并。

只升 SDK、不改请求体，会发生什么？

新 major SDK 会默认带 2026-10-21。若请求体仍含 temperature / top_p / top_k，按官方文档会 400。先删参数，或暂时钉住旧 SDK major。

Claude Code 里 /claude-api 和手动改有什么区别？

/claude-api 按项目语言加载 skill 文档，可批量改模型 ID、采样参数和部分 beta 头；手改适合请求面很小、或 CI 里只改几处构造函数的仓库。两者最终都要对照官方 Breaking changes 清单验收。

本站 Key 应该用 Bearer 还是 x-api-key？

Claude Code 接入本站的推荐写法是 ANTHROPIC_AUTH_TOKEN（Bearer）。直接 HTTP 时，本站对 Bearer 与 x-api-key 均实测可通。若中间还有只认 X-Api-Key 的旧代理，按官方「If a proxy or gateway reads X-Api-Key」一节改客户端或改代理。

temperature 被删后，怎么控制输出更稳？

官方说明：无替代采样参数。模型若本就只接受默认采样（如较新的 Claude 4.7+ 系列），行为与升级前不传非默认值时一致；若你过去靠调低 temperature 求稳定，需要改用提示词约束、结构化输出或换模型策略，而不是继续传采样字段。

相关阅读

• Claude Code 如何接入第三方 API
• Claude Haiku 5.5 API 报错排查
• Claude Code 响应慢与 gzip
• 定价 / 充值

来源

• Claude Developers：API version 2026-10-21
• Migrating to API version 2026-10-21
• claude-api Agent Skill
• Claude Platform Release notes · October 21, 2026