環境変数

CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION

WebSearch 呼び出しの上限を設定する(既定値: 200)。Claude が上限に達すると、それ以降の WebSearch 呼び出しは、すでに収集した情報で続行し、その旨を回答で述べるよう指示する通知を返す。上限はない正の整数を受け付ける。それ以外の値は無視されて既定値が適用されるため、上限を引き上げることはできるが無効化することはできない。Claude Code v2.1.212 以降が必要である。

使い方・用途

  • リサーチの並列展開などで subagent が大量の WebSearch を実行しても、セッション全体で消費できる検索回数の上限を変えて自動停止に付きにくくしたい場合
  • WebSearch の暴走ループが発生した際に、許容できる検索回数の上限値を調整して対処したい場合
  • 既定値のままだと検索が途中で打ち切られるワークフローを運用しており、上限を正の整数に引き上げたい場合
英語原文(公式ドキュメントより)

Cap on WebSearch calls (default: 200). When Claude reaches the cap, further WebSearch calls return a notice telling it to continue with the information it already gathered and say so in its answer. Accepts a positive whole number with no upper bound. Anything else is ignored and the default applies, so the cap can be raised but not turned off. Requires Claude Code v2.1.212 or later

関連ドキュメント

関連する変更履歴

v2.1.212(1件)

Added
WebSearch ツールの呼び出しにセッションごとの上限(デフォルト200回)を設け、意図しないループ動作を防止しました。
英語原文を表示
Added a session-wide limit on WebSearch tool calls (default 200, tunable via CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION) to stop runaway search loops

変更後

Web 検索機能の誤作動を気にせず、長時間セッションを安定して運用できます。

関連ドキュメント