Claude Opus 5.5 的新功能

Claude Opus 5.5 專為長時間執行的「agentic coding」（代理式程式設計）與知識工作而打造，定價為每百萬輸入／輸出 token $4 / $20 美元。有四項「breaking changes」（重大變更）會影響已在 Claude Opus 5 上執行的程式碼：思考無法停用、強制工具使用會傳回錯誤、思考區塊與模型及對話綁定，以及在 Claude API 與 Google Cloud 上，不再接受較早的 computer_20251124 電腦使用工具。前三項同樣適用於 Claude Fable 5.1。另一項變更會改變回應的結構，但不會導致任何請求失敗：工具呼叫之間的文字會以 thinking 區塊傳回，且在預設的 display 設定下，這些區塊的文字為空。若應用程式會將這些文字作為進度更新串流給使用者，則在設定會傳回文字的 display 值之前，工具呼叫之間將不會有任何輸出。

新模型

「adaptive thinking」（自適應思考）始終開啟，而 effort 參數則控制思考深度；此模型的預設值為 medium。關於「context window」（上下文視窗）、輸出限制、知識截止日期與價格，請參閱 Claude Opus 5.5 模型頁面；關於所有現行模型，請參閱模型概覽。

重大變更

思考無法停用

在 Claude Opus 5 上，思考預設為開啟，且在 effort 為 high 或以下時接受 thinking: {"type": "disabled"}。在 Claude Opus 5.5 上，思考始終開啟：設定 thinking: {"type": "disabled"} 的請求，或使用 thinking: {"type": "enabled", "budget_tokens": N} 手動設定預算的請求，都會傳回 400 invalid_request_error。請省略 thinking 欄位，或傳送等效的 thinking: {"type": "adaptive"}。此變更不涉及任何 beta 標頭。

錯誤訊息如下：

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

effort 參數是控制思考深度、「latency」（延遲）與成本的方式：在您先前停用思考的地方，請改為調低此參數；針對成本與智慧進行最佳化提供了選擇等級的實測結果。由於每個回應都可能以一個或多個 thinking 區塊開頭（在預設的 display: "omitted" 下，這些區塊的 thinking 欄位為空），請依據內容區塊的 type 欄位而非位置來選取區塊，並在工具使用迴圈中原封不動地傳回 thinking 區塊。已在 Claude Opus 5 上以開啟思考方式執行的程式碼無需變更。請參閱思考以及遷移指南中的變更前後對照。

不支援強制工具使用

Claude Opus 5.5 不支援「forced tool use」（強制工具使用）。將 tool_choice 設為 {"type": "any"} 或 {"type": "tool", "name": "..."} 會傳回 400 invalid_request_error：

tool_choice: type "tool" and "any" are not supported for this model.

支援 tool_choice: {"type": "auto"}（預設值）與 {"type": "none"}，且相同的驗證也適用於 token 計數端點。若需要符合結構描述的 JSON，請保留 tool_choice: {"type": "auto"} 並透過嚴格工具使用設定 strict: true，或將結構描述移至結構化輸出。若要讓模型呼叫工具而非以文字回覆，請在提示中說明何時適用該工具。遷移指南中提供了變更前後對照。

思考區塊與模型及對話綁定

每個思考區塊都會記錄產生它的模型，而每個模型都能讀取自己的區塊，但只能讀取部分其他模型的區塊。Claude Opus 5.5 可讀取來自 Claude Opus 5 及更早的 Opus、Sonnet 與 Haiku 模型的思考區塊，但無法讀取來自 Claude Fable 或 Claude Mythos 模型的思考區塊。在 Claude API 上，Claude Fable 5.1 與 Claude Mythos 5.1 可讀取來自 Claude Opus 5.5 的思考區塊；其他模型則無法讀取。從 Claude Opus 5 轉移到 Claude Opus 5.5 的對話，或在 Claude API 上從 Claude Opus 5.5 升級到 Claude Fable 5.1 或 Claude Mythos 5.1 的對話，都會保留其推理內容。從 Claude Opus 5.5 轉移到上述兩者以外任何模型的對話，或從 Claude Fable 或 Claude Mythos 模型轉移到 Claude Opus 5.5 的對話，在切換後的回合中將不會帶有先前模型的推理內容。當請求中包含目標模型無法讀取的區塊時，API 會在模型看到之前將其捨棄：請求會成功，且被捨棄的區塊不會計費。使用 thinking-binding-controls-2026-08-01 beta 標頭時，捨棄情況會在頂層的 input_transformations 陣列中回報。請參閱在對話中途切換模型。

API 也會檢查 Claude Opus 5.5 思考區塊之前的任何內容（system 提示、tools 或較早的訊息）自該區塊產生以來是否有所變更。與 Claude Fable 5.1 相同，對於在 2026 年 8 月 31 日 00:00 UTC 當天或之後建立的帳戶，無論是在 Claude API 還是雲端平台上，此檢查預設都會強制執行。在這些帳戶上，於此類變更後重新傳送區塊的請求會傳回 400 錯誤。若要改為捨棄受影響的區塊，請傳送 thinking-binding-controls-2026-08-01 beta 標頭，並將 thinking.block_binding.prefix_mismatch_behavior 設為 "drop_block"。在較舊的帳戶上，將該欄位設為任一值都會讓該請求選擇加入此檢查。請讓對話保持僅附加的方式，從根本上避免此問題：使用對話中途系統訊息來變更指示或工具，而非進行編輯。請參閱保留思考以及遷移指南中的此變更說明。

Claude API 與 Google Cloud 不支援 computer_20251124 電腦使用工具

Claude Opus 5 同時接受以 computer_toolset_20260801 工具集形式，以及搭配 computer-use-2025-11-24 beta 標頭以較早的 computer_20251124 工具形式使用電腦使用。在 Claude API 與 Google Cloud 上，Claude Opus 5.5 僅支援工具集：宣告 computer_20251124 工具的請求會傳回 400 invalid_request_error。錯誤訊息會指出被拒絕的類型，接著在 Did you mean one of 之後列出模型接受的工具類型（其中包括 computer_toolset_20260801）；訊息開頭如下：

'claude-opus-5-5' does not support tool types: computer_20251124.

若要遷移 Claude API 或 Google Cloud 上的現有整合，請依照從 computer_20251124 遷移的說明操作：移除 beta 標頭，將 tools 項目替換為 {"type": "computer_toolset_20260801"}，並更新您的代理迴圈以處理成員 tool_use 區塊、批次動作，以及結果中的 toolset_name。在 Amazon Bedrock 上，較早的 computer_20251124 工具在 Claude Opus 5.5 上仍可如同在 Claude Opus 5 上一樣運作，因此無需變更。關於其他平台，請參閱電腦使用工具的相容性章節。已使用工具集的整合，以及瀏覽器使用工具，均無需變更。遷移指南中提供了請求的變更前後對照。

功能支援

Claude Opus 5.5 支援逐訊息 effort（beta）、對話中途系統訊息、任務預算、最低可快取提示為 512 個 token 的提示快取、批次處理、Files API、PDF 支援、視覺，以及伺服器端與用戶端工具。在 Claude API 與 Google Cloud 上，電腦使用需要 computer_toolset_20260801 工具集（請參閱重大變更）。關於模型可用性，請參閱各功能的頁面。

快速模式

快速模式（研究預覽）僅在 Claude API 上提供給 Claude Opus 5.5 使用；Amazon Bedrock、Claude Platform on AWS、Google Cloud 或 Microsoft Foundry 上均不提供。請搭配 fast-mode-2026-02-01 beta 標頭設定 speed: "fast"。關於存取權限、支援的模型與定價，請參閱快速模式。

在訊息中定義工具（beta）

使用 inline-tools-2026-09-15 beta 標頭時，對話中途系統訊息中的 tool_addition 區塊可以攜帶完整的工具定義而非參照，因此您可以在對話中途新增工具、變更其結構描述，或將伺服器工具移至較新版本，而無需編輯 tools，也不會失去提示快取。此功能適用於所有支援對話中途工具變更的模型，包括 Claude Opus 5.5。請參閱在訊息中定義工具。

隨需壓縮（beta）

使用 compact-2026-09-04 beta 標頭時，傳送頂層 compaction 參數的請求會傳回一個經過簽署、摘要整個對話的 compaction 區塊，接著您可以將其放在最前面傳送，以取代被摘要的訊息。此功能適用於支援壓縮的模型，包括 Claude Opus 5.5。您可以自行選擇何時進行壓縮，請求可以在背景執行，且您保留的回合中的思考區塊在替換後仍可保持有效（需符合壓縮與保留思考中的條件），這在 Claude Opus 5.5 上尤其重要，因為其思考區塊與對話綁定。關於平台可用性與完整的請求流程，請參閱隨需壓縮。

行為差異

Claude Opus 5.5 與 Claude Opus 5 在幾個方面有所不同，這些差異無需任何程式碼變更就會顯現。每一項在為 Claude Opus 5.5 撰寫提示 中都有相關指引：

• 預設 effort 為 medium。 省略 effort 的請求會以 medium 執行；在 Claude Opus 5 上則是以 high 執行。請明確設定 effort 並重新執行您的掃描測試；請參閱校準 effort。
• 在相同 effort 等級下，每回合的思考更多。 在相同的 effort 設定下，此模型每回合的思考往往比 Claude Opus 5 更多，在 xhigh 與 max 時尤其明顯。請重新執行您的 effort 掃描測試，而非沿用原有設定，並在 max_tokens 中為思考預留空間。請參閱校準 effort。
• 工具呼叫之間的文字會以思考區塊傳回。 模型在工具呼叫之間撰寫的簡短說明會以進度更新 thinking 區塊而非 text 區塊的形式傳回，因此在預設的 display: "omitted" 下，將這些內容串流給使用者的應用程式在工具呼叫之間將不會有任何輸出，且不會出現錯誤。遷移指南提供了接收這些內容的修正方式，而面向使用者的進度更新則說明如何要求模型提供更多此類更新。
• 更多防護類別。 除了網路安全分類器之外，此模型還會執行生物安全分類器，而促使模型在回應文字中重現其內部推理的請求，可能會以 reasoning_extraction 類別被拒絕。請參閱拒絕與備援以及安全防護拒絕。
• 更精準地解讀圖表、示意圖與螢幕截圖。 此模型在不使用工具的情況下，能更精確地從密集圖表與依賴版面配置的視覺內容中讀取數值，因此為較早模型所建立的提示端視覺變通方法可能不再需要；不過在最密集的輸入上，影像工具仍能提升準確度。請參閱用於複雜視覺輸入的工具。

如果您的 Claude Opus 5 整合是在停用思考的情況下執行，請參閱為停用思考而撰寫的提示以及重大變更。關於在代理式程式設計與程式碼審查、知識工作、溝通、視覺輸入及電腦使用方面的能力提升，請參閱與提示相關的功能。

拒絕與備援

Claude Opus 5.5 內建安全分類器，拒絕與備援中的所有內容均適用。被拒絕的請求會傳回 HTTP 200，並附帶 stop_reason: "refusal" 以及指出政策領域的 stop_details 物件，因此請處理拒絕情況並設定備援：透過伺服器端備援（fallbacks: "default"，目前為 beta，會在 Anthropic 針對該類別建議的模型上重試）、SDK 中介軟體或您自己的重試機制，在另一個模型上重試。

定價

Claude Opus 5.5 的費用為每百萬輸入 token $4 美元、每百萬輸出 token $20 美元，低於 Claude Opus 5 的 $5 與 $25；5 分鐘快取寫入為每百萬 token $5，1 小時快取寫入為 $8，快取讀取為 $0.20（基本輸入價格的 0.05 倍）。批次處理為半價：$2 與 $10。關於資料駐留與工具定價，請參閱定價。

可用性

Claude Opus 5.5 可在以下平台使用：

• Claude API： 所有客戶，模型 ID 為 claude-opus-5-5。
• AWS： Claude in Amazon Bedrock，模型 ID 為 anthropic.claude-opus-5-5；以及 Claude Platform on AWS，模型 ID 為 claude-opus-5-5。
• Google Cloud： Claude on Google Cloud，模型 ID 為 claude-opus-5-5。
• Microsoft Foundry： Claude in Microsoft Foundry，模型 ID 為 claude-opus-5-5。

從 Claude Opus 5 遷移

更新您的模型 ID：

model = "claude-opus-5"  # Before
model = "claude-opus-5-5"  # After

接著移除所有 thinking: {"type": "disabled"} 或 thinking: {"type": "enabled", ...} 設定，並改為選擇一個 effort 等級。將 tool_choice 類型 any 與 tool 替換為 auto 並搭配嚴格工具使用。如果您在 Claude API 或 Google Cloud 上透過 computer_20251124 使用電腦使用功能，請改用工具集。如果您的介面會顯示工具呼叫之間的文字，也請設定 thinking.display；請參閱工具呼叫之間的文字會在思考區塊中傳回。關於從 Claude Opus 5 及更早模型遷移的逐步說明與完整檢查清單，請參閱遷移指南。

後續步驟