作者注：本文依據 2026-11-08（UTC+8）Anthropic 官方文檔與 2026-11-09 10:40 更新的 API易 Claude 思考參數指南整理，口徑覈對日期爲 2026-11-13，幫助你避開 claude-opus-5-5 與 claude-sonnet-5-5 在 thinking 參數上的 400 報錯。
如果你在 claude-opus-5-5 上把 thinking 的 type 傳成 disabled，接口會直接返回 400——這是 2026-11-08（UTC+8）Anthropic 官方文檔寫明的口徑。API易（apiyi.com）已在 2026-11-09 10:40 同步刷新了 Claude 思考參數指南，把兩個模型 ID 的正確寫法梳理清楚。本文快速解讀這一變化對 Claude API 調用方的影響。
這不是小道消息：兩個關鍵結論均以文檔爲準——claude-opus-5-5 無法關閉思考，只能降低 effort；claude-sonnet-5-5 關閉前置思考要改用 between_tools。
核心價值：3 分鐘瞭解兩個模型 ID 的正確寫法、between_tools 的參數邊界，以及 400 報錯的排查思路。
核心信息速覽：claude-opus-5-5 與 claude-sonnet-5-5 的 thinking 口徑
先看結論表，再逐條展開：
| 信息項 | 詳情 |
|---|---|
| 官方口徑 | 2026-11-08（UTC+8）Anthropic 官方文檔 |
| API易指南更新 | 2026-11-09 10:40，docs.apiyi.com 已同步 |
| claude-opus-5-5 | 不傳 thinking 即自適應思考；傳 disabled 返回 400 |
| claude-sonnet-5-5 | 不傳 thinking 同爲自適應思考；關閉前置思考用 between_tools |
effort 默認值 |
Opus 5.5 爲 medium，Sonnet 5.5 爲 high |
| 最大輸出 | 兩個模型 ID 均爲 128000，思考 token 計入其中 |
claude-opus-5-5 的口徑相當直接。請求中不傳 thinking 字段時，模型進入自適應思考，由它自行決定當次是否思考、思考多深；而一旦把 thinking 的 type 設爲 disabled，接口不會靜默忽略，而是直接返回 400。換句話說，這個模型 ID 沒有關閉思考的開關，文檔給出的唯一調節手段是降低 effort，默認檔位爲 medium。
claude-sonnet-5-5 的處境略有不同。它同樣支持不傳 thinking 的自適應思考，但多了一條官方認可的關閉路徑：把 type 設爲 between_tools，即可關閉前置思考，只保留工具調用之間的進度更新。這條路徑的邊界同樣寫得清楚，建議直接對照下表：
| 約束項 | 文檔口徑 |
|---|---|
effort 取值 |
只接受 low、medium、high |
| 檔位上限 | 不能高於 high |
| 搭配限制 | 不能同時攜帶 display 或 budget_tokens |
| 實際效果 | 關閉前置思考，僅保留工具調用之間的進度更新 |
還有一個容易被忽略的細節：思考 token 會計入 max_tokens。兩個模型 ID 的最大輸出都是 128000，如果請求把 max_tokens 壓得太低，思考可能先喫掉大半預算，正文隨之被截斷。排查“回覆莫名變短”的問題時，值得先確認思考的佔用情況。
配圖說明：圖中調用鏈路以 API易 apiyi.com 的 Anthropic 原生格式網關爲例。走 Anthropic 格式時，base 地址是 https://api.apiyi.com，注意不要寫成帶 /v1 的形式。
影響分析：disabled 報 400 波及哪些調用方
這次口徑變化對調用方的影響集中在報錯處理、參數組合與預算規劃三處，逐項拆開看會更直觀。
對存量代碼的影響：disabled 寫法的遷移
| 場景 | 舊寫法 | 現在的結果 | 正確做法 |
|---|---|---|---|
| claude-opus-5-5 想關思考 | type 傳 disabled |
返回 400 | 無法關閉，只能降低 effort |
| claude-sonnet-5-5 想關前置思考 | type 傳 disabled |
返回 400 | 改用 between_tools |
| 想精細控制思考預算 | between_tools 搭配 budget_tokens |
組合不被接受 | 二者不可同傳，改用 effort 三檔 |
| 擔心思考擠佔輸出 | 把 max_tokens 設得很小 |
正文被截斷 | 思考計入 max_tokens，預留餘量 |
第一重影響是參數組合的約束變多。between_tools 不能與 budget_tokens 或 display 同時出現，意味着想精細控制思考預算的做法在這條路徑上失效，只能靠 low、medium、high 三檔間接調控。疊加“思考 token 計入 max_tokens”這條規則，調用方需要在 effort 與 max_tokens 之間重新找平衡。
第二重影響是分支邏輯要更新。如果腳本按模型 ID 決定是否傳 disabled，遇到這兩個 ID 就要走分支：前者接受“關不掉”的現實，用 effort 降檔；後者切換到 between_tools。把這類分支集中到一處配置裏維護，後續口徑再變時改動面最小。
順帶一提，同頁還寫明 Fable 5.1 和 Fable 5 傳 disabled 同樣會 400，一樣關不掉；Haiku 5.5 和 Opus 5 則在 effort 不高於 high 時仍可使用 disabled。如果代碼同時服務多個模型 ID，建議按模型維護一張開關矩陣，而不是全局套用同一個寫法。
對成本結構的影響：thinking token 與用量
claude-sonnet-5-5 在 API易（apiyi.com）總表的計價爲輸入 $2、輸出 $10、緩存讀 $0.1。由於思考 token 計入 max_tokens，是否關閉前置思考、選哪一檔 effort，都會直接反映在 token 用量上。高頻調用場景下這點差距會被放大，改代碼時值得順手算一筆賬。
配圖說明：口徑整理自 2026-11-08 官方文檔，可在 API易 apiyi.com 文檔中心對照原文覈實。
| 模型 ID | disabled 可用性 |
文檔口徑 |
|---|---|---|
| claude-opus-5-5 | 不可用，返回 400 | 關不掉思考，只能降 effort（默認 medium） |
| claude-sonnet-5-5 | 不可用，返回 400 | 改用 between_tools（默認 high） |
| Fable 5.1 / Fable 5 | 不可用，返回 400 | 同樣關不掉 |
| Haiku 5.5 / Opus 5 | effort 不高於 high 時可用 |
舊寫法僅在這兩個 ID 上成立 |
如何快速驗證 claude-sonnet-5-5 的 between_tools
改動上線前，建議先用小流量驗證行爲差異。在 API易（apiyi.com）註冊並獲取 API Key，新用戶有免費測試額度；請求發往 https://api.apiyi.com，在請求體裏把 thinking 的 type 設爲 between_tools，effort 在三檔中任選其一，先跑一輪，再對比不傳 thinking 的自適應模式，觀察輸出結構與 token 用量的變化。
🚀 快速驗證建議：通過 API易 apiyi.com 獲取免費測試額度，用同一組提示詞分別跑
between_tools與自適應兩種模式，確認差異後再改存量代碼。平臺支持 Claude、OpenAI、Gemini 等主流模型的統一調用，OpenAI 兼容接口按量計費，方便橫向對比與切換。
常見問題 FAQ：disabled、between_tools 與 400 報錯
Q1：claude-opus-5-5 到底能不能關閉思考？
不能。2026-11-08 的官方口徑寫明：傳 `disabled` 會返回 400，這個模型 ID 沒有關閉思考的開關，只能通過 `effort` 降低思考深度，默認檔位是 `medium`。如果場景必須完全無思考，只能更換模型 ID。
Q2：claude-sonnet-5-5 的 between_tools 可以搭配 budget_tokens 嗎？
不可以。文檔明確寫了 `between_tools` 不能同時攜帶 `display` 或 `budget_tokens`，對應的 `effort` 只接受 `low`、`medium`、`high` 三檔且不能高於 `high`。想精細控制思考預算，只能退回自適應模式或更換模型 ID。
Q3：爲什麼我的 Claude 請求突然返回 400？
先檢查請求體裏是否把 `thinking` 的 `type` 設成了 `disabled`——在 claude-opus-5-5 與 claude-sonnet-5-5 上，這是文檔寫明的觸發條件。確認後按本文對照表處理：前者降 `effort`，後者切 `between_tools`。適用寫法以 2026-11-08（UTC+8）官方文檔爲準，API易頁面已於 2026-11-09 10:40 同步。
Q4：如何快速驗證 claude-sonnet-5-5 的 between_tools 效果？
在 API易（apiyi.com）註冊賬號並獲取 API Key，新用戶有免費測試額度。請求發往 `https://api.apiyi.com`，把 `thinking` 的 `type` 設爲 `between_tools`、`effort` 任選一檔，跑一輪即可對比出與自適應模式的差異。
Q5：思考 token 會不會擠佔輸出預算？
會。思考 token 計入 `max_tokens`，兩個模型 ID 的最大輸出均爲 128000。請求中把 `max_tokens` 設得太低時，思考可能先消耗預算、正文被截斷，建議爲正文預留足夠空間。
claude-opus-5-5 與 claude-sonnet-5-5 核心要點 Key Takeaways
- claude-opus-5-5 關不掉思考：傳
disabled直接 400，只能用effort降檔，默認medium。 - claude-sonnet-5-5 改用
between_tools：關閉前置思考，只保留工具調用之間的進度更新。 - 三條參數紅線：
effort僅low、medium、high，不能高於high，禁配display與budget_tokens。 - 預算規則：思考 token 計入
max_tokens，兩個 ID 上限均爲 128000。 - 驗證入口：API易 apiyi.com，Anthropic 格式 base 爲
https://api.apiyi.com，不要加/v1。
總結：避開 400 的三個動作
claude-opus-5-5 與 claude-sonnet-5-5 的口徑可以濃縮成三句話：
- claude-opus-5-5：傳
disabled會 400，思考關不掉，只能降低effort。 - claude-sonnet-5-5：關閉前置思考改用
between_tools，三檔effort，禁配display與budget_tokens。 - 預算：思考 token 計入
max_tokens，上限 128000，爲正文留餘量。
如果你正被這個 400 卡住，推薦先到 API易 apiyi.com 用免費測試額度跑一輪 between_tools，確認行爲後再修改存量代碼。平臺一個 API Key 即可調用 OpenAI、Claude、Gemini 等主流模型，按量計費，適合快速對比與切換。
📚 參考資料
- API易 Claude 思考參數指南：effort 與 thinking 的適用寫法
- 鏈接：
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
說明：2026-11-09 10:40 更新的版本，本文主要事實來源
-
API易 指南刷新動態：本輪口徑同步的官方說明
- 鏈接：
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
說明：記錄與 2026-11-08 官方文檔對齊的過程
-
Anthropic 官方文檔：thinking 參數的原始口徑
- 鏈接：
docs.anthropic.com - 說明：建議對照閱讀，確認最新寫法
作者：API易 技術團隊
技術交流：歡迎在 API易 網站首頁聯繫我們，更多資料可訪問 docs.apiyi.com 文檔中心
