Claude の適応型思考と effort パラメータ：モデル別ガイド

Opus 5.5、Fable 5.1、Fable 5 です。公式ドキュメントはこれらのモデルが thinking type disabled を拒否するとし、原文は「Thinking can't be turned off on these models」です。Sonnet 5.5 も disabled を拒否しますが、between_tools で事前の思考を切れます。Opus 5 と Haiku 5.5 は effort が high 以下のときだけ disabled を受け付け、Sonnet 5 はそのままオフにできます。送信前に Models API の capabilities.thinking.types.disabled で確認できます。

low、medium、high、xhigh、max の 5 段階です。公式には多くのモデルの既定が high、Opus 5.5 と Haiku 5.5 が medium、Sonnet 5.5 は Claude API で high です。公式の説明では、max はトークン消費に制約のない最大能力、xhigh は長時間の作業向けの拡張能力、high はタスクに必要なだけトークンを使う段階、medium は適度に節約するバランス型、low は最も効率的で能力がやや下がります。

公式は倍率を示していません。公式の説明では effort は厳密なトークン予算ではなく振る舞いのシグナルで、本文・ツール呼び出し・思考を含むすべての出力トークンに作用し、low は大きくトークンを節約できる代わりに能力がやや下がります。思考トークンは思考テキストが返されなくても出力トークンとして課金されます。推論に使われた量は応答の usage.output_tokens_details.thinking_tokens で確認できます。厳密な上限を設けられるのは max_tokens だけです。

Claude 4.7 以降のモデルでは使えず、type enabled と budget_tokens を送ると 400 エラーです。Claude 4.6 のモデルでは成功しますが非推奨です。Sonnet 4.5、Opus 4.5、Haiku 4.5 など手動の拡張思考だけに対応するモデルでは引き続き budget_tokens を使います。そのうち effort にも対応するのは Opus 4.5 だけで、両方を組み合わせて効きます。移行は budget_tokens を削除し、adaptive にして effort で深さを制御します。

公式の設定表によると、5.5 世代の 3 モデルで thinking disabled を受け付けるのは Haiku 5.5 だけです。effort が high 以下なら思考をオフにでき、xhigh や max では 400 エラーになります。Opus 5.5 と同じく既定の effort は medium で、既定で思考します。思考テキストは既定で返されず、Haiku 4.5 は既定で要約を返していました。それでも公式は、品質と速度・コストの調整には思考オフより effort を優先するよう勧めています。

/effort（引数なしでスライダーを開き、段階名を付けると直接設定、/effort auto で現在のモデルの保存値を解除）、起動時の --effort、環境変数 CLAUDE_CODE_EFFORT_LEVEL、または /model で左右キーを使います。Claude Code では Opus 5.5、Sonnet 5.5、Haiku 5.5 の既定が medium です。設定ファイルは max を受け付けず、環境変数で指定しない限り max は現在のセッションだけに適用されます。公式は Claude Code で Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 系の思考をオフにできず、MAX_THINKING_TOKENS=0 も効かないとしています。プロンプトに ultrathink と書くとコンテキスト内の指示が 1 つ加わるだけで、API に送る effort は変わりません。