Claude Codeを使用する開発者は、いずれコストや使用量の制約に直面します。それでも開発者はモデルの知能の最前線で作業したいと考え、多くの場合、利用可能な最も高性能なモデルをデフォルトで選択します。
どのモデルを使用していても、コストとトークン使用量に関するもう一つの重要な調整ダイヤルがエフォートレベルです。エフォートをタスクの複雑さに合わせましょう。そうしなければ、どちらの方向にもコストが発生します。
エフォートはモデルが知っていることを変えない
エフォートは、プロンプト内のタスクにどれだけのリソースを費やすかをモデルに伝えます。エフォートを最低レベルに設定すると、モデルはできるだけ少ないリソースでプロンプトの目的を達成しようとします。つまり、ツール呼び出しが少なく、トークンが少なく、全体的な作業量も少なくなります。エフォートを最大に設定すると、プロンプトの目的を達成するために必要なだけのリソースを使用できる、そして使用すべきであるというシグナルをモデルに送ることになります。
エフォートは、モデルがどれだけ一生懸命働くかを設定するものであり、どれだけ知っているかを設定するものではありません。選択するモデルによって、扱う能力のレベルが決まります。エフォートは、そのモデルにどれだけ一生懸命働いてほしいかを示すシグナルです。
エフォートを変更するタイミング
タスクに対してエフォートが低すぎる場合、モデルは早期に停止し、未完成の作業を持って戻ってくる可能性が高くなります。これは、あなたが依頼した内容が、許容したエフォートよりも複雑であることを示すシグナルです。その場合、モデルがどこで止まったかを把握し、続行させるために再度プロンプトを送る必要があります。結局のところ、これはエフォートレベルを正しく設定していた場合よりもコストがかかる可能性があります。
エフォートが高すぎる場合、すべてのプロンプトやすべてのタスクで気づくとは限りません。モデルは必要以上にトークンを使用し、応答時間が長くなり、過剰に考え込むパターンや、実際に割り当てた以上のタスクを特定するパターンに気づくでしょう。あなたは「私が説明していることは本当に複雑で難しい」というシグナルを送っており、モデルはそのシグナルに合わせて、作業をそれほど複雑なものとして扱います。
デフォルトは中間に位置しており、これは恣意的なものではありません。各モデルに対して、ほとんどのタスクが過剰な消費なしに完了するレベルに調整されています。だからこそ、デフォルトが始めるのに適した場所なのです。
シンプルであるとわかっていて、時間、ターン数、ツール呼び出し、ドキュメントの読み込みといったリソースを大きく消費すべきではないタスクについては、下方に調整します。この種のタスクをすでにデフォルトレベルで実行したことがある場合は、1段階下げて実行し、品質に違いが出るかどうかを確認してみてください。違いがなければ、違いが出るまで1段階ずつ下げ続けてください。
長い時間がかかり、多くのターン数と二重チェックを必要とするとわかっていることを説明している場合は、デフォルトから上方に調整します。エフォートを上げるもう一つの場面は、タスクが自分で素早く確認できないものであり、モデルが作業を進める中でより多くの自己チェックを行ってほしい場合です。この方向でも同じルールが適用されます。1段階上げて再実行し、期待通りに完了し始めたら止めてください。
どちらのダイヤルを回すべきか:エフォートかモデルか
エフォートを増やしても問題が解決しなかった場合にのみ、モデルを変更してください。モデルが十分に知らなかったのか、それとも十分に努力しなかったのか。十分に知っていたが努力が足りなかったのであれば、エフォートを変更してください。十分に知っていたが働きすぎたのであれば、それもエフォートの問題です。エフォートを変更しても解決せず、かつ最も高性能なモデルを使用していない場合は、選択したモデルがそのタスクに必要な知識を持っていないか、十分な能力がないことを示すサインです。
モデルを変更する際は、再びデフォルトから始める
レベル名はどのモデルでも同じですが、同じレベルが異なるモデルで同じ量の作業を意味するわけではありません。
モデルを選択するときは常に、エフォートをデフォルトから始め、必要に応じて上下に調整してください。例えば、利用可能な最も能力の低いモデルで難しいタスクを試し、より低コストでその作業ができるかどうかを確認するとします。エフォートを可能な限り高く設定しても、モデルが必要な品質レベルでタスクを完了できない場合は、モデルをアップグレードします。その際、エフォートを最大のままにしておかないでください。再びデフォルトから試してください。より高性能なモデルであれば、より少ないエフォートでもタスクを完了できるかもしれません。
新しいモデルが登場したとき(すでに使用しているモデルの新しいバージョンを含む)は、これまで行ってきたタスクを見直してください。より高性能なモデルで、より低いエフォートで同じ結果が得られるかどうかを確認してください。それによって、それらのタスクがより安価になるかもしれません。
エフォートレベルの設定
エフォートは、以下のいずれかの方法で変更できます。
このセッションのみ:
--effortフラグ: Claude Codeを起動する際にレベル名を渡します
このセッションおよび今後のセッション:
/effort: 引数なしで/effortを実行するとインタラクティブなスライダーが開きます。/effortの後にレベル名を続けると直接設定できます。/effort autoでモデルのデフォルトにリセットできます/model内: モデルを選択している間、左右の矢印キーを使ってエフォートスライダーを調整します- 設定: 設定ファイルで
effortLevelをlow、medium、high、またはxhighに設定します - 環境変数:
CLAUDE_CODE_EFFORT_LEVELをレベル名またはautoに設定します
1つのスキルまたはサブエージェントに対して:
- スキルおよびサブエージェントのフロントマター: スキルまたはサブエージェントのMarkdownファイルで
effortを設定すると、実行中のエフォートレベルを上書きできます
/effortで設定したレベルは次のセッションにも引き継がれるため、1回の実行のみにレベルを適用したい場合は--effortフラグを使用してください。Maxは十分なリソースを使用するため、環境変数を通じて設定しない限り、Claude Codeはそれをセッション限定にします。そのため、誤ってオンのままにしてしまうことはありません。
Ultracodeはエフォートレベルではありません。これはセッション限定のClaude Code設定で、モデルをxhighで実行し、実質的なタスクについては、Claudeに動的ワークフロー(新しいタブで開きます)をオーケストレーションさせ、複数のエージェントに作業を分散させます。
複数の方法でエフォートが設定されている場合、以下の順序で最も上にあるものが優先されます。
上記のどれが優先されるとしても、組織によって上限が設定されている場合があります。Enterpriseプランでは、管理者がモデルごとの最大エフォートレベル(新しいタブで開きます)を設定できます。上限を超えるレベルは/effortピッカーには表示されず、/effortや--effortでそれを要求した場合、Claude Codeは上限で実行し、その旨を通知します。
実例
同じプロンプトを1つのモデルで、low、デフォルト、maxの3回実行します。各レベルを再生し、同じ結果にどれだけの作業が投入されるかを観察してください。このプロンプトは、サンプルファイルでテストされた小さなCSVからJSONへの変換スクリプトを依頼するもので、エフォートレベルに差が出る余地を持たせるために意図的に単純なものにしています。
自分の環境で試す
3つの別々のセッションを用意します。それぞれで同じ4つのステップを実行してください。/usageは現在のセッションのみを報告するため、比較は自分で組み立てる必要があります。各実行の最後にそれを確認し、そのセッションで報告されたトークン数を書き留めてから、終了して次の実行を新たに開始してください。
1. その実行のレベルで、専用の空フォルダに新しいセッションを起動する
# リポジトリ外の空のフォルダから
# 実行1・低
mkdir effort-low && cd effort-low && claude --effort low
# 実行2・デフォルト
cd .. && mkdir effort-default && cd effort-default && claude
# 次に /effort auto を実行
# 実行3・最大
cd .. && mkdir effort-max && cd effort-max && claude --effort maxこのフラグ(または/effort auto)により、各実行はそれぞれのレベルで開始されます。なぜなら、/effortで一度設定すると、lowからxhighまでは次のセッションにも引き継がれるためです。
2. 同じプロンプトを貼り付ける
CSVファイルをJSONに変換するスクリプトを書いてください。このフォルダにcsv_to_json.pyとして保存してください。sample.csvとして保存された以下のCSVでテストしてください:
name,team,start_date
Priya,Payments,2024-03-18
Marcus,Platform,2023-11-02
Lena,Support,2025-01-273. Claudeが作業を返してきたら、このセッションが何を使用したかを確認する
/usageセッションのトークン合計を確認してください。画面の残りの部分はプランによって異なります。
4. 終了し、次のレベルのためにステップ1に戻る
/exit3つのトークン数はlowからmaxにかけて増加するはずで、3つのフォルダすべてに動作する変換スクリプトが入っているはずです。3つのスクリプトを並べて開いてみてください。どれだけ多く構築されたかの違いが、あなたが支払った対価の違いです。
維持すべき習慣
エフォートの管理は、1つの習慣に集約されます。デフォルトから始め、返ってくる結果を観察し、1段階ずつ調整することです。このループを回し続ければ、タスクにどのレベルが必要かがわかるようになり、同僚や管理者にその理由を説明できるようになります。
さらに詳しく
- Claude Codeにおけるモデルとエフォートレベルの選択(新しいタブで開きます):Claude Codeチームによる、モデル選択とエフォートの背後にある概念。
- モデル設定(新しいタブで開きます):
/effort、設定、優先順位、組織の制限に関する完全なリファレンス。 - Claude Codeから価値を最大化する(新しいタブで開きます):Claude Codeチームによる、セッションのトークンがどこに使われるか、適切なモデルとエフォートレベルの選び方、そしてCLAUDE.mdとMCPサーバーが各ターンに何を加えるかについての録画ウェビナー。
- コストと知能の最適化(新しいタブで開きます):Claude Platformドキュメントによる、エフォート、プロンプトキャッシング、モデル選択に関する測定結果を、タスクごとのコストで比較したもの。
- Claude APIにおけるコスト最適化(新しいタブで開きます):Claude Cookbookによる、Platformビルダー向けに、動作するエージェントに1つずつ適用されるコストレバー。