掲載済み (2026-03-14号)
#089 132文字 • 1分

Claude CodeのEffort、実は4段階ある ― "max" の使い方とソースコード調査

日本語

掲載情報

概要

Claude CodeのUIやドキュメントに未記載の最上位推論レベル「max」について、ソースコード解析からその有効性と適用方法を明らかにした技術調査記事。

詳細内容

Claude Code(AnthropicのCLIツール)の推論深度を制御する`effortLevel`設定には、公式ドキュメントに記載された3段階(low, medium, high)以外に、APIレベルで定義された第4のレベル「max」が存在します。著者はCLI v2.1.66のソースコードを解析し、UI(/modelピッカー)やCLI引数(--effort)では「max」に制限やバリデーションがかけられているものの、`settings.json`や環境変数(CLAUDE_CODE_EFFORT_LEVEL)を介することで、対話モードでもこの制限をバイパスして適用できることを特定しました。また、Opus 4.6以外のモデル(Sonnet 4.6等)で「max」を指定した場合、API側でサイレントにフォールバックが行われる実態など、ドキュメント化されていない詳細な内部挙動についても解説しています。