Claude Code、サブエージェントの「考える量」を本体と分けて指定へ

米AnthropicでClaude Codeを手がけるBoris Cherny氏は10月30日、サブエージェント（親から呼び出される別のAI）のeffort（考える量）を本体の会話と分けて決める環境変数「CLAUDE_CODE_SUBAGENT_EFFORT」が入ったと、Xの返信で明かした。本体は深く考えさせたまま、調べ物や検索を任せるサブエージェントだけを軽く回せる。使用量の上限に悩む人には、設定1つで削れる部分が増える。

「本体と同じ」をやめられる

きっかけは利用者の質問だった。Cherny氏の返信の前に、別の利用者が「サブエージェントは、本体のeffortを引き継がずに低いeffortを既定にできないか」と尋ねていた。Cherny氏はこれに「CLAUDE_CODE_SUBAGENT_EFFORTを入れた」と答え、使い方として「CLAUDE_CODE_SUBAGENT_EFFORT=low claude」の1行を示した。自作のエージェントの設定でも指定できるという。

effortは、モデルが1歩ごとにどれだけ考えるかを決める値だ。Claude Codeのモデル設定の説明によると、低いeffortは単純な仕事で速く安く済み、高いeffortは複雑な問題で深く考える。値はlow、medium、high、xhigh、maxの5段階で、使える段階はモデルによって違う。

これまでは、サブエージェントごとに定義のファイルでeffortを書かない限り、本体の会話と同じ値で動いていた。設計の相談のために本体をmaxにすると、ファイルを探すだけのサブエージェントまでmaxで考えていたことになる。新しい環境変数を使えば、この組み合わせを起動の時に切り分けられる。

今の決め方は3つある

サブエージェントのeffortを決める手段は、すでに3つある。サブエージェントの説明によると、1つ目は定義のファイルのeffortの欄で、そのサブエージェントが動く間は本体の値より優先される。2つ目は呼び出しの時の指定で、Claudeにeffortを指定して頼むと、その回だけ欄の値を上書きする。この指定はv2.1.292から使える。

3つ目は環境変数CLAUDE_CODE_EFFORT_LEVELだ。環境変数の一覧によると、この値は起動の時の--effortや会話の中の/effort、設定ファイルの値よりも強い。サブエージェントの欄や呼び出しの指定より優先されるので、これを決めていると本体もサブエージェントも同じ値に固定される。

新しいCLAUDE_CODE_SUBAGENT_EFFORTが、これらとどちらが強いかは、Cherny氏の返信には書かれていない。公式の変更履歴とドキュメントにも、確認日の時点でまだこの変数の記載がない。手元の版で効くかどうかは、変更履歴に載ってから確かめるのが確実だ。

効いたかは/tasksで見る

設定が効いているかは、サブエージェントが動いている間に/tasksを開けば分かる。サブエージェントの説明によると、v2.1.242からは一覧の行に、そのサブエージェントが動くモデルと、決めたeffortが並ぶ。hookやBashのコマンドの中では、環境変数CLAUDE_EFFORTにその時のeffortが入るので、記録に残して確かめることもできる。

すぐに試せる使い分けもある。検索や読み取りだけを任せるサブエージェントは低いeffortにし、コードを書き換えるサブエージェントや設計を考える本体には高いeffortを残す。どのサブエージェントを下げるかを決める時は、定義のファイルの欄で1つずつ書き分け、まとめて下げたい時に環境変数を使う、という分け方になる。

サブエージェントを本体と分けて軽く回せれば、深く考えさせたい本体の質を落とさずに、使用量を減らせる。本体と同じ値で動くという今までの前提を、起動の1行で外せるようになる。

編集部の見方

サブエージェントを何本も並べる使い方が広がるほど、本体と同じeffortで動く分の使用量は膨らむ。今回の変数は、その分を起動の1行で抑える手段になる。まずは調べ物だけをするサブエージェントを低いeffortにして、仕上がりが変わらないかを確かめるところから始めるとよい。変更履歴に載った時に、他の決め方とどちらが強いかもあわせて読んでおきたい。