Claude Codeを使っていると/effortコマンドで目にする「low・medium・high・xhigh・max」、そして選択肢の中に紛れ込んでいる「ultracode」。名前だけでは違いが分かりにくいこれらの設定を、本記事では仕組み・使い分け・モデルごとの対応状況まで整理して解説します。

スポンサーリンク

effortとは何か

effort（エフォート）は、Claudeがどれだけ「考える」かを制御するパラメータです。Sonnet 5・Opus 4.8などの最新モデルは「アダプティブ推論」を採用しており、タスクの複雑さに応じて思考するかどうか・どれだけ思考するかを動的に判断します。effortはこの推論の深さの上限をコントロールするダイヤルだと考えてください。

モデル別対応表：使える・使えないeffort

まず最も重要な前提から。effortはすべてのモデルで使えるわけではありません。対応状況は次の通りです。

デフォルトのeffortレベル

何も設定しない場合、モデルごとに以下のデフォルト値が適用されます。

各レベルの使い分け

ultracodeを深掘りする

ultracodeは/effortメニューの選択肢に並んでいますが、他のレベルとは性質が異なります。

/effort
# メニューから ultracode を選択

# または settings 経由
# --settings '{"ultracode": true}'

ultrathinkとの違いにも注意

もう一つ紛らわしい存在が「ultrathink」キーワードです。こちらはeffort設定ではなく、プロンプト内に含めるだけで効果を発揮するキーワードです。

effortの設定方法一覧

effortは複数の経路で設定でき、優先順位が決まっています。

優先順位は「環境変数 > 手動設定したレベル > モデルのデフォルト」の順です。スキル・サブエージェントのfrontmatterで指定したeffortはそのスキル・サブエージェント実行中はセッションのレベルより優先されますが、環境変数には勝てません。

思考（Extended Thinking）との関係

effortとは別に、「思考をON/OFFする」設定もあります。混同しやすいので整理しておきます。

Sonnet 5・Opus 4.7以降は常にアダプティブ推論（タスクごとに思考の要否を自動判断）を採用しているため、固定の思考トークン予算モードは存在しません。Opus 4.6・Sonnet 4.6に限り、環境変数CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1で旧来の固定予算モード（MAX_THINKING_TOKENSで制御）に戻すことができます。

実践：タスク別のおすすめ設定

よくある質問

まとめ

まずはデフォルトのhighから始め、タスクの性質に応じてxhigh・ultracode・ultrathinkを使い分けていくのが、精度とコストのバランスを取る近道です。