Claude Sonnet 5 的新功能

Claude Sonnet 5 是 Anthropic Sonnet 模型系列的新一代產品。它是 Claude Sonnet 4.6 的直接升級版本，包含三項行為變更：adaptive thinking（自適應思考）預設為開啟、手動擴展思考現在會回傳 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"}



新的分詞器

Claude Sonnet 5 使用新的分詞器。相同的輸入文字會產生比 Claude Sonnet 4.6 多約 30% 的 token。確切的增幅取決於內容。這不是 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 定價低於 Claude Sonnet 4.6（請參閱定價），但由於相同文字會產生更多 token，等量請求的成本不會按比例直接下降。



繼承自 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 $2、每百萬輸出 token $10，每 token 定價低於 Claude Sonnet 4.6 的 $3/$15。由於新的分詞器對相同文字會產生約 30% 更多的 token，與 Claude Sonnet 4.6 相比時，等量請求的成本不會按每 token 價格的比例直接下降。確切的差異取決於內容和工作負載型態。

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



可用性

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

• **Claude API：**所有客戶皆可使用。
• **AWS：**可透過 Claude in Amazon Bedrock 和 Claude Platform on AWS 使用。在 Amazon Bedrock 上，Claude Sonnet 5 也可透過 InvokeModel API 存取，由與 Claude in Amazon Bedrock 相同的基礎架構提供服務。舊版的 Claude on Amazon Bedrock（Opus 4.6 及更早版本）整合不包含 Claude Sonnet 5。
• **Google Cloud：**可透過 Claude on Google Cloud 使用。
• **Microsoft Foundry：**可透過 Claude in Microsoft Foundry 使用。

對於簽有 ZDR 協議的組織，Claude Sonnet 5 支援零資料保留。



遷移指南

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

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

然後檢視以下項目：

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

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



後續步驟