Claude Code effortLevel 設定

tags : Claude Code, AI

概要

Claude Code の推論深度を制御する設定。モデルが応答前にどれだけ内部思考を行うかを決定する。

レベル一覧

レベル	説明
low	最小限の思考（最速・最安）
medium	標準的な推論
high	深い推論（デフォルト）
max	最大限の推論、トークン制限なし（Opus 4.6のみ）

設定方法（優先度順）

1. *環境変数*（最優先）: export CLAUDE_CODE_EFFORT_LEVEL=max
2. セッション中コマンド: /effort max
3. CLI フラグ: claude --effort max
4. settings.json: { "effortLevel": "high" }
5. スキル/サブエージェント frontmatter: effort: high （環境変数は上書きしない）

注意点

• max は settings.json では永続化できないバグがある → 環境変数での設定が必要
• /effort の表示が環境変数を反映しない場合がある（表示上の問題で実際には適用済み）
• プロンプト中に ultrathink と書くとそのターンだけ high effort を強制できる
• CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 で adaptive thinking 自体を無効化可能

モデル対応状況

• Opus 4.6: フル対応（ max 含む）
• Sonnet 4.6: フル対応
• 旧モデル: 固定 thinking budget、effortLevel の効果は限定的