Web search tool（ウェブ検索ツール）

Claude は知識のカットオフ以降の最新情報を使って質問に回答できます。いつ検索するかはプロンプトをもとに Claude が判断し、検索の実行と結果の提供は API が行います。回答には、検索結果から引いた情報源の引用が含まれます。

Web search tool は、Claude が知識のカットオフを超えた最新情報で回答するためのツールです。Claude はプロンプトをもとに検索するかどうかを判断し、API が検索を実行して結果を Claude に渡します。この流れは 1 回のリクエストの中で複数回繰り返される場合があります。

検索を始めるかどうかは、system prompt で調整できます。検索を積極的に行うよう促すことも、直接の回答を優先させることもできます。

web_search_20260209 以降のバージョンでは、検索結果が context window に入る前に、Claude がコードを書いて実行し、関連する情報だけを残す dynamic filtering（動的フィルタリング）を使えます。dynamic filtering の実行時には必要なコード実行環境を API が自動で用意するため、code execution tool を tools に自分で追加する必要はありません。dynamic filtering を使わずにウェブ検索を直接呼び出す場合は、allowed_callers: ["direct"] を設定します。

web_search_20260318 は、エージェント型ワークフロー向けに response inclusion の制御を追加したバージョンです。"response_inclusion": "excluded" を設定すると、完了したコード実行の呼び出しで消費された入れ子の server_tool_use と結果ブロックの組を、レスポンスから取り除きます。検索の生データを必要としないエージェント型ワークフローに使えます。

• 検索結果を含む会話を続けるときは、受け取った assistant の content blocks を、各結果の encrypted_content を含めてそのまま送り返します。
• API が stop_reason: "pause_turn" を返したときは、一時停止した assistant のメッセージを変更せずに新しいリクエストで送り返して再開します。
• レート制限への到達などでツールがエラーになった場合も、Claude API は 200 のレスポンスを返し、エラーはレスポンス本文の中で表されます。
• ストリーミングを有効にすると、検索のイベントをストリームの一部として受け取ります。検索の実行中は一時的に間が空きます。
• Web search tool は Message Batches API のリクエストにも含められます。

ウェブ検索は、管理者が Claude Console で無効にしていない限り組織で有効です。管理者は Claude Console で、検索対象のドメインを制限することもできます。

リクエスト側では allowed_domains と blocked_domains のどちらか一方だけを指定します。両方を含めると API は 400 エラーを返します。

Claude Managed Agents では、ウェブ検索は agent toolset の一部で、toolset を追加すると既定でオンになります。ドメインのリストと user_location は toolset の web_search の項目に設定し、max_uses、citations、cache_control は使えません。

Claude Managed Agents のセッションは、Claude Console の Capabilities（機能）ページにある組織のウェブ検索設定に従います。エージェントが受け取るのは、組織のドメイン制限と、エージェントの web_search ツールにある allowed_domains または blocked_domains のリストの両方が許可した検索結果だけです。

web_search_20260318 の利用にベータヘッダーは不要です。

1. リクエストの tools に web_search ツールを追加します。
2. max_uses、ドメインのリスト、user_location などの設定は、追加した web_search ツールに記述します。