Claude Sonnet 5 的新功能

Claude Sonnet 5 是 Anthropic Sonnet 模型系列的下一代。它是 Claude Sonnet 4.6 的直接升級版本，並有三項行為變更：自適應思考預設為開啟、手動擴展思考現在會回傳 400 錯誤（在 Claude Sonnet 4.6 上已被棄用），以及將取樣參數（temperature、top_p、top_k）設定為非預設值會回傳 400 錯誤。本頁總結了發布時的所有新內容，包括新的 tokenizer（分詞器）。



新模型

Claude Sonnet 5 預設支援 1M token 上下文視窗（1M token 既是預設值也是最大值；沒有較小的上下文變體）、128k 最大輸出 token、自適應思考，以及與 Claude Sonnet 4.6 相同的工具和平台功能集，但 Priority Tier 除外，其在 Claude Sonnet 5 上不可用。

如需完整的定價和規格，請參閱模型概覽。



行為變更



自適應思考預設為開啟

在 Claude Sonnet 4.6 上，沒有 thinking 欄位的請求會在不思考的情況下執行。在 Claude Sonnet 5 上，相同的請求會以自適應思考執行。若要關閉思考，請傳入 thinking: {type: "disabled"}。由於 max_tokens 是總輸出（思考加上回應文字）的硬性限制，對於在 Claude Sonnet 4.6 上不使用思考執行的工作負載，請重新檢視此設定。



不接受取樣參數

將 temperature、top_p 或 top_k 設定為非預設值會回傳 400 錯誤。遷移時請移除這些參數；預設值（或省略該參數）是可接受的。請使用系統提示指令來引導模型行為。這對 Sonnet 級別的模型來說是新的限制；相同的限制先前已在 Claude Opus 4.7 上引入。



移除手動擴展思考

手動擴展思考（thinking: {type: "enabled", budget_tokens: N}）在 Claude Sonnet 4.6 上已被棄用；在 Claude Sonnet 5 上已被移除並會回傳 400 錯誤，與 Claude Opus 4.8 和 Claude Opus 4.7 相同。請改用帶有 effort 參數的自適應思考。

# Claude Sonnet 5 不支援（會回傳 400）
thinking = {"type": "enabled", "budget_tokens": 32000}

# 請改用此方式
thinking = {"type": "adaptive"}



新的 tokenizer

Claude Sonnet 5 使用新的 tokenizer。相同的輸入文字產生的 token 數量比 Claude Sonnet 4.6 多約 30%。確切的增加幅度取決於內容。這不是 API 變更：請求、回應和串流事件保持相同的結構，不需要變更程式碼。

此變更會影響您以 token 衡量或編列預算的任何內容：

• Token 計數： 相同文字的 usage 欄位和 token 計數結果會比 Claude Sonnet 4.6 更高。請勿重複使用針對較早模型測量的計數；請針對 Claude Sonnet 5 重新計數。
• 以文字計算的上下文視窗容量： 上下文視窗為 1M token，但每個 token 平均涵蓋的文字較少，因此相同的視窗容納的文字比 Claude Sonnet 4.6 少。
• max_tokens 預算： 針對 Claude Sonnet 4.6 調校的輸出限制可能會在 Claude Sonnet 5 上截斷等效的輸出。請重新檢視接近您預期輸出長度的限制設定。
• 每個請求的成本： 每個 token 的定價不變（請參閱定價），但由於相同的文字會產生更多 token，等效請求的成本可能與 Claude Sonnet 4.6 不同。



繼承自 Claude Sonnet 4.6 的 API 限制



不支援助手訊息預填

預填助手訊息會回傳 400 錯誤，與 Claude Sonnet 4.6 相同。請改用結構化輸出、系統提示指令或 output_config.format。



能力提升

Claude Sonnet 5 是 Claude Sonnet 4.6 在相同價格下的能力升級版本。對於需要比 Claude Sonnet 4.6 更強能力但又不想轉移到 Opus 級別模型的工作負載，它也是一個選擇。

相較於 Claude Sonnet 4.6，最大的提升在於程式編寫和代理任務。如需基準測試結果，請參閱 Anthropic 的透明度中心。



網路安全防護措施

Claude Sonnet 5 是第一個具有即時網路安全防護措施的 Sonnet 級別模型。涉及禁止或高風險網路安全主題的請求可能會被拒絕。拒絕會以成功的 HTTP 200 回應回傳，並帶有 stop_reason: "refusal"，而不是錯誤。如需背景資訊，請參閱防護措施、警告和申訴。



定價

Claude Sonnet 5 的定價為每百萬輸入 token 3 美元、每百萬輸出 token 15 美元，與 Claude Sonnet 4.6 相同。由於新的 tokenizer 對相同文字產生的 token 數量多約 30%，即使每個 token 的定價不變，等效請求的成本仍可能與 Claude Sonnet 4.6 不同。確切的增加幅度取決於內容和工作負載的形態。

每百萬輸入/輸出 token 2 美元/10 美元的推廣定價有效期至 2026 年 8 月 31 日，之後將採用每百萬輸入/輸出 token 3 美元/15 美元的標準定價。

如需完整定價，包括批次處理和提示快取費率，請參閱定價。



可用性

在發布時，Claude Sonnet 5 可在以下平台使用：

• Claude API： 所有客戶皆可使用。
• AWS： 可透過 Claude in Amazon Bedrock 和 Claude Platform on AWS 使用。Claude Sonnet 5 不適用於 Claude on Amazon Bedrock（舊版）（InvokeModel 和 Converse API）。
• Google Cloud： 可透過 Claude on Google Cloud 使用。
• Microsoft Foundry： 可透過 Claude in Microsoft Foundry 使用。

Claude Sonnet 5 為擁有 ZDR 協議的組織支援零資料保留。



遷移指南

Claude Sonnet 5 是 Claude Sonnet 4.6 的直接替代品。請更新您的模型 ID：

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

然後檢視以下事項：

1. Token 預算和計數： 新的 tokenizer 對相同文字產生的 token 數量多約 30%。確切的增加幅度取決於內容和工作負載的形態。請使用 token 計數重新計算提示，並重新檢視接近您預期輸出長度的 max_tokens 限制。
2. 擴展思考： 如果您仍在設定 budget_tokens，請遷移至自適應思考。手動擴展思考（thinking: {type: "enabled"}）不受支援，並會回傳 400 錯誤。
3. 取樣參數： 將取樣參數（temperature、top_p、top_k）設定為非預設值的請求會回傳 400 錯誤；遷移時請移除它們。工具定義和回應結構不變，且助手訊息預填在 Claude Sonnet 4.6 上已不受支援。

如需詳細資訊，請參閱遷移指南的 Claude Sonnet 5 章節。



後續步驟