Effort（推理強度參數）
Claude API 新增的推理深度可調節參數——讓開發者用同一個模型，在不同任務間切換「快速答 vs 深度思考」。
上線時間
2026/03/12 隨 Sonnet 4.6 推出。
三檔強度
| Effort | 適用 | 速度 | 品質 |
|---|---|---|---|
| low | 簡單問答、格式轉換 | ⚡⚡⚡ | ★★ |
| medium（預設） | 一般任務 | ⚡⚡ | ★★★ |
| high | 複雜推理、規劃、debug | ⚡ | ★★★★ |
設定方式
client.messages.create(
model="claude-sonnet-4-6",
effort="high", # ← 此次推理走深度模式
messages=[...]
)為什麼要 Effort 參數？
過去：
- 想要深度思考 → 要用 Opus（貴）
- 想要省錢 → 用 Haiku（淺）
現在：
- 用同一個 Sonnet 4.6 → 透過 effort 切換
- low：價格與 Haiku 相當
- high：品質貼近 Opus
跟模型選擇的關係
Opus 4.6 ← 永遠最深，最貴
Sonnet 4.6 ← effort=high 接近 Opus / effort=low 接近 Haiku
Haiku 4.5 ← 永遠最快，最便宜
→ Sonnet + effort 是「萬用瑞士刀」。
Cowork / Claude Code 怎麼設？
| 介面 | 設定方式 |
|---|---|
| Cowork | Settings → Capabilities → Reasoning Depth |
| Claude Code | claude --effort high |
| API | effort 參數 |
文章建議：90% 的時候保持預設 medium——只在「明顯卡住的硬問題」切 high。
Use Case：什麼時候切 high
| 任務 | 適合 effort |
|---|---|
| 「翻譯這段」 | low |
| 「查 X 是什麼」 | low |
| 「總結這份文件」 | medium |
| 「寫一個 API」 | medium |
| 「設計一個資料模型」 | high |
| 「debug 一個複雜競態條件」 | high |
| 「規劃 6 個月路線圖」 | high |
跟 上下文壓縮 的搭配
效率組合 = effort + 上下文管理
- effort 高 → 推理深 → 但 token 也消耗多
- 配合上下文壓縮 → 保留最關鍵脈絡 → 推理品質不打折
對 Vincent 工作場景
Use Case 1：日常 PAM 修 bug
普通 bug：medium（預設）
複雜時間競態：high
Use Case 2：年度規劃
「擬定 PAM 系統 2027 上半年路線圖」 → effort=high
Use Case 3：批次處理
「翻譯這 200 條錯誤訊息成繁中」 → effort=low
（每條一兩字決策，不需要深度推理）
跟 thinking 模式的關係
| Effort | Extended Thinking | |
|---|---|---|
| 本質 | 整體推理深度設定 | 顯式「思考過程」 |
| 可見 | 內部，不外露 | 可選擇顯示思考 |
| 對應模型 | 4.6 起 | 4.5 已有 |
→ 兩者通常並用：effort=high + show thinking 拿到「深思考 + 看見思考過程」。
計費影響
| Effort | 相對 token 消耗 |
|---|---|
| low | 1.0x |
| medium | 1.5-2.0x |
| high | 3.0-5.0x |
→ 不要無腦預設 high——每月 quota 會暴增。
限制
- 不是所有模型都支援（要看版本）
- effort 不會「魔法解決問題」——只是給 Claude 更多空間
- low 在複雜任務 → 可能糟糕到不可用
相關概念
強連結（原文明確提及）
- Claude 模型家族 — Effort 與模型選擇互補
- 上下文壓縮 — token 管理
- API Skills — 預構建的能力組合
- Headless Mode 與 CI CD — CI 中可調節 effort 控成本
← 回到 wiki