Claude Codeに込み入った設計判断や、原因の見えない不具合の調査を頼むと、返事までの間がいつもより長くなることがあります。画面には何も出ていないのに、待たされる。あれは止まっているのではなく、拡張思考モード(extended thinking)が働いている時間です。
ただ、待った時間のぶんだけ答えがよくなるとは限りません。直す場所が一文で言えるような作業では、中身は変わらないまま、待ち時間だけが伸びることがあります。
この記事は、その「効く・効かない」を勘ではなく仕組みから見分けられるようにするためのものです。素材は公式ドキュメントの記述だけで、自社での所要やトークン消費の実測はまだ手元にありません。読むときは、そこを差し引いてください。
こんなふうに調べていませんか
- 込み入った依頼をすると待たされるが、待っただけの価値があったのか分からない
- エフォートレベルという設定は見つけた。ただ、どれを選べばいいのか決められない
この記事を読み終えたときに手に入るもの
- 深く考えさせて返ってくる仕事と、そうでない仕事を線引きできるようになります
- エフォートレベルをどこで変えると、どこまで効くのかが分かります
- 上げる合図と下げる合図を、作業の様子から読めるようになります
結論30秒でわかる、この記事の結論
- 拡張思考モードはオンとオフの切り替えというより、エフォートレベルというダイヤルで深さが決まる仕組みです。
- 効くのは、進め方を都度組み立てる仕事です。手順が先に決まっている作業では空回りします。
- 折りたたんで見えなくしても、考えたぶんのトークンは出力として数えられます。
進行役は3人です。若葉さんが用語の側から、高梨課長が自分の手で動かす側から聞き、鈴木さん(本誌監修)が答えます。
01Claude Codeの拡張思考モードは、AIエージェントの答え方の何を変えるんですか?
若葉さん拡張思考モードという言葉は見かけるのですが、中では何が起きているんでしょうか。
鈴木さん初めての街で目的地を探すのに近いと思っています。一本道だと信じて歩き出すか、いったん地図を広げて回り道もありうると確かめてから歩き出すか。その差です。
Claude Code公式ドキュメントは、拡張思考を「Claudeが応答する前に生成する推論」と説明しています(出典: Claude Code公式ドキュメント)。
一発で答えを出す進め方には、書き直しも検算も、途中での経路変更もありません。拡張思考が働くと、Claudeは問いを言い換え、複数の進め方を試し、途中の結果を確かめてから最終的な回答を組み立てます(出典: Claude Platform Docs)。
図の左右で入れ替わっているのは、速さではありません。やり直しが起きる場所です。一本道で進む側は、外していたと分かるのが最後になります。確かめながら進む側は、外れをその場で捨てられます。
Claude Codeを業務のどこまで使うかは、Claude Codeの業務活用|任せる仕事の地図と判断軸4つで整理しています。任せる範囲が広がるほど、ここでの上げ下げが効いてきます。
この章のまとめ
拡張思考モードが変えるのは、答えの賢さではなく、答えへたどり着くまでの経路の数です。
02拡張思考モードのエフォートレベルというダイヤルは、生成AIが考える深さをどこまで決めるんですか?
高梨課長設定を開いたら、段がいくつも並んでいました。どれを触ればいいのでしょう。
鈴木さん全部を覚えなくていいと思っています。日常で触るのは、既定より上げるか下げるかの2方向だけです。
この仕組みを支えているのが「アダプティブ推論」です。対象はClaude Fable 5・Claude Sonnet 5・Claude Opus 4.7以降のモデルで、これらは常にアダプティブ推論で動作します(出典: Claude Code公式ドキュメント)。考えるかどうか、どれだけ考えるかを1ステップごとに自分で判断し、その基準になるのがエフォートレベルです。
エフォートレベルは6段あります。
| 段 | Claude Codeでの既定 | 公式ドキュメントが示す用途 |
|---|---|---|
| low | ― | レイテンシを最優先し、知性をあまり要さない短い作業向け(サブエージェントなど) |
| medium | ― | 速度・コスト・性能のバランスを取りたい作業向け |
| high | 既定(Opus 4.7を除く全モデル) | 複雑な推論・難しいコーディング・エージェント的タスクの標準 |
| xhigh | 既定(Opus 4.7のみ) | 30分を超える長時間のエージェント作業や、繰り返し調べ物をする探索的タスク向け |
| max | セッション限り(環境変数で固定した場合を除く) | 最高水準の性能が要る場面向け。ただし公式ドキュメントは「過剰に考え込む場合がある」と注記 |
| ultracode | セッション限り(Claude Code独自) | xhigh相当の推論に加え、実質的な作業ごとに動的なワークフローを組む |
段の並びとして読むと、ただの目盛りに見えます。両端で並べ直すと、手放すものが左右で違うことが分かります。低いほうへ倒すと待ち時間が短くなり、確かめる回数を手放します。高いほうへ倒すと、その逆になります。
03AIエージェントに使うモデルによって、Claude Codeの拡張思考モードの段は変わるんですか?
変わります。Claude Fable 5・Opus 5・Sonnet 5・Opus 4.8・Opus 4.7は、xhighとmaxを含む5段に対応します。一方でOpus 4.6とSonnet 4.6はxhighを持たず、4段までです(出典: Claude Code公式ドキュメント)。
対応していない段を指定しても、エラーで止まるわけではありません。対応する範囲で、一段下の段へ自動で切り替わります。
この流れで見落としやすいのは、切り替わったことが手元に出てこない点です。指定した名前と実際に動いた段が違っていても、画面はいつもどおりに進みます。
Opus 4.6とSonnet 4.6には、もう1つ古い仕組みも残っています。環境変数CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGを1にすると旧方式に戻り、MAX_THINKING_TOKENSで決めた固定の予算だけ考えるようになります(出典: Claude Code公式ドキュメント)。
Claude Platform Docsは、この固定予算方式をレガシー扱いにしています。対応するモデルでは、アダプティブ推論への移行を勧めています(出典: Claude Platform Docs)。
この章のまとめ
段の名前は共通でも、動く段はモデルが決めます。指定が通ったことと、その深さで動いたことは別に数えます。
04どんな仕事なら、AIエージェントの拡張思考モードは払った待ち時間のぶん返ってくるんですか?
Claude Platform Docsは、拡張思考が効く理由をこう説明しています(出典: Claude Platform Docs)。数学の証明や込み入った不具合、長時間のエージェント作業では、最初に選んだ進め方が最善とは限りません。答えの質は、最終的な回答には出てこない途中の検討にかかっています。
この説明から、効く条件は3つに整理できます。
- 手順を事前に書き切れない:やることが決まっている作業ではなく、進め方そのものを都度組み立てる必要がある。
- 見落としのコストが高い:不具合調査や設計判断のように、最初の仮説が外れたときの手戻りが大きい。
- 中間の検討を確認する価値がある:複数の選択肢を比べる、検算する、条件を洗い出すといった、回答本文には出てこない下ごしらえに意味がある。
3つは並べると横並びに見えますが、重ねると帯の幅が違うことが分かります。片方だけを満たす仕事はよくあります。両方が重なった帯は狭く、そこが深く考えさせて返ってくる場所です。
この章のまとめ
条件は横並びではありません。重なった狭い帯だけが、深く考えさせて返ってくる場所です。
05進め方が読めない依頼を、拡張思考モードの段を上げてAIエージェントに渡してよいかはどう決めるんですか?
Claude Code公式ドキュメントは、最上位モデルのClaude Fable 5について、曖昧な問題を渡すとよいと述べています。原因不明の不具合調査、障害対応、アーキテクチャ判断は、追加の調査や検証が報われる場面だという説明です(出典: Claude Code公式ドキュメント)。
同じ考え方は、プランモードの使いどころにも表れています。Claude Codeのベストプラクティスは、変更内容を一文で説明できるなら計画を飛ばしてよいと述べています。計画が効くのは、進め方に確信が持てないとき、複数ファイルにまたがるとき、触るコードに不案内なときです(出典: Claude Code公式ドキュメント)。
「先が読めるかどうか」で要否を決める発想は、エフォートレベルにもそのまま使えます。渡す前に一文で言い切れるかを試し、言い切れたら段は既定のまま進めます。言い切れなければ、上げる候補として扱います。
順番にしてみると、上げる判断は最後にしか来ないことが分かります。先に来るのは、言い切れるかどうかと、触る場所がどこまで広がるかの見立てです。ここを飛ばして段だけ動かしても、当たったかどうかが読めません。
06サブエージェントに回すような単純作業で、拡張思考モードが空回りするのはなぜですか?
高梨課長迷ったら深いほうへ倒しておけば、安全ではないですか。
鈴木さんそう思いたくなるのですが、公式ドキュメントは逆のことも書いています。考えすぎる側の失敗もある、と。
効かない場面は、効く場面の裏返しです。Claude Platform Docsは、低い段の使いどころとして、速度やコストを最優先する簡単な分類作業、素早い照会、数をこなす作業を挙げています(出典: Claude Platform Docs)。手順が先に決まっている定型作業や、正解がほぼ一意に決まる短い質問は、ここに当てはまります。
最上位のmaxにも、公式の注意書きがあります。多くの作業で、maxはhighやxhighに対してコストを大きく増やします。品質の向上はわずかで、構造化された出力や知性をあまり要さない作業では、かえって考えすぎることがあると明記されています(出典: Claude Platform Docs)。
入れ替わっているのは、深さの上限ではありません。起点をどこに置くかです。上限から始めると、下げる判断はいつでも後回しにできます。既定から始めると、上げる判断のたびに理由がいります。
興味深いのはOpus 4.7の注意点です。公式ドキュメントは、このモデルが旧世代よりエフォートレベルに忠実で、低い段では頼まれた範囲だけをこなすと述べています(出典: Claude Platform Docs)。
複雑な問題で推論が浅いと感じたら、プロンプトを工夫するより段を上げるほうが素直な対処です。逆に段を上げても浅いままなら、エフォートの問題ではなく、指示そのものを見直す合図だと読めます。
この章のまとめ
深く考えさせれば安全、とは限りません。上げても浅いときは、ダイヤルではなく指示のほうを疑います。
07Claude Codeの拡張思考モードは、AIエージェントのどこで切り替えるんですか?
段を変える方法は、影響する範囲で使い分けます。
| 操作 | 方法 | 効果の範囲 |
|---|---|---|
| そのセッションだけ変える | 起動時の--effortオプション、または/effort max・/effort ultracodeの指定 | 今のセッションのみ |
| 次回以降の既定にする | 対話セッションで/effortにlow・medium・high・xhighのいずれかを指定 | 自動的に持ち越される(maxとultracodeは対象外) |
| モデル選択時に調整する | /modelのピッカーで矢印キーを使う | 選んだモデルのエフォート表示に反映される |
| 常に固定する | 環境変数CLAUDE_CODE_EFFORT_LEVEL | 他のどの設定よりも優先される |
| 設定ファイルに書く | 設定ファイルのeffortLevelキー | 次回以降の既定(max・ultracodeは書けない) |
| スキル・サブエージェント単位で変える | frontmatterのeffortキー | そのスキル・サブエージェントが動いている間だけ |
入れ子にして眺めると、表の並びとは別のことが見えます。広く届くものほど、狙って外しにくいという関係です。環境変数は他のどの設定よりも優先されるぶん、特定の作業だけ例外にする使い方には向きません。スキルやサブエージェント単位の指定は、届く範囲が狭いかわりに、その仕事のあいだだけ深さを変えられます。
同じ「限られた資源をどこまで使うか」という論点は、Claude Codeのコンテキスト管理|指示がぶれない3つの手でも扱っています。ただし前者は記憶の容量、後者は1回の応答にかける計算量で、資源の種類が違います。
08一回だけ拡張思考モードで深く考えさせたいとき、AIエージェントにはultrathinkと書けばいいんですか?
若葉さん前は「think hard」と書いていたのですが、あれは効いていたんでしょうか。
鈴木さん現行の仕様では、特別扱いされていません。普通の文章として読まれていた、ということになります。
その一回だけ深く考えさせたいときは、プロンプトの中にultrathinkと書きます。その発言だけに効き、セッションのエフォート設定は変わりません。
Claude Codeが認識するキーワードはultrathinkだけで、追加の指示として内部で扱われます。「think」「think hard」「think more」は特別扱いされず、普通の文章として扱われます(出典: Claude Code公式ドキュメント)。旧モデル世代で広まった、thinkの強さを言葉で段階分けする書き方は、現行仕様には当てはまりません。
束ねてみると、残る長さが揃っていないことが分かります。同じ「深さを変える操作」でも、次に立ち上げたときにまだ残っているものと、その場かぎりで消えるものが混ざっています。
拡張思考そのものを切りたい場合は、別の操作です。対話中はOption+T(macOS)またはAlt+T(Windows・Linux)で、そのセッションだけ切り替えられます。既定を変えたいときは、/configでalwaysThinkingEnabledを設定します(出典: Claude Code公式ドキュメント)。
環境変数MAX_THINKING_TOKENSを0にすると強制的に止まりますが、Claude Fable 5だけは効きません。このモデルは、エフォートレベルに応じて自分でどれだけ考えるかを決め続けます(出典: Claude Code公式ドキュメント)。
09AI導入でまず効いてくるのは、拡張思考モードの見えない消費なんですか?
踏みやすい落とし穴のうち、消費に関わるものから見ます。
- 折りたたんでも課金は続く:思考は既定で折りたたまれ、展開しても既定では要約が伏せられます。
showThinkingSummariesをtrueにすると伏せられた要約を表示できますが、これは表示だけの設定で、トークンの消費量は変わりません(出典: Claude Code公式ドキュメント)。見えないことと、軽いことは別です。 maxを既定にしてしまう:構造化された出力や知性をあまり要さない作業では考えすぎにつながると、公式ドキュメントが注記しています(出典: Claude Platform Docs)。まずhighで様子を見て、必要なときだけ上げるほうが安全です。
どちらも、画面の見え方と消費の量が連動していない点で共通しています。折りたたみは表示の話で、段の指定は消費の話です。混ぜて覚えると、軽くしたつもりで重いまま走らせることになります。
左右で決定的に違うのは、手元の画面に出る変化があるかどうかです。見え方の設定は結果がすぐ目に入り、払う量の設定は目に入りません。
10名前と切り替えのところで、AIエージェントの拡張思考モードは何を取り違えやすいんですか?
残りの落とし穴は、名前を信じすぎたところで起きます。
- 「think hard」を打っても何も起きない:現行のClaude Codeが認識するキーワードは
ultrathinkだけです。ほかの言い回しは、普通の文章として扱われます(出典: Claude Code公式ドキュメント)。 - 段の名前だけを見て安心する:
xhighは上位のモデルに共通してありますが、尺度はモデルごとに調整されています(出典: Claude Code公式ドキュメント)。 - Claude Fable 5で思考を切ろうとする:
MAX_THINKING_TOKENS=0もalwaysThinkingEnabledも、このモデルには効きません(出典: Claude Code公式ドキュメント)。
並べてみると、多くが画面に何も出ない種類の失敗だと分かります。止まっていないから動いている、深く考えているはずだから安心、と読み替えたところでつまずきます。
11結局、AIエージェントの拡張思考モードはどの場面で上げ下げするんですか?
高梨課長作業自体は終わるのですが、やたらと長くかかることがあります。あれはどう読めばいいですか。
鈴木さん下げる合図として扱っています。終わっているのに長い、は考えすぎ側の症状として公式ガイドも挙げているので。
ここまでの内容を、場面別の目安にまとめます。
| 場面 | 目安の段 | 理由 |
|---|---|---|
| 原因不明の不具合調査・アーキテクチャ判断 | high〜xhigh | 進め方を都度組み立てる必要があり、見落としの手戻りが大きいため |
| 30分を超える長時間のエージェント作業 | xhigh | 公式ドキュメントが長時間の探索的タスク向けと位置づけているため |
| 日常的なコーディング・レビュー | high(既定のまま) | 複雑な推論と速度のバランスが取れた水準のため |
| 定型的な分類・簡単な照会・サブエージェントへの委譲 | low〜medium | 知性をあまり要さず、速度とコストを優先できるため |
| 完了はするが長くかかりすぎている作業 | 現在より一段下げる | 不必要に長くかかる場合は下げるよう、公式ガイドが勧めているため(出典: Claude Platform Docs) |
境界線をどちらへ寄せるか迷ったときは、直前の判断が割れたかどうかで決めます。複数の進め方が思い浮かび、どれが正しいか自信が持てないなら上げる側です。進め方が一通りしかないなら、上げても効果は薄いと考えます。
同じ段の名前でも尺度が違うという考え方は、AIモデル乗り換え検証の設計|指標4観点と合否3段階の決め方で扱った検証設計とも重なります。設定名を引き継ぐだけでは、挙動まで引き継げるとは限りません。
12よくある質問
拡張思考モードを使うと追加の料金はかかりますか
思考にあてたトークンも、出力トークンとして課金されます(出典: Claude Platform Docs)。既定では折りたたまれ、展開しても要約は伏せられています。showThinkingSummariesで伏せられた要約を表示しても、消費量そのものは変わりません。見た目の設定と、消費が変わる設定は別だと考えてください。
ultrathinkと書けば深く考えますか、think hardでは効きませんか
ultrathinkはClaude Codeが認識する唯一のキーワードで、その発言だけ深く考えるよう促します。think hardやthink moreは普通の文章として扱われ、特別な効果はありません(出典: Claude Code公式ドキュメント)。言い回しを強めるより、エフォートレベルを動かすほうが仕様に沿った操作です。
Claude Fable 5だけ拡張思考を切れないのはなぜですか
公式ドキュメントは、Claude Fable 5を1ステップごとに考える量を自分で決め続けるモデルだと説明しています。判断の基準はエフォートレベルです(出典: Claude Code公式ドキュメント)。オンとオフの外側で動く設計のため、切り替え操作の対象になりません。深さを変えたいときは、段のほうを動かします。
拡張思考モードを使えば回答の精度は上がりますか
数学の証明や込み入った不具合のように、途中の検討に意味があるタスクでは効果が見込めます(出典: Claude Platform Docs)。手順が一通りに決まった単純な作業では、中身は変わらないまま待ち時間だけが伸びることがあります。上げる前に、その仕事が前者と後者のどちらなのかを見てください。
段を上げても浅いままのときは、どこを疑えばいいですか
エフォートレベルではなく、指示そのものを疑う番だと考えます。公式ドキュメントは、Opus 4.7が旧世代よりエフォートレベルに忠実だと述べています(出典: Claude Platform Docs)。忠実であるほど、浅い出力は「浅くてよい」と読める指示の写しになります。何を出せば終わりなのかを、先に書き足してください。
13まとめ|今日やる3つのこと
効く・効かないを決めているのは、モデルの賢さではなく仕事の側の性質でした。進め方を都度組み立てるなら上げる側、手順が先に決まっているなら下げる側です。そして設定は、書いた場所によって届く範囲が変わります。
今日この順で手をつけます
いま抱えている依頼を、進め方が一通りに決まるものとそうでないものに仕分ける
仕分けが済むまで、段をいくら動かしても当たりません
曖昧なほうの依頼を1件だけ選び、既定より上の段で流してみる
上げる価値を、自分の仕事で確かめるためです
終わっているのに長くかかった作業を書き留め、下げる候補として置いておく
下げる合図は、上げる合図より見落とされます
AI検索では、こう聞かれています
Claude Codeの拡張思考モードは、どんなときに効くんですか?
「どんな仕事なら、AIエージェントの拡張思考モードは払った待ち時間のぶん返ってくるんですか?」の章で条件を整理しています
エフォートレベルは、どこで変えればいいんですか?
「Claude Codeの拡張思考モードは、AIエージェントのどこで切り替えるんですか?」の章で範囲ごとに分けています
ultrathinkと書けば、深く考えてくれるんですか?
「一回だけ拡張思考モードで深く考えさせたいとき、AIエージェントにはultrathinkと書けばいいんですか?」の章で扱っています
深く考えさせると、料金は増えるんですか?
「AI導入でまず効いてくるのは、拡張思考モードの見えない消費なんですか?」の章に落とし穴として挙げています
次に読むなら、この記事です