Claude Code の /effort 完全ガイド｜low〜maxの使い分けと『コストが増える本当の理由』

この記事は「Claude Opus 4.8 は何が変わった？ベンチより「正直さ」と並列エージェントが本命だった」で触れた effort 制御を、独立した1テーマとして掘り下げる実用ガイドです。Opus 4.8 の全体像から押さえたい方は、先に親記事を読んでおくと本記事の位置づけが掴みやすくなります。

この記事は Claude 公式の Effort / Pricing / Model configuration ドキュメント（2026年5月時点）を一次ソースとして参照し、Claude Code 最新版（v2.1.156）の実機で /effort の選択肢・既定値・設定永続性を確認したうえで執筆しています。仕様は更新される場合があるため、最終的な挙動は公式ドキュメントの最新版をご確認ください。

/effort は「賢さ」ではなく「Claude がトークンをどれだけ気前よく使うか（思考・ツール・出力すべての丁寧さ）」のレバーです。迷ったらモデル別の推奨スタートで選べばよく、Opus 4.8 のコーディングは xhigh、汎用は high、Sonnet 4.6 は medium。「最近コストが増えた気がする」原因は『トークナイザ（4.6→4.7 で最大+35%・以降据え置き）』と『effort（自分で回すノブ）』の2軸に分けて考えれば切り分けられます。4.7→4.8 で換算レートは増えず、むしろツール用システムプロンプトは 675→290 トークンに減っています。

• /effort って結局なに？ ―― 賢さとコストを1本のレバーで動かす設定
• 7つの選択肢を一望する
• どの状況でどれを選ぶ？ ―― 公式推奨に基づく判断フロー
• コストの2軸を切り分ける ―― 「トークナイザ」と「effort」は別物
• Opus 4.8 は本当に重いのか ―― tool用システムプロンプト290トークンの衝撃
• 実機で確かめた『設定の罠』 ―― 永続性と auto の使いどころ
• まとめ ―― 明日から使えるチートシート
• よくある質問（FAQ）
• この記事を書いた人
  • 出典

Claude Code を使っていて、/effort と打つとこんな選択肢が出てきたことはありませんか。

/effort  [low | medium | high | xhigh | max | ultracode | auto]

見慣れない xhigh や max、さらには ultracode や auto まで並んでいて、「とりあえず一番強そうな max にしとけばいいのかな？」と思った人も多いはずです。結論から言うと、それは多くの場合ハズレです。

/effort（エフォート＝努力度）は、ひとことで言えば「Claude がトークンをどれだけ気前よく使うか」を決めるレバーです。公式ドキュメントの表現を借りると、effort は "how eager Claude is about spending tokens"（どれだけ積極的にトークンを使うか）を制御します。レベルを上げれば深く考え、たくさんツールを呼び、丁寧に説明します。下げれば即答し、ツール呼び出しをまとめ、簡潔に返します。

ポイントは、これが思考（thinking）だけの設定ではないことです。公式は effort が「応答内のすべてのトークン」に効くと明記しています。

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

つまり effort を下げると、Claude はツールを呼ぶ回数そのものを減らし、複数の操作を1回のツール呼び出しにまとめ、前置きなしで作業に入ります。「賢さのつまみ」ではなく「全体の動きの丁寧さ・徹底度のつまみ」だと捉えるのが正確です。

まずは全体像です。公式の定義（platform.claude.com の effort ドキュメント）をそのまま整理しました。

ここで一番大事な切り分けは、low〜max の5つは API レベルの effort 値で、ultracode と auto は Claude Code の操作概念だということです。ultracode はモデルに送る effort としては xhigh と同じで、それに「ワークフローを自律起動してよい」という権限がくっついたもの。auto はそもそも effort の値ではなく「既定に戻せ」というリセットボタンです。この2つは「Claude Code の新effortモード徹底解説｜max・ultracode・autoと『呪文ultrathink』の正体」（シリーズ②）で深掘りするので、ここでは「別カテゴリ」とだけ覚えてください。

そして地味に重要なのが、モデルによって使える段階が違う点です。

xhigh は Opus 4.8 と 4.7 だけの特権です。もし Opus 4.6 で xhigh を指定しても、公式仕様では「指定値以下で対応している最高レベルに自動で落ちる」ので、high として動きます。エラーにはなりません。

ここが本題です。「で、結局どれを使えばいいの？」に公式ガイダンスで答えます。

Anthropic は Opus 4.8 についてこう明言しています（effort ドキュメントの原文）。

Start with xhigh for coding and agentic use cases, use high for most other intelligence-sensitive workloads, and step down to medium or low only when you've measured that the lower level holds quality on your evals.

訳すと「コーディングやエージェント用途では xhigh から始めよ。それ以外の知性が要る作業は high。medium や low への引き下げは、eval（評価）で品質が落ちないと確認できたときだけにせよ」。

つまり Opus 4.8 をコードに使うなら、既定の high よりもむしろ xhigh が推奨スタート地点なのです。これは後で効いてくる重要な点なので覚えておいてください。

各レベルの使い所を、公式の「When to adjust」記述に沿ってフロー化するとこうなります。

• 短い・スコープ明確・知性をあまり要さない（分類、ルックアップ、定型処理、大量バッチ） → low。速度とコストを最優先する場面です。
• コスト重視で、多少の知性は犠牲にできる平均的なワークフロー → medium。Sonnet 4.6 の公式推奨デフォルトはこれです。
• 複雑な推論・難しいコーディング・品質が速度やコストより大事 → high。Opus 4.8 の既定であり、汎用の安全牌。
• 30分を超える長時間のエージェント作業・反復的なツール呼び出し・詳細な探索やWeb検索 → xhigh。公式は「数百万トークン規模」の作業を想定すると書いています。
• 本物のフロンティア級の難問 → max。ただし乱用厳禁（理由は後述）。

モデル別の推奨デフォルトを一枚にまとめます。

なお xhigh や max で長時間回すときは、思考とツール呼び出しのために max_tokens を大きめ（公式は 64k トークンを出発点に推奨）に取っておくのがコツです。狭いと思考の途中で詰まります。

ここからが、多くの人が混乱して損をしているポイントです。「Opus 4.8 にしてから、なんだかトークン消費が増えた気がする」という感覚。これ、原因が2つあって、それぞれ発生源がまったく違います。

軸①：トークナイザ（換算レート） 同じ文章が「何トークンに化けるか」の換算レートです。公式 pricing ページにこんな注記があります。

Opus 4.7 and later use a new tokenizer compared to previous models... This new tokenizer may use up to 35% more tokens for the same fixed text.

「Opus 4.7 以降は新しいトークナイザを使い、同じ固定テキストで最大35%多くトークンを消費しうる」。つまり同じプロンプトでもトークン数が最大1.35倍にカウントされるわけです。単価（入力 $5 / 出力 $25）は据え置きでも、実コストは膨らみます。

軸②：effort（生成量） Claude が「どれだけ生成するか」。xhigh や max を選ぶと、思考トークン・ツール呼び出し・出力テキストが増えます。これは自分で回すノブであって、モデルに強制されるものではありません。

この2軸を混同すると、「Opus 4.8 にしたらトークナイザのせいで勝手に増えた」と誤解しがちです。正しく切り分けるとこうなります。

ここが今回いちばん伝えたい事実です。「+35%」は 4.6→4.7 で一度きり起きた段差であって、4.8 はそれを引き継いでいるだけ。4.7 から 4.8 に上げても、換算レートがさらに膨らむことはありません。「Opus 4.7 で新トークナイザになったばかりなのに、4.8 でさらに増えるの？」という不安への答えは、ノーです。増えるのは「あなたが effort を上げたときだけ」です。

「とはいえ最新の Opus 4.8 はいちばんトークンを食うんでしょ？」と思いますよね。ところが、公式 pricing ページの「ツール利用時のシステムプロンプト・トークン数」の表を見ると、逆でした。

Claude Code はほぼ常にツールを使うので、この「ツールを有効にするための裏側のシステムプロンプト」は毎リクエストに乗ってきます。それが Opus 4.7 の 675 トークンから、4.8 では 290 トークンへと、半分以下に削減されているのです。

さらに 4.8 は adaptive thinking（適応的思考）で「考える必要があるときだけ考える」挙動が洗練され、単純なステップでは思考をスキップして無駄な思考トークンを減らします。

これらを合わせると、結論はこうです。同じ effort なら、Opus 4.8 は 4.7 より総トークン消費がむしろ減る方向。「最新だから重い」は思い込みで、実態は「最新だからオーバーヘッドが軽い」。重くなるのは、繰り返しますがあなたが effort レバーを上げたときだけなのです。

ここからは、筆者が手元の環境（Claude Code を最新版に更新した状態）で実際に確認した運用上の罠です。

罠①：settings に書ける effort・書けない effort がある 設定ファイルの effortLevel に永続化できるのは low medium high xhigh の4つだけ。max と ultracode はセッション限定で、設定ファイルには書けません（max だけは環境変数 CLAUDE_CODE_EFFORT_LEVEL 経由なら例外的にセッションへ固定できます）。「max を常用設定にしたい」と思っても、正攻法では毎セッション指定が必要、というわけです。

罠②：モデルを切り替えると effort がリセットされる 公式仕様で「Opus 4.8 や 4.7 を初めて起動したとき、以前に別モデルで設定した effort があってもそのモデルの既定に戻す」とあります。Opus 4.8 なら high、4.7 なら xhigh に。だから「さっき max にしたのにモデル切替後に戻ってる！」は仕様どおりの挙動です。

罠③：auto はリセットボタン ここで auto の出番です。/effort auto を実行すると、現在のモデルの既定 effort に戻ります。前のセッションで max まで上げていたのを素早く標準へ戻したいときの「お掃除ボタン」として使うのが正しい使い方です。

そして実際に確認してハッとしたのが、筆者の設定が effortLevel: xhigh になっていたこと。最初は「最大に振りすぎでは？」と焦ったのですが、前述のとおりOpus 4.8 のコーディング用途では xhigh こそ公式推奨スタート地点。むしろ教科書どおりの設定でした。xhigh は「極端な最大」ではなく「コードを書かせるなら標準」――この感覚のズレこそ、今回の記事で一番伝えたかったことかもしれません。本当の最大は max で、そちらは別の慎重さが要ります（続編で詳しく解説します）。

長くなったので、持ち帰り用に圧縮します。

• /effort は「賢さ」ではなく「トークンの気前よさ＝思考・ツール・出力すべての丁寧さ」のレバー。
• 迷ったらモデル別の推奨スタートで。Opus 4.8 のコーディング → xhigh、汎用 → high、Sonnet 4.6 → medium。
• コスト増の原因は2軸。トークナイザ（4.6→4.7 で+35%・以降据え置き）と effort（自分のノブ）。4.7→4.8 で換算レートは増えない。
• Opus 4.8 はむしろ軽い。ツール用システムプロンプトは 4.7 の675→290トークン。同 effort なら総消費は減る方向。
• max と ultracode は設定に書けずセッション限定。auto は既定に戻すリセットボタン。
• 速度が欲しい場面では遠慮なく /effort low に下げる。effort は固定するものではなく、タスクごとに動かすものです。

新顔の max ultracode、そして「呪文」ultrathink の正体は、続く「Claude Code の新effortモード徹底解説｜max・ultracode・autoと『呪文ultrathink』の正体」（シリーズ②）で徹底解説します。

Q. 結局、どの effort から始めればいいですか？ A. モデルとタスクで決めるのが正解です。Opus 4.8 でコーディングやエージェント用途なら xhigh、それ以外の知性が要る作業は high、Sonnet 4.6 は公式推奨どおり medium から。そこから「軽い作業は low に落とす」「品質が頭打ちなら下げる」と、タスクごとに動かしていくのが公式の考え方です。固定する設定ではありません。

Q. Opus 4.8 にしたらコストが増えた気がします。トークナイザのせいですか？ A. 4.7→4.8 では換算レート（トークナイザ）は増えていません。新トークナイザによる最大+35%は 4.6→4.7 で一度きり起きた段差で、「4.7 and later」は同じトークナイザを共有しています。コストが増えたと感じるなら、原因はトークナイザではなく xhigh/max などで effort（生成量）を上げたか、扱う作業量そのものが増えたかのどちらかです。

Q. xhigh は最大に近い設定だから、常用すると重すぎませんか？ A. xhigh は「極端な最大」ではなく、Opus 4.8 のコーディング用途における公式の推奨スタート地点です。本当の最大は max で、こちらは overthinking のリスクがあるため常用は非推奨。xhigh は「コードを書かせるなら標準」くらいの感覚で問題ありません。

HW系エンジニアとして20年以上、10,000件を超える顧客訪問と2,000件を超える単独ソリューション実績。AIツールを使った個人開発やIoT農園など、Raspberry Piを使ったオートメーション化なども実践中です！エンジニア専門結婚相談所も運営中、ClaudeCodeで解決できない心の課題も解決いたします！

出典

• Claude 公式「Effort」ドキュメント ― 各レベルの定義・モデル別推奨スタート・When to adjust
• Claude 公式「Pricing」 ― 新トークナイザ注記・ツール用システムプロンプトのトークン数表
• Claude Code 公式「Model configuration」 ― effort レベルのモデル別対応・フォールバック・永続性・auto

この記事は上記 Claude 公式ドキュメント（2026年5月時点）を一次ソースとして参照し、Claude Code 最新版（v2.1.156）の実機で /effort の選択肢・既定値・設定永続性を確認（検証日 2026-05-29）したうえで執筆しています。価格・トークナイザ・effort 仕様は公式ドキュメントの当日時点の記載に基づきます。