/effort (エフォートレベル)

エフォートレベルは adaptive reasoning (適応的な推論) を制御し、モデルはタスクの複雑さに応じて、各ステップで考えるかどうか、どれだけ考えるかを判断します。低いレベルは単純な作業で速く安価に動き、高いレベルは複雑な問題でより深く推論します。

エフォートレベルは、モデルが各ステップで考えるかどうか、どれだけ考えるかを左右する設定です。

• レベルのスケールはモデルごとに調整されており、同じレベル名でもモデルが違えば内部の値は同じではありません。
• 使用中のモデルが対応していないレベルを設定すると、設定したレベル以下で対応している最も高いレベルにフォールバックします。
• xhigh は high と max の間のレベルです。max は最も深い推論レベルで、CLAUDE_CODE_EFFORT_LEVEL で設定した場合を除き、現在のセッションにだけ適用されます。
• ターミナルのセッションでは、/effort が新しいレベルを確定した後、次に送るメッセージからそのレベルで動作します。
• セッションヘッダーには設定中のレベル (例: 「with low effort」) が表示され、フッターにも起動時と変更時に短く表示されます。

• /effort のスライダーや /model のピッカーで Enter を押すか、/effort の後にレベルを入力すると、そのレベルが既定として保存され、後のセッションにも適用されます。既定として保持される場合は /effort が確認を表示します。
• スライダーやピッカーで s を押すと、現在のセッションだけに適用されます。
• レベルはユーザー設定の modelSettings キーにモデルごとに保存されます。モデルごとの保存になる前に保存したレベルは、Opus 5.5 などの新しいモデルには適用されず、レベルを選ぶまでは既定値から始まります。
• -p の実行で /effort を使うと、そのセッションだけに適用され、既定としては保存されません。
• --effort は、新しいモデルの既定エフォートの保持を、そのセッションに限って解除します。
• セッションのレベルを決めるときは、環境変数 CLAUDE_CODE_EFFORT_LEVEL が最も優先されます。

• プロンプトのどこかに ultrathink を含めると、セッションのエフォート設定を変えずに、そのターンだけより深い推論を求められます。「think」「think hard」「think more」などの言い回しは通常のテキストとして扱われ、キーワードとしては認識されません。
• プロンプトや CLAUDE.md で考える頻度を増やす・減らすよう伝えると、モデルはエフォート設定の範囲内でその指示に応じます。
• Ultracode はモデルのエフォートレベルではなく、Claude Code の設定です。オンにすると、Claude は実質的なタスクに対して、セッションのエフォートレベルのまま dynamic workflows を組み立てて進めます。
• /effort ultracode で現在のセッションでオンにし、/effort ultracode off でオフにします。スライダーでは Tab で切り替えて Enter で適用します。
• --effort ultracode フラグと Agent SDK の effortLevel: "ultracode" は、Ultracode をオンにしたうえでレベルを xhigh に設定します。
• workflows がオフの場合や、モデルが xhigh に対応していない場合、Ultracode は使えません。

メインの会話と同じモデルでは、独自の effort を持たないサブエージェントやチームメイトは、セッションで選んだレベルまたは --effort で設定したレベルで動作します。別のモデルでは、そのレベルは適用されません。環境変数 CLAUDE_CODE_SUBAGENT_EFFORT を使うと、ほかに指定が無い場合にサブエージェントが動作するレベルを、セッションから引き継ぐ代わりに設定できます。

• managed settings で effortLevel を設定しても、ユーザーは /effort や --effort でレベルを変更できます。一定のレベル以下に抑えるには maxEffortLevel を設定します。maxEffortLevel はトップレベル、または modelSettings 配下でモデルごとに設定できます。
• エフォートレベルを送らないようにするには、CLAUDE_CODE_EFFORT_LEVEL を auto または unset で export したシェルから claude を起動します。/effort status を実行し、「Effort level: auto」と表示されることで確認できます。
• モデルがエフォートレベルに対応している場合、OpenTelemetry の cost.usage・token.usage・api_request・api_error に effort 属性が含まれます。
• セッションのトランスクリプトには、アシスタントの各メッセージの推論エフォートレベルが記録されます。ステータスラインの stdin JSON にも effort.level が含まれます。

1. /effort を引数なしで実行すると、インタラクティブなスライダーが開きます。/effort の後にレベル名を付けると直接設定でき、/effort auto で使用中のモデルの保存済みレベルを消去できます。
2. /model でモデルを選ぶときは、左右の矢印キーでエフォートのスライダーを調整します。
3. Claude Code の起動時に --effort フラグにレベル名を渡すと、そのセッションだけのレベルを設定できます。
4. 環境変数 CLAUDE_CODE_EFFORT_LEVEL にレベル名を設定します。
5. 設定ファイルでは、modelSettings にモデルごとのレベルを設定するか、effortLevel に low・medium・high・xhigh のいずれかを、個別の設定が無いモデルの既定として設定します。max はどちらのキーでも受け付けません。
6. スキルやサブエージェントの markdown ファイルのフロントマターに effort を設定すると、そのスキルやサブエージェントの実行時にレベルを上書きできます。