エフォート

effortパラメータを使用すると、リクエストに応答する際にClaudeがトークンを使用することにどの程度積極的かを制御できます。これにより、単一のモデルで応答の徹底性とトークン効率のバランスを取ることができます。effortパラメータは、サポートされているすべてのモデルで一般的に利用可能であり、ベータヘッダーは不要です。

effortの仕組み

デフォルトでは、Claudeは高いeffortを使用し、優れた結果を得るために必要なだけのトークンを使用します。effortレベルをmaxに上げて絶対的に最高の機能を得るか、またはトークン使用をより控えめにして速度とコストを最適化しながら機能の低下を受け入れることができます。

effortパラメータは、以下を含むすべてのトークンに影響します：

• テキスト応答と説明
• ツール呼び出しと関数の引数
• 拡張思考（有効な場合）

このアプローチには2つの主な利点があります：

1. 思考を有効にする必要がなく、これを使用できます。
2. ツール呼び出しを含むすべてのトークン支出に影響を与えることができます。たとえば、より低いeffortはClaudeがより少ないツール呼び出しを行うことを意味します。これにより、効率に対する制御がはるかに大きくなります。

Effortレベル

Sonnet 4.6の推奨effortレベル

Sonnet 4.6はhigh effortがデフォルトです。Sonnet 4.6を使用する場合は、予期しないレイテンシを避けるためにeffortを明示的に設定してください：

• 中程度のエフォート（推奨デフォルト）：ほとんどのアプリケーションにおいて、速度、コスト、パフォーマンスの最適なバランス。エージェンティックコーディング、ツール集約的なワークフロー、コード生成に適しています。
• 低いエフォート： 高ボリュームまたはレイテンシに敏感なワークロード向け。より高速なターンアラウンドが優先される、チャットおよび非コーディングのユースケースに適しています。
• 高いエフォート： Sonnet 4.6から最大の知能が必要なタスク向け。
• 最大エフォート： トークン支出に制約のない絶対的に最高の機能が必要なタスク向け。

基本的な使用方法

effortパラメータを調整する時期

• 最大エフォートを使用する場合は、制約なしで絶対的に最高の機能が必要な場合：最も徹底的な推論と最も深い分析。Claude Mythos Preview、Claude Opus 4.6、およびClaude Sonnet 4.6で利用可能。
• 高いエフォート（デフォルト）を使用する場合は、Claudeの最高の仕事が必要な場合：複雑な推論、微妙な分析、難しいコーディング問題、または品質が最優先事項であるあらゆるタスク。
• 中程度のエフォートをバランスの取れたオプションとして使用する場合は、高いエフォートの完全なトークン支出なしで堅実なパフォーマンスが必要な場合。
• 低いエフォートを使用する場合は、速度（Claudeがより少ないトークンで応答するため）またはコストを最適化している場合。たとえば、単純な分類タスク、クイックルックアップ、または限界的な品質改善が追加のレイテンシまたは支出を正当化しない高ボリュームのユースケース。

ツール使用時のエフォート

ツールを使用する場合、effortパラメータはツール呼び出しの周囲の説明とツール呼び出し自体の両方に影響します。より低いeffortレベルは傾向として：

• 複数の操作をより少ないツール呼び出しに組み合わせる
• より少ないツール呼び出しを行う
• 前置きなしで直接アクションに進む
• 完了後に簡潔な確認メッセージを使用する

より高いeffortレベルは以下を行う可能性があります：

• より多くのツール呼び出しを行う
• アクションを取る前に計画を説明する
• 変更の詳細な概要を提供する
• より包括的なコードコメントを含める

拡張思考を伴うエフォート

effortパラメータは拡張思考と一緒に機能します。その動作はモデルに依存します：

• Claude Mythos Previewは適応的思考をデフォルトで使用します（thinking設定は不要）。thinking: {type: "disabled"}は拒否されます。Effortは、Opus 4.6と同じ方法で思考の深さを制御します。
• Claude Opus 4.6は適応的思考（thinking: {type: "adaptive"}）を使用し、effortは思考の深さを制御するための推奨される方法です。Opus 4.6ではbudget_tokensはまだ受け入れられていますが、非推奨であり、将来のリリースで削除される予定です。highおよびmax effortでは、Claudeはほぼ常に深く思考します。より低いレベルでは、より単純な問題については思考をスキップする可能性があります。
• Claude Sonnet 4.6は適応的思考を使用します（effortが思考の深さを制御する場所）。インターリーブモード（thinking: {type: "enabled", budget_tokens: N}）での手動思考はまだ機能していますが、非推奨です。
• Claude Opus 4.5およびその他のClaude 4モデルは手動思考（thinking: {type: "enabled", budget_tokens: N}）を使用し、effortは思考トークン予算と一緒に機能します。タスクのeffortレベルを設定してから、タスクの複雑さに基づいて思考トークン予算を設定します。

effortパラメータは、拡張思考が有効になっているかどうかに関わらず使用できます。思考なしで使用する場合、テキスト応答とツール呼び出しの全体的なトークン支出を制御します。

ベストプラクティス

1. effortを明示的に設定する： APIはデフォルトでhighですが、正しい開始点はモデルとワークロードに依存します。
2. 速度に敏感なまたは単純なタスクに低を使用する： レイテンシが重要な場合またはタスクが単純な場合、低いeffortは応答時間とコストを大幅に削減できます。
3. ユースケースをテストする： effortレベルの影響はタスクタイプによって異なります。デプロイする前に、特定のユースケースでパフォーマンスを評価してください。
4. 動的effortを検討する： タスクの複雑さに基づいてeffortを調整します。単純なクエリは低いeffortを保証する可能性がありますが、エージェンティックコーディングと複雑な推論は高いeffortから利益を得ます。