Claude Sonnet 5 发布:同价更强的编码与Agent升级

2026 年,Anthropic 在 Sonnet 系列上又迈了一大步。Claude Sonnet 5 以"Sonnet 4.6 的无痛升级版"姿态登场,却在编码与 Agent 任务上带来了实打实的能力跃迁。这篇文章带你快速读懂它的变化、定价,以及迁移要点。

一、它是谁:最佳的"速度 × 智能"组合

Claude Sonnet 5 是 Anthropic Sonnet 模型家族的新一代旗舰,定位依旧是速度与智能的最佳平衡——适合既要快、又要聪明、还要控成本的生产级场景。

核心规格一览:

官方明确:Sonnet 5 在编码和 Agent 类任务上相对 4.6 提升最大,同时价格不变。换句话说,这是一次"同价更强"的升级。

二、三个关键行为变化

Sonnet 5 被官方称为 Sonnet 4.6 的"drop-in 替换",但有 三处行为变化 必须知道,否则可能直接踩坑。

1. Adaptive thinking 默认开启

在 Sonnet 4.6 上,不带 thinking 字段的请求是不思考的;到了 Sonnet 5,同样的请求会默认启用自适应思考。

由于 max_tokens 是"思考 + 回答"的总硬上限,过去那些不思考、把 max_tokens 卡得很死的工作流,需要重新评估预算——否则回答可能被思考过程挤掉。

想关掉思考?显式传:

{ "thinking": { "type": "disabled" } }

2. 手动扩展思考被移除

thinking: {type: "enabled", budget_tokens: N} 这种"手动给思考定额"的写法,在 4.6 上已被弃用,到 Sonnet 5 直接返回 400 错误(与 Opus 4.8 / 4.7 一致)。

迁移方式:改用自适应思考 + effort 参数控制深度。

# ❌ Sonnet 5 上会 400
thinking = {"type": "enabled", "budget_tokens": 32000}
 
# ✅ 改成这样
thinking = {"type": "adaptive"}
# 用 effort 控制思考深度:low / medium / high(默认 high)

3. 采样参数不再接受

temperature、top_p、top_k 只要设为非默认值,就会返回 400。这是 Sonnet 系首次 引入该约束(此前 Opus 4.7 已先行)。迁移时直接删掉这些参数,改用系统提示词来引导风格。

三、新分词器:同样的文本,约 +30% token

Sonnet 5 换用了新分词器(与 Opus 4.7 起同源)。同一段文本,token 数约比 Sonnet 4.6 多 30%。

注意:这不是 API 变化——请求、响应、流式事件的结构完全不变,无需改代码。但凡是"按 token 计量/预算"的地方都受影响:

• 用量与计费:同样文本的 usage 更高;单价不变,但等价请求的总成本可能与 4.6 不同。
• 上下文容量(以文字计):窗口仍是 1M,但每个 token 承载的文字更少,装得下的"文本量"略减。
• max_tokens 预算:为 4.6 调好的输出上限,可能在 5 上截断等价输出——贴着预期长度设的限制要重新评估。

建议:迁移前用 token counting 在 Sonnet 5 上重新测量真实 prompt,别直接套旧数字、也别用固定倍率拍脑袋。

四、安全与刷新点

• 首个带实时网络安全防护的 Sonnet:涉及高风险/违禁网络安全话题的请求可能被拒。拒绝以 HTTP 200 返回,带 stop_reason: "refusal",而不是错误码——客户端要先判 stop_reason 再读 content,否则取 content[0] 会越界。
• Assistant 预填充仍不支持:沿用 4.6 行为,预填充助手消息会 400。需要约束输出格式请用 structured outputs / output_config.format / 系统提示词。
• effort 默认 high:Claude API 与 Claude Code 上,Sonnet 5 的 effort 默认 high,要别的档位需显式设置。

五、在哪用 & 怎么迁移

可用平台:Claude API、Amazon Bedrock(anthropic.claude-sonnet-5)、Claude Platform on AWS、Google Cloud(claude-sonnet-5)、Microsoft Foundry(预览)。注意:Sonnet 5 不支持 Priority Tier。

三步迁移:

model = "claude-sonnet-4-6"  # Before
model = "claude-sonnet-5"    # After

1. Token 预算与计数:新分词器约 +30%,重新计数,复查贴边的 max_tokens。
2. 扩展思考:还在用 budget_tokens 的迁到 adaptive;手动 enabled 会 400。
3. 采样参数:删掉非默认的 temperature / top_p / top_k。工具定义和响应结构不变,预填充本就不支持。

结语

Claude Sonnet 5 的故事很简单:同样的价格档位,更强的编码与 Agent 能力,几乎无痛的升级路径。只要处理好"思考默认开启、采样参数下线、分词器 +30%"这三点,把模型 ID 一换,大多数应用就能直接吃到提升。

如果你的网关或中转服务要支持它,记得把它归到"adaptive-only"家族统一处理。