---
title: Claude Sonnet 5.5 的新功能
url: https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5
description: 從 Claude Sonnet 5 遷移到 Claude Sonnet 5.5 時有哪些變化：破壞性變更、功能支援、行為差異、定價與可用性。
---
Claude Sonnet 5.5 提供速度與智慧的最佳組合。有五項「breaking changes」（破壞性變更）會影響已在 Claude Sonnet 5 上執行的程式碼：
* [使用 `between_tools` 關閉預先思考](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking)。
* [強制工具使用會傳回錯誤](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#forced-tool-use-is-not-supported)。
* [思考區塊與模型及對話綁定](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。
* [在 Claude API 和 Google Cloud 上，不再接受較早的 `computer_20251124` 電腦使用工具](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported)。
* [顧問工具拒絕以 Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 和 Claude Haiku 5.5 作為顧問](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings)。
另有一項變更會改變回應的結構，但不會導致任何請求失敗：[工具呼叫之間的文字會以 `thinking` 區塊傳回](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#text-between-tool-calls)。若應用程式會將這些文字串流給使用者，則在工具呼叫之間將不會有任何輸出，直到它設定會傳回文字的 `display` 值，或使用 `between_tools` 關閉預先思考為止。
## 新模型
| 模型 | Claude API ID | 說明 |
| ----------------- | ----------------- | ---------- |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 速度與智慧的最佳組合 |
「[Adaptive thinking](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking)」（自適應思考）預設為開啟，而「[effort parameter](https://platform.claude.com/docs/zh-TW/build-with-claude/effort)」（努力程度參數）控制思考的深度。它在 Claude API 上的預設值為 `high`。「Tokenizer」（分詞器）與 Claude Sonnet 5 相同，因此相同的文字會產生相同的 token 數量。關於「context window」（上下文視窗）、輸出限制、知識截止日期和價格，請參閱 [Claude Sonnet 5.5 模型頁面](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/overview)。
如需所有目前的模型，請參閱[模型概覽](https://platform.claude.com/docs/zh-TW/models/overview)。
## 破壞性變更
### 使用 `between_tools` 關閉預先思考
若要在 Claude Sonnet 5.5 上關閉「up-front thinking」（預先思考），請傳送 `thinking: {"type": "between_tools"}`，而非 `"disabled"`。這是此模型上最低的思考設定。所有提供 Claude Sonnet 5.5 的平台皆可使用此設定，且不需要 beta 標頭。模型在工具呼叫之間撰寫的簡短「[progress updates](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking#progress-updates)」（進度更新）仍會以 `thinking` 區塊的形式傳回，並附帶其摘要文字。請將這些區塊連同助理回合的其餘內容原封不動地傳回。您傳回的進度更新區塊會提供模型它所撰寫的完整筆記，而非摘要。如果您的請求未使用工具，回應將只包含文字，與在 Claude Sonnet 5 上使用 `disabled` 時相同。
在 Claude Sonnet 5.5 上，傳送 `thinking: {"type": "disabled"}` 的請求會傳回 400 `invalid_request_error`，其訊息會指向 `between_tools`。
`between_tools` 可在 `low`、`medium` 和 `high` 努力程度下使用。在 `xhigh` 或 `max` 努力程度下，使用 `between_tools` 的請求會傳回 400 錯誤。若要以 `xhigh` 或 `max` 執行，請使用自適應思考：省略 `thinking` 欄位，或傳送等效的 `thinking: {"type": "adaptive"}`。使用 `between_tools` 時，努力程度無法在對話中途變更：與目前生效層級不同的[逐訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#change-effort-mid-conversation-beta) `output_config.effort` 會傳回 400 錯誤。若要在每個回合使用不同的努力程度，請使用自適應思考。
`between_tools` 不接受其他欄位：與其一同傳送的 `display`、`budget_tokens` 或 `block_binding` 會傳回 400 錯誤。手動思考預算（`thinking: {"type": "enabled", "budget_tokens": N}`）會傳回 400 錯誤。請參閱[思考](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking)以及遷移指南中的[變更前後對照](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide#turn-off-up-front-thinking)。
### 不支援強制工具使用
Claude Sonnet 5.5 不支援「forced tool use」（強制工具使用）。將 `tool_choice` 設為 `{"type": "any"}` 或 `{"type": "tool", "name": "..."}` 會傳回 400 `invalid_request_error`：
```text wrap
tool_choice: type "tool" and "any" are not supported for this model.
```
支援 `tool_choice: {"type": "auto"}`（預設值）和 `{"type": "none"}`。相同的檢查也適用於 [token 計數](https://platform.claude.com/docs/zh-TW/build-with-claude/token-counting)端點。若要取得符合結構描述的工具輸入，請保留 `tool_choice: {"type": "auto"}`，並透過[嚴格工具使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/strict-tool-use)設定 `strict: true`，或將結構描述移至[結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs)。若要讓模型呼叫工具而非以文字回覆，請在提示中說明何時適用該工具。遷移指南中提供了[變更前後對照](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide#forced-tool-use)。
### 思考區塊與模型及對話綁定
每個思考區塊都會記錄產生它的模型。每個模型都能讀取自己的區塊，但只能讀取部分其他模型的區塊。Claude Sonnet 5.5 可讀取來自 Claude Sonnet 5、Claude Opus 4.8、Claude Haiku 4.5 及更早模型的思考區塊，在 Claude API 和 Google Cloud 上也可讀取來自 Claude Haiku 5.5 的思考區塊，但無法讀取來自 Claude Opus 5、Claude Opus 5.5 或任何 Claude Fable 或 Claude Mythos 模型的思考區塊。在 Claude API 和 Google Cloud 上，Claude Opus 5.5 可讀取 Claude Sonnet 5.5 的思考區塊；其他模型皆無法讀取。
因此，從 Claude Sonnet 5 轉移到 Claude Sonnet 5.5 的對話，或在 Claude API 和 Google Cloud 上從 Claude Sonnet 5.5 升級到 Claude Opus 5.5 的對話，會保留其推理內容；而任何其他離開 Claude Sonnet 5.5 的轉移，在切換後的回合中都不會帶有這些推理內容。當請求帶有目標模型無法讀取的區塊時，API 會在模型看到之前將其捨棄：請求會成功，且被捨棄的區塊不會計費。使用 `thinking-binding-controls-2026-08-01` beta 標頭時，捨棄情況會在頂層的 `input_transformations` 陣列中回報。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。
API 也會檢查 Claude Sonnet 5.5 思考區塊之前的任何內容，自該區塊產生以來是否有所變更：包括 `system` 提示、`tools` 或較早的訊息。對於在 2026 年 8 月 31 日 00:00 UTC 當天或之後建立的帳戶，此檢查在 Claude API、Amazon Bedrock 和 Google Cloud 上預設會強制執行。在這些帳戶上，於此類變更後重播區塊的請求會傳回 400 錯誤。若要改為捨棄受影響的區塊，請傳送 `thinking-binding-controls-2026-08-01` beta 標頭，並將 `thinking.block_binding.prefix_mismatch_behavior` 設為 `"drop_block"`。在較舊的帳戶上，將該欄位設為任一值都會讓請求選擇加入此檢查。`block_binding` 僅適用於 `thinking: {"type": "adaptive"}`。使用 `between_tools` 時，請讓歷史記錄保持僅附加，或從被編輯的回合起移除思考區塊。
請讓對話保持僅附加，這樣檢查就永遠不會失敗：使用[對話中途的系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)來變更指示或工具，而非進行編輯。請參閱[保留思考](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking)以及遷移指南中[關於此變更的說明](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide#thinking-blocks)。
### Claude API 和 Google Cloud 上不支援 `computer_20251124` 電腦使用工具
在 Claude API 和 Google Cloud 上，Claude Sonnet 5.5 僅透過 `computer_toolset_20260801` 工具集支援「[computer use](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool)」（電腦使用）。宣告較早的 `computer_20251124` 工具的請求會傳回 400 `invalid_request_error`。在 Claude API 上，訊息會指出被拒絕的類型，接著列出模型接受的工具類型。其開頭如下：
```text wrap
'claude-sonnet-5-5' does not support tool types: computer_20251124.
```
在 Amazon Bedrock 上，Claude Sonnet 5.5 接受較早的 `computer_20251124` 工具。
若要遷移在 Claude API 或 Google Cloud 上的現有整合，請依照[從 `computer_20251124` 遷移](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)操作，其中展示了變更前後的請求。移除 beta 標頭，將 `tools` 項目替換為 `{"type": "computer_toolset_20260801"}`，並更新您的代理迴圈以處理成員 `tool_use` 區塊、批次動作以及結果上的 `toolset_name`。此工具集可在 Claude API 和 Google Cloud 上使用。關於其他平台，請參閱電腦使用工具的[相容性](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool#compatibility)章節。已使用此工具集的整合以及[瀏覽器使用工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/browser-use-tool)無需變更。
### 不支援部分顧問工具配對
使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（beta）時，Claude Sonnet 5.5 執行者需要以 Claude Mythos 5.1、Claude Fable 5.1、Claude Mythos 5、Claude Fable 5、Claude Opus 5.5 或 Claude Opus 5 作為其顧問，或以 Claude Sonnet 5.5 本身作為顧問。Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 和 Claude Haiku 5.5 顧問可搭配 Claude Sonnet 5 執行者使用，但搭配 Claude Sonnet 5.5 執行者時會傳回 400 `invalid_request_error`。Claude Sonnet 5.5 接受的每個顧問都會以加密形式傳回其建議，作為 `advisor_redacted_result` 區塊，因此您的用戶端無法讀取建議文字。請參閱顧問工具的[模型相容性](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool#model-compatibility)和[結果變體](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool#result-variants)。
## 功能支援
Claude Sonnet 5.5 支援[逐訊息努力程度](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#change-effort-mid-conversation-beta)（beta）、[對話中途的系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)、[對話中途的工具變更](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages#mid-conversation-tool-changes)（beta）、最低可快取提示為 512 個 token 的「[prompt caching](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching)」（提示快取）、「[batch processing](https://platform.claude.com/docs/zh-TW/build-with-claude/batch-processing)」（批次處理）、[Files API](https://platform.claude.com/docs/zh-TW/build-with-claude/files)、[PDF 支援](https://platform.claude.com/docs/zh-TW/build-with-claude/pdf-support)、[視覺](https://platform.claude.com/docs/zh-TW/build-with-claude/vision)，以及伺服器端和用戶端[工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/overview)。逐訊息努力程度、對話中途的系統訊息和對話中途的工具變更在 Claude Sonnet 5 上無法使用，而 Claude Sonnet 5 的最低可快取提示為 1,024 個 token。在 Claude API 和 Google Cloud 上，電腦使用需要 `computer_toolset_20260801` 工具集（請參閱[破壞性變更](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported)）。關於模型可用性，請參閱各功能的頁面。
### 隨需壓縮（beta）
使用 `compact-2026-09-04` beta 標頭時，傳送頂層 `compaction` 參數的請求會傳回一個已簽署的 `compaction` 區塊，其中摘要了整個對話。接著，您將該區塊放在最前面傳送，以取代被摘要的訊息。您可以自行選擇何時壓縮，而在符合[壓縮與保留思考](https://platform.claude.com/docs/zh-TW/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)中所述條件的情況下，您保留的回合中的思考區塊在替換後仍可保持有效。這在 Claude Sonnet 5.5 上很重要，因為其[思考區塊與對話綁定](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。關於平台可用性和完整的請求流程，請參閱[隨需壓縮](https://platform.claude.com/docs/zh-TW/build-with-claude/compaction-on-demand)。
### 在訊息中定義工具（beta）
使用 `inline-tools-2026-09-15` beta 標頭時，對話中途系統訊息中的 `tool_addition` 區塊可以攜帶完整的工具定義，而非參照。您可以在對話中途新增工具、變更其結構描述，或將伺服器工具移至較新版本，而無需編輯 `tools`，也不會失去提示快取。請參閱[在訊息中定義工具](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta)。
### 思考區塊僅限於產生它們的帳戶
Claude Sonnet 5.5 產生的思考區塊僅能在產生它們的帳戶中使用，或在與其連結的帳戶中使用。當其他帳戶傳送這些區塊之一時，API 會在模型看到之前將該區塊捨棄，且請求會成功。在 Claude API 和 Google Cloud 上，使用 `thinking-binding-controls-2026-08-01` beta 標頭時，回應會在 `input_transformations` 中列出每個被捨棄的區塊，並附上 `reason: "organization_binding_mismatch"`。來自較早模型的區塊不受影響。請參閱[保留思考](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。
## 行為差異
Claude Sonnet 5.5 與 Claude Sonnet 5 在幾個方面有所不同，這些差異無需任何程式碼變更就會顯現。[為 Claude Sonnet 5.5 撰寫提示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5)針對每一項提供了指引：
* **努力程度已重新校準。** 某個[努力程度](https://platform.claude.com/docs/zh-TW/build-with-claude/effort)層級所產生的思考量與在 Claude Sonnet 5 上不同。請重新執行您的努力程度測試，而非沿用原有設定。除非您的工作負載屬於代理型或對延遲敏感，否則請從 `high` 開始。對於代理型程式設計和多步驟工具使用，明確定義的任務請從 `medium` 開始，較困難或較長的任務則改用 `high`。對於聊天和其他對延遲敏感的工作，請從 `medium` 或 `low` 開始。
* **工具呼叫之間的文字會以思考區塊傳回。** 在工具呼叫之間，長度超過一兩句的筆記會以[進度更新 `thinking` 區塊](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking#progress-updates)的形式傳回。較短的評論則維持為 `text`。在預設的 `display: "omitted"` 下，進度更新區塊的文字為空，因此會將這些筆記串流給使用者的應用程式在工具呼叫之間將不會有任何輸出，且不會出現錯誤。如果您[使用 `between_tools` 關閉預先思考](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking)，文字就會傳回。[遷移指南](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide#text-between-tool-calls)說明了如何接收這些文字。
* **安全防護類別。** 模型的安全防護機制可能會以五種 [`stop_details` 類別](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#refusal-response)拒絕請求。`"cyber"` 表示該請求可能促成網路危害。`"bio"` 表示它可能促成生物危害。`"frontier_llm"` 表示它可能協助開發競爭性的 AI 模型。`"reasoning_extraction"` 表示它要求模型在回應文字中重現其內部推理。`"general_harms"` 表示它屬於其他使用政策領域。請參閱[拒絕、備援與計費](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#refusals-fallback-and-billing)。
## 拒絕、備援與計費
[拒絕與備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)中的所有內容皆適用於 Claude Sonnet 5.5。被拒絕的請求會傳回 HTTP 200，並附帶 `stop_reason: "refusal"` 以及指出政策領域的 [`stop_details`](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#refusal-response) 物件。請處理拒絕情況並設定備援。[伺服器端備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#server-side-fallback)（`fallbacks: "default"`，beta 版，適用於 Claude API）會在 Claude Sonnet 5 上重試 `"cyber"` 和 `"frontier_llm"` 拒絕。它不會重試 `"bio"`、`"reasoning_extraction"` 或 `"general_harms"` 拒絕。您也可以使用 [SDK 中介軟體](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#client-side-fallback)或您自己的重試機制。在任何輸出之前發生的拒絕是否計費取決於其拒絕類別，且無論如何都會計入您的速率限制。請參閱[拒絕如何計費](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#how-refusals-are-billed)。
## 定價
Claude Sonnet 5.5 的價格與 Claude Sonnet 5 相同，但提示快取讀取除外，其費用為每百萬 token $0.10 美元，是 Claude Sonnet 5 費率的一半。關於完整清單、資料駐留和工具定價，請參閱[定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。
## 可用性
Claude Sonnet 5.5 可在以下平台使用：
* **Claude API：** 所有客戶，模型 ID 為 `claude-sonnet-5-5`。
* **AWS：** [Amazon Bedrock 中的 Claude](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock)，模型 ID 為 `anthropic.claude-sonnet-5-5`，以及 [AWS 上的 Claude Platform](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)，模型 ID 為 `claude-sonnet-5-5`。
* **Google Cloud：** [Google Cloud 上的 Claude](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-vertex-ai)，模型 ID 為 `claude-sonnet-5-5`。
* **Microsoft Foundry：** [Microsoft Foundry 中的 Claude](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry)，模型 ID 為 `claude-sonnet-5-5`。
## 從 Claude Sonnet 5 遷移
更新您的模型 ID：
```python Python
model = "claude-sonnet-5" # Before
model = "claude-sonnet-5-5" # After
```
```typescript TypeScript
let model = "claude-sonnet-5"; // Before
model = "claude-sonnet-5-5"; // After
```
```csharp C#
var model = Model.ClaudeSonnet5; // Before
model = Model.ClaudeSonnet5_5; // After
```
```go Go
model := anthropic.ModelClaudeSonnet5 // Before
model = anthropic.ModelClaudeSonnet5_5 // After
```
```java Java
Model model = Model.CLAUDE_SONNET_5; // Before
model = Model.CLAUDE_SONNET_5_5; // After
```
```php PHP
$model = Model::CLAUDE_SONNET_5; // Before
$model = Model::CLAUDE_SONNET_5_5; // After
```
```ruby Ruby
model = Anthropic::Model::CLAUDE_SONNET_5 # Before
model = Anthropic::Model::CLAUDE_SONNET_5_5 # After
```
接著檢查六件事：
1. 如果您的程式碼使用 `disabled` 關閉思考，請改為傳送 `between_tools`，並使用 `high` 或更低的努力程度。
2. 將 `tool_choice` 類型 `any` 和 `tool` 替換為 `auto` 加上[嚴格工具使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/strict-tool-use)。
3. 讓對話保持僅附加。在編輯較早的歷史記錄後重播 Claude Sonnet 5.5 思考區塊的請求，可能會傳回 400 錯誤。請參閱[思考區塊與模型及對話綁定](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。
4. 如果您在 Claude API 或 Google Cloud 上透過 `computer_20251124` 使用電腦使用功能，請[改用工具集](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)。
5. 如果您搭配 Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 或 Claude Haiku 5.5 顧問使用顧問工具，請[切換至 Claude Sonnet 5.5 接受的顧問](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings)。
6. 如果您的介面會顯示工具呼叫之間的文字，請在使用自適應思考時設定 `thinking.display`。使用 `between_tools` 時，即使不設定，文字也會傳回。請參閱[工具呼叫之間的文字會以思考區塊傳回](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide#text-between-tool-calls)。
[遷移指南](https://platform.claude.com/docs/zh-TW/models/sonnet-5-5/migration-guide)提供從 Claude Sonnet 5 及更早模型遷移的逐步說明，以及完整的檢查清單。
## 後續步驟
所有目前 Claude 模型的完整規格與定價。
將程式碼從 Claude Sonnet 5 及更早模型遷移至 Claude Sonnet 5.5。
Claude Sonnet 5.5 特有的行為差異與提示模式。
控制 Claude 回應時使用的 token 數量，從 low 到 max。
自適應思考的運作方式，以及思考區塊如何被保留。
處理 `stop_reason: "refusal"` 並在其他模型上重試。