Claude Code: サブエージェントの effort は環境変数かエージェント定義で下げ、/usage で確かめる ※モデル・料金
サブエージェントは何も指定しないと親セッションの effort を受け継ぐ。親を xhigh にしたまま並列で何本も起動すると、その分だけ使用量が積み上がる。サブエージェントだけ low などに下げ、効いたかは /usage で確かめる。
どんな時に使う？
- 親セッションは xhigh や max で考えさせたいが、調べ物や一括置換のサブエージェントまで同じ重さで回したくない
/goal・Workflows・Agent Teams・長い SDK ジョブを回したあと、使用上限の減りが早いと感じる
手順
- 起動時にまとめて下げる:
CLAUDE_CODE_SUBAGENT_EFFORT=low claude（2.1.316 の CHANGELOG で正式に載った。それより前の版では効かない） - エージェントごとに決める（こちらは既にドキュメントにある方法）:
.claude/agents/<name>.mdのフロントマターにeffort: lowと書く。値はlow/medium/high/xhigh/maxで、使えるレベルはモデルによって違う - その場だけ変える: 「この調査は effort low のサブエージェントで」と頼むと、Claude が Agent ツールの
effortパラメータを渡す（v2.1.292 以降。フォーク型のサブエージェントは対象外） - 効果を見る:
/usageを開き、プラン上限に何が効いているかの内訳を見る。f to fixが出ていればfで/effortの推奨変更をそのまま適用できる（v2.1.305 以降） - 実行中のサブエージェントのモデルと effort は
/tasksの行に出る
注意点
- 優先順位は、
CLAUDE_CODE_EFFORT_LEVEL環境変数 ＞ 呼び出しごとのeffortパラメータ ＞ エージェント定義のeffort＞ セッションの effort。CLAUDE_CODE_EFFORT_LEVELを設定していると、サブエージェント側の指定はどれも効かない - @bcherny は使用量の調査で退行は見つからなかったとしたうえで、重いセッションの使い方そのものが上限を減らしていると説明している
- 呼び出しごとの指定の詳細は Claude Code: サブエージェントを実行する労力レベル（effort）を指定する。上限の減り具合を常に見るなら Claude Code のステータスラインに5時間・7日の使用率を出す（rate_limits）
出典
- @bcherny 2026-10-30（
CLAUDE_CODE_SUBAGENT_EFFORT）: @bcherny · 2026-10-30 - @bcherny 2026-10-29（サブエージェントは effort を継承する／重いセッションと
/usage）: @bcherny · 2026-10-29 - 公式ドキュメント（Subagents の
effortフィールド）: code.claude.com - 公式ドキュメント（Costs /
/usage）: code.claude.com - Claude Code CHANGELOG 2.1.316: github.com