Claude Opus 5.5 的新功能

Claude Opus 5.5 專為長時間執行的代理式程式設計與知識工作而打造，定價為每百萬輸入／輸出 token $4 / $20 美元。有四項重大變更會影響已在 Claude Opus 5 上執行的程式碼：無法停用思考、強制工具使用會傳回錯誤、思考區塊與模型及對話綁定，以及在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，不再接受較早的 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 參數是控制思考深度、延遲與成本的機制：在您先前停用思考之處，請改為調低 effort；針對成本與智慧進行最佳化提供了選擇等級的實測結果。由於每個回應都可能以一個或多個 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 API 和 Claude Models on Google Cloud (Google managed) 上還可讀取來自 Claude Sonnet 5.5 與 Claude Haiku 5.5 的思考區塊，但無法讀取 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 當天或之後建立的帳戶，API 在 Claude API 和雲端平台上預設會強制執行此檢查。在這些帳戶上，於此類變更之後重新傳送區塊的請求會傳回 400 錯誤。若要改為捨棄受影響的區塊，請傳送 thinking-binding-controls-2026-08-01 beta 標頭，並將 thinking.block_binding.prefix_mismatch_behavior 設為 "drop_block"。在較舊的帳戶上，將該欄位設為任一值即可讓請求選擇加入。請讓對話保持僅附加的方式，就不會發生此問題：使用對話中途的系統訊息來變更指示或工具，而非進行編輯。請參閱保留的思考以及遷移指南中的思考區塊說明。

Claude API 和 Claude Models on Google Cloud (Google managed) 不支援 computer_20251124 電腦使用工具

Claude Opus 5 同時接受以 computer_toolset_20260801 工具集形式，以及搭配 computer-use-2025-11-24 beta 標頭以較早的 computer_20251124 工具形式使用電腦使用。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，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 或 Claude Models on Google Cloud (Google managed) 上的現有整合，請依照從 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 的「prompt caching」（提示快取）、批次處理、Files API、PDF 支援、視覺，以及伺服器端與用戶端工具。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，電腦使用需要 computer_toolset_20260801 工具集（請參閱電腦使用重大變更）。關於模型可用性，請參閱各功能的頁面。

快速模式

快速模式可在 Claude API、Claude Models on Google Cloud (Anthropic managed)，以及託管於 Azure 的部署之 Claude in Microsoft Foundry 上用於 Claude Opus 5.5。在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上，請在您的請求中設定 speed: "fast"。Claude Opus 5.5 不需要 beta 標頭。關於支援的模型、速率限制與定價，請參閱快速模式。

在訊息中定義工具（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" 下，將這些文字串流給使用者的應用程式在工具呼叫之間會沒有任何輸出，且不會出現錯誤。遷移指南說明了如何接收工具呼叫之間的文字，而面向使用者的進度更新則說明如何要求更多此類更新。
• 更多防護類別。 除了網路安全分類器之外，此模型還執行生物安全分類器。與 Claude Opus 5 相同，促使模型在回應文字中重現其內部推理的請求可能會以 reasoning_extraction 類別被拒絕。請參閱 Claude Opus 5.5 中的拒絕與備援以及防護拒絕。
• 更精準地解讀圖表、示意圖與螢幕截圖。 此模型無需工具即可更精確地從密集圖表與依賴版面配置的視覺內容中讀取數值，因此為早期模型建立的提示端視覺變通方法可能不再需要；對於最密集的輸入，影像工具仍能提升準確度。請參閱處理複雜視覺輸入的工具。

如果您的 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 分鐘快取寫入為 $5 美元、1 小時快取寫入為 $8 美元，快取讀取為每百萬 token $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 Models on Google Cloud (Anthropic managed)，模型 ID 為 claude-opus-5-5；以及 Claude Models on Google Cloud (Google managed)，模型 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 或 Claude Models on Google Cloud (Google managed) 上透過 computer_20251124 使用電腦使用功能，請改用工具集。如果您的介面會顯示工具呼叫之間的文字，也請設定 thinking.display；請參閱工具呼叫之間的文字會以思考區塊傳回。關於從 Claude Opus 5 及更早模型遷移的逐步說明與完整檢查清單，請參閱遷移指南。

後續步驟