Claude Code ultrathink・Thinking Levels完全ガイド｜think・megathink・ultrathink・/effortの違いと使い分け・コスト最適化

「なんとなくultrathinkと書いているけど本当に効果があるのか？」「/effortコマンドと何が違うのか？」Claude Codeの思考制御機能は、一度廃止されてユーザーの反発で復活するという経緯もあり、情報が錯綜しています。

この記事ではultrathinkを含むThinking Levelsの全体像を整理します。キーワードごとのトークン予算・/effortコマンドとの使い分け・MAX_THINKING_TOKENS環境変数による細かい制御・Claude 4.6でのAdaptive Thinkingの変化まで、正確な最新情報をもとに解説します。Plan Modeとの組み合わせはPlan Mode完全ガイドも参照してください。

ultrathinkが一時廃止されて復活した経緯

2026年1月のv2.1.0リリースで、Anthropicは「思考の自動化」を導入しました。モデルが自動で必要な思考量を判断する仕組みです。この変更に伴い、think/think hard/ultrathinkなどのキーワードによる手動制御が事実上廃止されました。

しかし直後から問題が噴出します。GitHub Issue #19098「Quality degradation since automatic thinking」には数百件のコメントが集まり、ユーザーから「指示を無視するようになった」「推論の深度が明らかに下がった」「セッションの90%以上で手動修正が必要になった」「Opus 4.6の料金を払っているのに安いモデルの挙動をする」という報告が相次ぎました。

Anthropicはこの反発を受け、2026年3月4日のv2.1.68でultrathinkキーワードを復活させました。同時に/effortコマンドによるセッション単位の思考レベル設定も導入されました。現在は「キーワードで1ターンだけ変更」と「コマンドでセッション全体を変更」という2つのアプローチが共存しています。

Thinking Levelsの全体像とトークン予算

Claude Codeはプロンプト内の特定キーワードを検出し、思考に使うトークンの上限（予算）を変化させます。通常の会話では思考トークンが少ない分レスポンスが速く、ultrathinkなどを指定すると深く考える分レスポンスが遅くなります。

キーワードの使い方

# think：軽い思考
claude "think このnull参照エラーの原因を調べてください"

# megathink：中程度の思考
claude "megathink このAPIのレート制限設計を検討してください"

# ultrathink：深い思考
claude "ultrathink このサービスをマイクロサービスに分割する際のトレードオフを分析してください"

# 文の途中でも有効
claude "認証フローが壊れている原因を ultrathink で分析してください"

/effortコマンド：セッション全体の思考レベルを変更する

/effortコマンドはキーワードと異なり、変更するまでセッション全体に適用されます。長時間の設計作業や大規模リファクタリングなど、ずっと深く考えてほしい場面に向いています。

# 対話中にいつでも変更可能
/effort low      # 速度優先・シンプルなタスク向け
/effort medium   # バランス型（Opus 4.6/Sonnet 4.6のデフォルト）
/effort high     # ultrathinkと同等・複雑な問題向け
/effort max      # Opus 4.6専用・トークン上限なし
/effort auto     # モデルが自動判断（/effort設定なしの状態）

effortレベルを使い分けるワークフロー例

1. /effort highで設計フェーズに入る
2. アーキテクチャの検討・複数案の比較を実施
3. /effort mediumに戻して実装フェーズへ
4. 通常のコーディング・ファイル編集を進める
5. 詰まった問題があればプロンプトにultrathinkを追加して1ターンだけ深掘り

MAX_THINKING_TOKENSとalwaysThinkingEnabledの設定

MAX_THINKING_TOKENSでトークン上限をカスタマイズ

MAX_THINKING_TOKENS環境変数で思考トークンの上限を変更できます。デフォルトは31,999トークン（ultrathinkの上限と同じ）ですが、1,024〜200,000の範囲で設定可能です。

{
  "env": {
    "MAX_THINKING_TOKENS": "63999"
  }
}

alwaysThinkingEnabledでデフォルトをThinkingモードにする

{
  "alwaysThinkingEnabled": true
}

この設定をtrueにするとデフォルトでThinkingモードが有効になります。ただしv2.1.68以降は/effortコマンドによる管理が主流になっており、alwaysThinkingEnabledとの相互作用に関しては公式ドキュメントで注意書きがあります。コスト管理の観点から、特段の理由がなければ/effortコマンドでの管理が推奨です。

Plan Mode × ultrathinkの組み合わせ

Plan Mode（Shift+Tab で切り替え）とultrathinkの組み合わせは、複雑な問題に対して特に効果的です。Plan Modeで実装前に計画を深く練り、承認後に実装モードに戻すというフローが推奨されています。

# 1. まずPlan Modeに切り替える（Shift+Tabを押す）
# ターミナル上でShift+Tabを押すと [plan] モードに切り替わる

# 2. ultrathinkを付けて設計を依頼
# "ultrathink でこのマイクロサービス分割の設計を考えてください。
#  トレードオフを複数の視点から比較し、具体的な実装方針を提示してください。"

# 3. 計画内容を批判的に検証させる（revving the engine）
# "この計画の問題点・リスク・見落としを指摘してください"

# 4. 計画を承認してから実装に進む
# Shift+Tabでplan modeを解除して実装モードへ

Claude 4.6のAdaptive Thinking（API開発者向け）

API経由でExtended Thinkingを使う場合、Claude 4.6（Opus/Sonnet）では仕様が大きく変わりました。これはClaude Code CLIではなく、Anthropic APIを直接使うアプリケーション向けの情報です。

旧仕様（Claude 3.7・Opus 4まで）

// Claude 3.7 Sonnet / Opus 4 まで
const response = await anthropic.messages.create({
  model: "claude-opus-4-0",
  max_tokens: 16000,
  thinking: {
    type: "enabled",
    budget_tokens: 10000,  // 固定の思考トークン予算
  },
  messages: [{ role: "user", content: "..." }],
});

新仕様（Claude 4.6：Adaptive Thinking）

// Claude Opus 4.6 / Sonnet 4.6
const response = await anthropic.messages.create({
  model: "claude-opus-4-6",
  max_tokens: 16000,
  thinking: {
    type: "adaptive",   // "enabled"は非推奨（deprecated）
    effort: "medium",   // "low" | "medium" | "high" | "max"
  },
  messages: [{ role: "user", content: "..." }],
});

Interleaved Thinking：ツール呼び出し間の思考

Adaptive modeではInterleaved Thinkingが自動的に有効になります。従来はプロンプト受信時にだけ思考していましたが、Interleaved Thinkingではツール実行結果を受け取るたびに思考ブロックが挿入されます。

• ファイルを読む → 思考 → 別ファイルを読む → 思考 → コードを修正する、という多段推論が可能
• 複雑なバグを調査する際に、ログを見ながら段階的に原因を絞り込める
• Opus 4.6ではAdaptive modeで自動有効。Sonnet 4.6ではbetaヘッダーが必要

Thinking Levelsの効果とコストのトレードオフ

どんな問題に使うと効果的か

コストの目安と最適化

ultrathinkはデフォルトで1ターンあたり最大31,999トークンの思考が走ります。Opus 4.6は出力1Mトークンあたり$75なので、1ターンで最大約$2.4が思考トークンのみでかかります。ただし往復回数が減ることで総コストが下がるケースが多いという報告もあります。

• 設計フェーズの最初の1〜2ターンにultrathinkを使い、実装フェーズは通常レベルに戻す
• Sonnet 4.6（Opus 4.6より低コスト）でultrathinkを使い、簡単な実装はSonnet 4.6通常モードで行う
• /effort mediumをデフォルトにして、詰まったときだけultrathinkを単発で使う
• コスト状況は/costコマンドで確認できる

よくある質問