作者注：claude-haiku-5-5 默認就會思考，想關掉卻報錯？多半是 effort 高於 high。本文講清規則、三步修復與參數邊界。
讓 claude-haiku-5-5 少思考、把輸出額度留給正文，是跑批處理和結構化任務時很常見的訴求。你可能已經把 thinking 設成了 disabled，結果接口卻返回了報錯：明明是想關掉思考，爲什麼反而被攔下來？本文將介紹 effort 與 disabled 的配合規則，幫助你快速掌握 claude-haiku-5-5 關閉思考的正確方法。
這不是玄學問題，也不是模型抽風。文檔記載得很清楚：claude-haiku-5-5 不傳 thinking 就是自適應思考，默認開啓；關閉思考用 thinking 的 type: disabled，但這個寫法只在 effort 不高於 high 時被接受。本文參數以 2026-11-08（UTC+8）的 Anthropic 官方文檔爲準，覈對日期爲 2026-11-13。
核心價值：讀完本文，你將弄清報錯的真實原因、三步修復方法，以及 max_tokens 和思考 token 的關係，之後無論在哪套環境裏調用，都不會再被這條規則絆住。
claude-haiku-5-5 核心要點
先把結論放前面，趕時間的讀者看這一節就夠了：
| 要點 | 文檔記載 | 對你的影響 |
|---|---|---|
| 默認開啓思考 | 不傳 thinking 就是自適應思考，默認開啓 |
想省額度必須顯式關閉 |
| 關閉開關 | thinking 設爲 type: disabled |
唯一的關閉方式 |
| effort 門檻 | 僅在 effort 不高於 high 時接受 disabled |
配 xhigh 或 max 會報錯 |
| effort 默認值 | 默認 medium，與 claude-opus-5-5 相同 |
不主動上調就不會踩坑 |
| 額度邊界 | 最大輸出 128000，思考 token 計入 max_tokens |
思考會擠佔正文空間 |
claude-haiku-5-5 重點詳解
第一，默認會思考。 claude-haiku-5-5 是默認帶着思考能力運行的模型：請求裏不出現 thinking 字段時，它按自適應思考運行。文檔沒有展開自適應模式的具體決策細節，但可以確定的是，默認狀態下思考就是開着的。
如果你的場景是短問答、批量打標、格式轉換這類不太需要深度推理的任務，思考 token 就是純開銷。文檔同時記載，思考 token 計入 max_tokens，最大輸出爲 128000，思考越多，留給正文的額度就越少。這正是“想關掉思考、把額度留給正文”這個訴求的由來。
第二，關閉有門檻。 關閉思考的唯一開關，是把 thinking 設爲 type: disabled。但文檔同時寫明，這個寫法只在 effort 不高於 high 時被接受：effort 爲 medium 或 high 時一切正常，一旦配成 xhigh 或 max，請求就會報錯。官方給的修復口徑也很直白——把 effort 降到 high 或以下。如果你是通過 API易 apiyi.com 調用 claude-haiku-5-5，排查這類報錯時同樣先從這對參數組合查起。
第三，默認值反而是安全的。 claude-haiku-5-5 的 effort 默認是 medium，和 claude-opus-5-5 一致，其餘多數模型默認是 high。容易踩坑的路徑通常是：從別的模型遷移代碼，習慣性地把 effort 顯式拉到 xhigh 或 max 去換質量，又順手加上 disabled 想控制成本，兩個意圖打架，報錯就來了。
反過來，只要不主動把 effort 向上傳，默認的 medium 天然滿足“不高於 high”的條件，disabled 可以正常生效。需要在不同型號之間做切換對比時，在 API易 apiyi.com 上用一個 API Key 調多個模型，也省得反覆改接入配置。
上面這張圖就是標準的排查路徑，最常見的情況卡在中間那個判斷框：effort 越界。修復之後，建議先用小額度在 API易 apiyi.com 上跑一遍驗證，確認返回正常，再放進生產流量。
claude-haiku-5-5 快速上手：三步修復
不需要翻長文檔，照下面三步做，這類報錯基本就能解決：
- 確認模型 ID：請求裏的
model應爲claude-haiku-5-5，先排除型號寫錯帶來的干擾。 - 把 effort 降下來：設爲
high或更低。medium是默認值，直接不傳也可以；關鍵是不要傳xhigh或max。 - 再關閉思考：把
thinking設爲{"type": "disabled"}。此時effort不高於high，請求會被正常接受。
claude-haiku-5-5 請求參數速查
| 參數 | 建議取值 | 說明 |
|---|---|---|
model |
claude-haiku-5-5 |
本文討論的型號，注意別寫成其他版本 |
thinking |
{"type": "disabled"} |
關閉思考的唯一開關 |
effort |
medium（默認）或 high |
必須不高於 high，否則與 disabled 衝突 |
effort 禁用值 |
xhigh、max |
與 disabled 組合會報錯 |
max_tokens |
上限 128000 | 思考 token 計入此值，關閉思考後可全留給正文 |
接入側的信息也不復雜，以 API易 爲例：
- 接入地址：
https://api.apiyi.com/v1 - 認證方式：一個 API Key 即可
- 接口風格：OpenAI 兼容接口
- 計費方式：按量計費、價格優惠，新用戶有免費測試額度
- 覆蓋範圍：OpenAI、Claude、Gemini 等主流模型
🚀 快速開始：推薦在 API易 apiyi.com 上完成這次驗證。註冊後用免費測試額度把修復後的請求跑一遍，確認
disabled正常生效、報錯消失，再接入真實業務，幾分鐘就能閉環。
claude-haiku-5-5 的 effort 兼容性
下表是全文最值得記住的一張，建議直接存進團隊筆記：
| effort 取值 | 與 disabled 組合 | 結果 |
|---|---|---|
medium（默認） |
兼容 | 正常關閉思考 |
high |
兼容 | 正常關閉思考 |
xhigh |
衝突 | 請求報錯 |
max |
衝突 | 請求報錯 |
對照這張表再看自己的請求，方向就很明確：只要報錯出現在同時傳了 disabled 的請求裏，第一反應就是檢查 effort 有沒有越過 high 這條線。文檔記載的修復口徑只有一句——把 effort 降到 high 或以下，沒有別的繞行寫法。
claude-haiku-5-5 與其他型號的默認 effort 對照
| 模型 | 默認 effort | 與關閉思考的關係 |
|---|---|---|
| claude-haiku-5-5 | medium |
默認滿足“不高於 high”，disabled 可直接生效 |
| claude-opus-5-5 | medium |
默認值與 haiku 相同，其思考開關規則本文不展開 |
| 其餘多數模型 | high |
默認值同樣在門檻內，手動上調纔會越界 |
這張表解釋了“爲什麼偏偏是我的請求報錯”：不同型號的默認 effort 不一樣，遷移代碼時沿用舊的參數習慣，很容易把 effort 顯式設到 xhigh 或 max。遷移前對照一下默認值，是成本最低的預防動作。
claude-haiku-5-5 報錯排查與自檢清單
| 現象 | 最可能的原因 | 處理方式 |
|---|---|---|
傳了 disabled 仍報錯 |
effort 爲 xhigh 或 max |
把 effort 降到 high 或以下 |
不確定 effort 是多少 |
沒傳時默認爲 medium |
默認值滿足門檻，無需額外處理 |
| 正文變短或被截斷 | 思考 token 計入了 max_tokens |
關閉思考，或在 128000 上限內調大 max_tokens |
| 想要更深的推理質量 | 關閉思考後沒有思考過程 | 去掉 disabled，回到默認的自適應思考 |
修完之後，發請求前過一遍這份自檢清單：
model準確寫成了claude-haiku-5-5effort缺省，或顯式爲medium、highthinking爲{"type": "disabled"}max_tokens不超過 128000
四個條件都滿足，這一類報錯就不會再找上門。把最終參數組合固化成請求模板，還能避免後續誤改。
claude-haiku-5-5 常見問題 FAQ
Q1：claude-haiku-5-5 默認會思考嗎？
會。文檔記載，不傳 `thinking` 時，claude-haiku-5-5 按自適應思考運行，默認開啓。想讓輸出額度全部留給正文，需要顯式傳 `disabled` 關閉。
Q2：爲什麼傳了 disabled 還是報錯？
最常見的原因是 `effort` 高於 `high`。文檔寫明 `disabled` 只在 `effort` 不高於 `high` 時被接受，配 `xhigh` 或 `max` 會報錯，修復口徑是把 `effort` 降到 `high` 或以下。
Q3：不傳 effort 會怎樣？
默認是 `medium`。claude-haiku-5-5 與 claude-opus-5-5 的默認值相同，都是 `medium`，其餘多數模型默認 `high`。默認值本身滿足“不高於 high”，可以直接搭配 `disabled`。
Q4：關閉思考後，輸出長度有什麼變化？
文檔記載思考 token 計入 `max_tokens`，最大輸出爲 128000。關閉思考後，同樣的 `max_tokens` 預算可以全部用於正文，被截斷的風險也隨之下降。
Q5：臨時想要更深的推理怎麼辦？
去掉 `disabled`，讓 claude-haiku-5-5 回到默認的自適應思考即可。如果要同時上調 `effort`，注意別停在“`xhigh` 或 `max` 加 `disabled`”這個組合上。
Q6：如何快速驗證修復是否生效？
在 API易 apiyi.com 註冊後獲取免費測試額度，接入地址用 `https://api.apiyi.com/v1`，把修復後的參數跑一次：請求不再報錯、正文正常返回，就說明 `disabled` 已經生效。平臺按量計費，小額度驗證的成本很低。
Q7：報錯一定來自 effort 嗎？
不一定，但這是文檔明確記載的一類。先覈對 `model` 是否準確寫成了 `claude-haiku-5-5`，再檢查 `thinking` 與 `effort` 的組合是否越界，都排除後再看其他原因。通過 API易 調用時遇到報錯，同樣先從這對參數查起。
Q8：這些參數口徑以哪個版本爲準？
本文以 2026-11-08（UTC+8）的 Anthropic 官方文檔爲準，覈對日期爲 2026-11-13。若官方後續調整 `effort` 與 `disabled` 的規則，請以最新文檔爲準。
總結
claude-haiku-5-5 關閉思考這件事，核心就四條：
- 默認會思考：不傳
thinking就是自適應思考，默認開啓，想省額度必須顯式關閉。 - 關閉有門檻：
thinking設爲disabled時，effort必須不高於high，配xhigh或max會報錯。 - 默認即安全：
effort默認medium，與 claude-opus-5-5 相同，不主動上調就不會觸發衝突。 - 額度邊界：最大輸出 128000，思考 token 計入
max_tokens，關閉後額度全部留給正文。
下次再遇到“想關掉思考卻報錯”，先看 effort 有沒有越過 high 這條線，把參數組合理順，問題基本就解決了。推薦通過 API易 apiyi.com 用免費測試額度快速驗證效果，一個 API Key 即可調用 claude-haiku-5-5 在內的多種主流模型，OpenAI 兼容接口也讓型號切換省事不少。
📚 參考資料
- API易文檔：Claude effort 與 thinking 參數說明
- 鏈接：
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
說明： effort 取值、disabled 的接受條件與報錯口徑
-
API易文檔：Claude 思考指南更新（2026-11）
- 鏈接：
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
說明： 思考相關指南的更新記錄與背景
-
Anthropic 官方文檔
- 鏈接：
docs.anthropic.com - 說明： 本文參數以 2026-11-08（UTC+8）版本官方口徑爲準
作者：API易技術團隊
技術交流：歡迎在 API易網站首頁聯繫我們，更多資料可訪問文檔中心
