迁移到 Claude Sonnet 4.6：完整 API 指南

摘要

从 Sonnet 4.5 迁移到 4.6 很简单——更新模型 ID 并可选地采用新功能。关键变更：自适应思考取代扩展思考、上下文压缩自动生效、100 万上下文以测试版提供。基本用法无破坏性变更。

快速迁移

对大多数应用来说，迁移仅需一行改动：

# 之前（Sonnet 4.5）
response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    ...
)

# 之后（Sonnet 4.6）
response = client.messages.create(
    model="claude-sonnet-4-6-20260217",
    ...
)

可采用的新功能

1. 自适应思考

用细粒度 effort 控制取代二元扩展思考：

# 新（Sonnet 4.6）
response = client.messages.create(
    model="claude-sonnet-4-6-20260217",
    thinking={"type": "enabled", "effort": "high"},  # 或 "low"、"medium"、"auto"
    ...
)

2. 上下文压缩

无需代码修改——压缩对长对话自动生效。你的应用免费获得无限对话长度。

3. 100 万上下文窗口

为大上下文请求启用测试版访问：

response = client.messages.create(
    model="claude-sonnet-4-6-20260217",
    max_tokens=8192,
    betas=["max-tokens-1m"],
    messages=[{"role": "user", "content": massive_document}]
)

性能提升

Sonnet 4.6 无需代码修改即可提供更好的结果：

指标	4.5	4.6	提升

SWE-bench

77.2%

79.6%

+2.4%

OSWorld

61.4%

72.5%

+11.1%

数学

62%

89%

+27%

迁移清单

[ ] 更新模型标识符为 claude-sonnet-4-6-20260217

[ ] 将 budget_tokens 替换为 effort 参数

[ ] 在预发布环境测试核心功能

[ ] 监控长上下文请求的成本

[ ] 考虑为适用场景采用 100 万上下文

[ ] 带回滚能力部署

结论

Sonnet 4.6 迁移风险低、收益高。模型在所有基准上提供更好的性能，同时保持 API 兼容性。大多数团队可通过简单的模型 ID 更改完成迁移，并逐步采用新功能。

摘要