環境変数

CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION

1つのセッション内で実行可能なWeb検索呼び出しの総数を制限します。

使い方・用途

  • デフォルト値は200で、正の整数を指定して上限を引き上げることが可能です（上限なしへの無効化は不可）。
  • メインの会話だけでなく、配下のサブエージェントが行う検索もすべて合計数にカウントされます。
  • 上限に達すると検索は実行されず、既に収集した情報で継続するようClaudeに通知されます。
英語原文(公式ドキュメントより)

Cap on the total number of WebSearch calls one session can make (default: 200). When Claude reaches the cap, further WebSearch calls return a notice telling it to continue with the information it already gathered. 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 検索機能の誤作動を気にせず、長時間セッションを安定して運用できます。

関連ドキュメント