Effort

effort 參數允許您控制 Claude 在回應請求時花費 token 的積極程度。這讓您能夠在回應完整性和 token 效率之間進行權衡，且全部使用單一模型。effort 參數已在所有支援的模型上正式可用，無需 beta 標頭。

effort 的運作方式

預設情況下，Claude 使用高 effort——花費所需的 token 數量以獲得出色的結果。您可以將 effort 級別提高到 max 以獲得絕對最高的能力，或降低它以更保守地使用 token，在接受一些能力降低的情況下優化速度和成本。

effort 參數影響回應中的所有 token，包括：

• 文字回應和解釋
• 工具呼叫和函數參數
• 延伸思考（啟用時）

這種方法有兩個主要優勢：

1. 不需要啟用思考即可使用。
2. 它可以影響所有 token 花費，包括工具呼叫。例如，較低的 effort 意味著 Claude 會進行較少的工具呼叫。這提供了對效率更大程度的控制。

Effort 級別

基本用法

何時應該調整 effort 參數？

• 當您需要不受限制的絕對最高能力時，使用 max effort——最徹底的推理和最深入的分析。僅在 Opus 4.6 上可用；在其他模型上使用 max 的請求將返回錯誤。
• 當您需要 Claude 的最佳表現時，使用 high effort（預設值）——複雜推理、細緻分析、困難的程式設計問題，或任何品質是首要優先的任務。
• 當您想要穩健的效能而不需要 high effort 的完整 token 花費時，使用 medium effort 作為平衡選項。
• 當您優化速度（因為 Claude 用更少的 token 回答）或成本時，使用 low effort——例如，簡單的分類任務、快速查詢，或邊際品質提升不足以證明額外延遲或花費合理性的高流量使用場景。

Effort 與工具使用

使用工具時，effort 參數會影響工具呼叫周圍的解釋和工具呼叫本身。較低的 effort 級別傾向於：

• 將多個操作合併為較少的工具呼叫
• 進行較少的工具呼叫
• 直接進行操作而不做前言
• 完成後使用簡短的確認訊息

較高的 effort 級別可能會：

• 進行更多的工具呼叫
• 在採取行動前解釋計劃
• 提供詳細的變更摘要
• 包含更全面的程式碼註解

Effort 與延伸思考

effort 參數與延伸思考協同運作。其行為取決於模型：

• Claude Opus 4.6 使用自適應思考（thinking: {type: "adaptive"}），其中 effort 是控制思考深度的建議方式。雖然 budget_tokens 在 Opus 4.6 上仍然被接受，但它已被棄用，將在未來版本中移除。在 high 和 max effort 下，Claude 幾乎總是進行深度思考。在較低級別下，它可能會跳過較簡單問題的思考。
• Claude Opus 4.5 使用手動思考（thinking: {type: "enabled", budget_tokens: N}），其中 effort 與思考 token 預算協同運作。根據您的任務設定 effort 級別，然後根據任務複雜度設定思考 token 預算。

effort 參數可以在啟用或未啟用延伸思考的情況下使用。在未使用思考時，它仍然控制文字回應和工具呼叫的整體 token 花費。

最佳實踐

1. 從 high 開始：使用較低的 effort 級別來在效能和 token 效率之間進行權衡。
2. 對速度敏感或簡單的任務使用 low：當延遲很重要或任務很簡單時，low effort 可以顯著減少回應時間和成本。
3. 測試您的使用場景：effort 級別的影響因任務類型而異。在部署前評估您特定使用場景的效能。
4. 考慮動態 effort：根據任務複雜度調整 effort。簡單的查詢可能適合 low effort，而代理程式設計和複雜推理則受益於 high effort。