Claude Code Ultracode & Effort レベル完全解説：/effort ガイド
Effort は Claude の思考の深さを決め、同時に利用上限が尽きる速さも決めます。このガイドでは 5 つの effort レベル、モデル別のデフォルト、/effort auto の実際の意味、そして ultracode —— v2.1.284 で任意のレベルに重ねられる独立スイッチになったオーケストレーショントグル —— を解説します。
TL;DR —— effort と ultracode を 4 行で
- 5 つのレベル：low、medium、high、xhigh、max —— モデルごとに調整されています。多くのモデルのデフォルトは high ですが、Opus 5.5 と Sonnet 5.5 は medium、Opus 4.7 は xhigh がデフォルトです。
- 変更は /effort（スライダー）または /effort <レベル>。/effort auto は保存済みレベルをクリアしてモデルのデフォルトに戻します。スライダー内では Enter でデフォルト保存、s ならこのセッション限りです。
- Ultracode はモデルの effort レベルではなく Claude Code の設定です：内容の濃いタスクについて Claude に動的ワークフローをオーケストレーションさせます。v2.1.284 からは独立したトグル —— /effort 内で Tab、または /effort ultracode on|off —— になり、xhigh の強制はなくなりました。
- Ultracode vs max を一言で：max は最も深い生の推論レベル（考えすぎやすい）。ultracode は選んだレベルの上にワークフロー編成を重ねるもの。答える問いが違います —— 深さ vs 調整。
Model configuration & effort — Claude Code documentation
ドキュメント:code.claude.com
Claude Code CHANGELOG — v2.1.284 (Ultracode becomes its own toggle)
変更ログ:github.com/anthropics/claude-code
How to Use Claude Effort Levels (Full Guide)
チャンネル:Ryan & Matt Data Science13:24
このページの事実は公式 effort ドキュメントと v2.1.284 変更ログに基づきます。図はこのガイドのためのオリジナル図版です。挙げられている動画は Claude の co-work アプリで同じ 5 つの effort レベルを実測したもので —— 実際の token 消費データとして有用ですが、画面は Claude Code とは別のサーフェスです。このページではそのフレームは一切使用していません。
Effort レベルと ultracode、段階的に
1 · 目盛りを知る
- 1
effort が実際に何を制御するか理解する
Effort は Claude Code の推論ダイヤルです。リクエストにモデルがどれだけ思考を注ぐかを決め、回答品質・レイテンシ・使用上限の消費速度に直結します。公式ドキュメントも、この目盛りがモデル別の調整であることをはっきり言っています —— 同じレベル名でもモデルが違えば中身の値は同じではありません。
/effort の目盛り一覧：5 レベル + ultracode トグル（このガイド用のオリジナル図版）。 - 2
5 つのレベルと、それぞれが token の元を取る場面を覚える
low は自分で確認する短いやり取り —— ブレスト、ラフ案、リネーム向け。medium は範囲のはっきりした日常業務を担います。high は検証が重要だったりエッジケースが潜む作業向け。xhigh はより多くの token と引き換えに深い推論を買い、長時間のエージェント的タスクに向きます。max は Claude に一人で難問を粘り強く取り組ませたいときに —— ドキュメントは収穫逓減や考えすぎの可能性を警告しています。
- 3
モデルを責める前にデフォルトを確認する
デフォルトは一律ではありません：effort 対応モデルはすべて high がデフォルトですが、Opus 5.5 と Sonnet 5.5 だけは medium、Opus 4.7 は xhigh です。応答が遅い・上限がすぐ消えると感じたら、モデルを疑う前に effort の設定を確認しましょう。なお v2.1.284 で Sonnet 5.5 がデフォルトの Sonnet モデルになりました（1M コンテキスト、100 万 token あたり $2/$10）。
2 · 意図どおりに変える
- 4
/effort でその場で変える
セッションで /effort と入力するとスライダーが開きます —— 矢印キーでレベルを移動し、Tab で ultracode トグルへ。/model ピッカー内では左右キーが同じ操作になります。単発の実行なら --effort フラグでそのセッションのレベルを指定でき、自動化では CLAUDE_CODE_EFFORT_LEVEL 環境変数が使えます。
- 5
レベルを直接指定する —— auto の意味も知る
/effort <レベル> はスライダーを開かずにレベルを設定します。地味に便利なのが /effort auto：アクティブなモデルの保存済みレベルをクリアし、そのモデルのデフォルトに戻します。環境変数も auto を受け付けます。実験のあとでセッションの挙動がおかしいときは、auto がリセットボタンです。
- 6
選択を恒久化する（正しいやり方で）
/effort スライダーでは Enter でレベルがデフォルトとして保存され、s はこのセッションのみに適用されます。settings では modelSettings でモデル別に設定するか、トップレベルの effortLevel をフォールバックとして使えます —— 落とし穴が一つ：max はどちらのキーでも受け付けられず、環境変数経由でない限り max は現在のセッション限定です。スキルとサブエージェントは frontmatter で独自の effort を持てますが、上限は maxEffortLevel です。
3 · 新トグル ultracode
- 7
ultracode とは何かを理解する
Ultracode はモデルの effort レベルではなく Claude Code の設定です。公式ドキュメントによれば、内容の濃いタスクについて Claude に動的ワークフローをオーケストレーションさせます —— 大きな仕事を一本道の長い推論にせず、協調するステップに分解する、ということ。かつて xhigh と融合して提供されていた理由もここにあります：深い推論の上の編成だからです。
- 8
v2.1.284 の変更を押さえる
v2.1.284 より前は、ultracode は /effort スライダーの最上位の目盛りで、有効にすると xhigh が強制されました。2026 年 9 月の変更ログがこれを変えました：ultracode は独立したトグル —— /effort 内で Tab、または /effort ultracode on|off —— になり、xhigh を強制せず、どの effort レベルでもオンのままです。VS Code 拡張はスライダーの ultracode 目盛りをオン/オフ スイッチに置き換え（モデルピルに「· Ultracode」と表示）、新しい effortSlider キーバインドアクションとして decreaseEffort、increaseEffort、toggleUltracode が追加されました。
- 9
ultracode と max のどちらを選ぶか決める
軸が違います。max は「この一つの問題について限界まで考えろ」に答えるもの —— 最も深い生の推論、token 制約なし、ただし考えすぎのリスクが文書化されています。Ultracode は「仕事を調整しろ」に答えるもの —— 選んだレベルの上にワークフロー編成を重ねるもので、v2.1.284 以降は max とも併用できます。経験則：厄介な単一問題のデバッグ → max。順序と委任が重要な多段階の構築 → ultracode。両方なら max effort + ultracode オン。
- 10
頼る前に制約を知る
ドキュメントは ultracode が利用不可になる条件として、workflows が無効な場合、モデルが xhigh effort 非対応の場合、xhigh 未満の effort 上限がかかっている場合を挙げています。管理された maxEffortLevel や組織の上限はモデルごとにレベル一覧を縮めることがあり、非対応レベルはそのレベル以下で最も高い対応レベルにフォールバックします —— xhigh は Opus 4.6 では high として動きます。CLAUDE_CODE_EFFORT_LEVEL が xhigh 以外に固定されている場合、リクエストはそのレベルで実行され、オーケストレーションは無効のままです。設定を一切変えずに 1 ターンだけ深く考えたいときは、ultrathink キーワードでそのターン限定の深い推論を追加できます。
モデル別デフォルトとレベル一覧
次の 4 つの事実が、最も多い問い合わせを減らします：
- 1ほとんどのモデルのデフォルトは high。medium は例外であってルールではありません —— Opus 5.5 と Sonnet 5.5 のデフォルトに限ります。
- 2Opus 4.7 は xhigh がデフォルト。Opus 4.6 と Sonnet 4.6 は xhigh をまったく提供していません —— 天井を超えるレベルは最上位の対応レベルにフォールバックします。
- 3ドキュメントの effort 表に載っていないモデルは effort 非対応です。Sonnet 5.5 は v2.1.284 でこの表に加わり、デフォルトの Sonnet モデルになりました（1M コンテキスト、100 万 token あたり $2/$10、キャッシュ読み取り $0.20/Mtok）。
- 4目盛りはモデルごとに調整されています：「同じレベル名がモデル間で同じ内部値を表すわけではない」。ドキュメントの移行ガイダンスも率直です —— Opus 5.5 の medium は Opus 5 の high に匹敵またはそれを上回る、と。
何も保存されていないときの解決順序：明示的な指定（環境変数、--effort フラグ、セッション内の /effort）が最優先、次に保存済み設定（モデルごとの modelSettings、またはトップレベルの effortLevel フォールバック）、最後にモデルのデフォルト。