環境変数

MAX_THINKING_TOKENS

拡張思考のための固定トークン予算。Claude Code はこれをリクエストの最大出力トークンより1トークン少ない値に制限し、1,024未満にはしない。その上限の設定方法は CLAUDE_CODE_MAX_OUTPUT_TOKENS を参照。未設定で思考が有効なとき、適応的推論を持つモデルは自身で思考の深さを選び、その他のモデルは上限値を使用する。Anthropic API 上で思考を無効にするには 0 を設定する。ただし思考をオフにできない Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable モデルは例外。サードパーティプロバイダーでは、0 は思考パラメーターの省略になる。Anthropic API 上で思考が無効のとき、Claude Code は Opus 5 のようにその組み合わせを受け付けないと認識しているモデルには、より高いレベルの代わりに effort high を送信する。正の値を設定した場合、CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING で適応的推論を無効にしていない限り、Claude Code は適応的推論モデルではその数値自体を無視する。

使い方・用途

  • 固定思考予算のモデルで、思考トークンが高コストになるのを避けるため予算を例えば MAX_THINKING_TOKENS=8000 のように引き下げたいときに使う。
  • アダプティブリドニングではないモデルで考えるトークンの上限を抑え、応答全体の中で思考に使われる割合を調整したいときに使う。
  • Claude API で既定で考えるモデルの思考を無効化したい場合に MAX_THINKING_TOKENS=0 を設定するという使い方がある。
英語原文(公式ドキュメントより)

Fixed token budget for extended thinking. Claude Code caps it at one token below the request's max output tokens and never below 1,024. See CLAUDE_CODE_MAX_OUTPUT_TOKENS for how that limit is set. When unset and thinking is enabled, models with adaptive reasoning choose their own thinking depth, and other models use the cap. Set to 0 to disable thinking on the Anthropic API, except on Opus 5.5, Sonnet 5.5, Haiku 5.5, and the Fable models, which can't have thinking turned off. On third-party providers, 0 omits the thinking parameter instead. With thinking turned off on the Anthropic API, Claude Code sends effort high instead of a higher level to models it knows don't accept that combination, such as Opus 5. For a positive value, Claude Code ignores the number itself on adaptive reasoning models, except when CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING turns adaptive reasoning off

関連ドキュメント

関連する変更履歴

v2.1.166(1件)

Changed
MAX_THINKING_TOKENS=0 や --thinking disabled、またはモデルごとのトグル設定によって、デフォルトで思考(Thinking)を行うモデルの思考機能を無効化できるようになりました。
英語原文を表示
MAX_THINKING_TOKENS=0, --thinking disabled, and the per-model thinking toggle now disable thinking on models that think by default via the Claude API (3P providers unchanged)

変更後

思考時間を短縮して素早く回答を得たい場合や、トークン消費を抑えたい場合に、柔軟に動作をコントロールできます。

関連ドキュメント