Claude Media
Claude Web検索を有効化する方法 — claude.aiとClaude Codeの違い

Claude Web検索を有効化する方法 — claude.aiとClaude Codeの違い

ClaudeのWeb検索は新しい画面では自動、従来の画面は「+」ボタンで有効化します。Team・Enterpriseは管理者の許可が要ります。Claude Codeの扱いも説明します。

Claude.aiのWeb検索を有効化する方法は、画面で決まります。新しい画面ではトグルがなく、必要なときにClaudeが自動で検索します。従来の画面ではチャット欄の「+」ボタンから「Web検索」を選びます。Team・Enterpriseは、管理者がワークスペースで許可するまでオンにできません。

Web検索は、使う面によって仕組みがまったく違います。Claude CodeではWebSearchという独立したツールとして動き、セッションごとの呼び出し上限があります。APIでは検索回数に応じた従量課金です。有効化の手順も上限の外し方も、面が変われば別物になります。

Teamプランなどでclaude.aiの検索が動かないとき、まず確認すること

検索結果が出てこないとき、原因は画面の種類、プラン、組織の設定のどれかであることがほとんどです。順に切り分けます。

手順

claude.aiでWeb検索を使えるようにする流れ

  1. 1

    画面の種類を確認する

    新しいClaudeの画面ではWeb検索のトグルがなく、検索が役立つときにClaudeが自動で検索します。トグルを探して見つからなくても、故障ではありません。

  2. 2

    従来の画面なら「+」ボタンを押す

    チャット欄の左下にある「+」ボタンを押し、ドロップダウンから「Web検索」を選びます。有効になるとその横にチェックマークが付き、もう一度押すと無効になります。

  3. 3

    Team・Enterpriseなら組織側の許可を確認する

    OwnerまたはPrimary Ownerが「Organization settings > Capabilities」でワークスペース全体のWeb検索を有効にするまで、メンバーは切り替えられません。有効にされた後は、メンバー各自がチャットの「+」ボタンから「Web検索」を選んでオンにでき、不要な会話ではオフに戻せます。個人アカウントでは不要な手順です。

  4. 4

    モデルが対応しているか確かめる

    対応モデルは12種類です。

    • 5系: Haiku 5.5・Sonnet 5.5・Opus 5.5・Fable 5.1・Opus 5・Sonnet 5・Fable 5
    • 4系: Opus 4.8・Opus 4.7・Sonnet 4.6・Opus 4.6・Haiku 4.5

従来の画面では、会話ごとに切り替えられるため、最新情報が要らない雑談ではオフにして使用量を節約できます。

検索させたい・させたくないときの指示の出し方

検索するかどうかの判断はClaudeに委ねられています。「近々の流星群は?」「量子コンピューティングの最新動向は?」のように最新情報が要る質問では、自然に検索が走ります。

確実に検索させたいときは、プロンプトに「Web検索して」「Web検索を使って」と書き添えます。逆に検索させたくないときも、その旨を書けば抑制できます。複数の情報源を突き合わせたいなら、「複数のソースで確認して」と頼む方法もあります。

検索が走ると、画面に検索中のインジケーターが出ます。回答には根拠にしたページへの引用・リンク・該当箇所の引用文が付くので、重要な判断に使う情報は引用元を自分で開いて確かめます。

長いURLを貼ると無料枠が減る — Web fetchの仕組み

Web検索がオンの状態でURLを直接貼ると、Web fetchという仕組みがそのページの全文を取得します。検索結果の要約ではなく、記事そのものを読み込む点が通常の検索との違いです。

ここに無料プランのユーザー向けの注意点があります。長い記事のURLを貼って要約させると、全文がまるごとコンテキストウィンドウに読み込まれます。1万語の記事を要約させる操作は、ふつうの検索1回よりはるかに多く使用量を消費します。

無料プランの利用上限は5時間ごとにリセットされ、Web検索とWeb fetchの両方がこの上限にカウントされます。使用量を節約する方法は3つあります。

  • 全文の分析が要らないなら、URLを貼らず要点を質問文で聞く
  • 最新情報が要らない会話では、トグルをオフにする(従来の画面の場合)
  • 最新性が重要な質問にだけ検索を使う

画像・位置情報・つながりにくさ

画像検索結果もWeb検索の一部

Web検索を有効にすると、テキストの回答に加えて画像も検索結果として表示されます。別設定は不要です。レシピの完成形を見たい、商品の写真を探したい、似た品物を並べて見比べたいといった場面で使えます。

画像はBing検索によって選ばれ、それぞれに元ページへのリンクが付きます。検索結果の種類によっては、表やウィジェットのようなインタラクティブなコンテンツがそのまま会話内に表示されることもあります。旅行のしおりのように現地情報の抜けを防ぎたい場面は、Claudeで旅行のしおり(日程表)を作らせる手順が具体例になります。

位置情報の扱いとつながりにくいときの限界

「近くのカフェ」のようにローカルな情報を求める質問では、IPアドレスから推定した位置情報が使われることがあります。GPSの正確な現在地ではない点に注意してください。

また検索の可否は接続状況によって変わり、応答速度はクエリの複雑さで変わります。検索結果のリンク先が開けないこともあります。重要な意思決定に使う情報は、Claudeの回答だけで完結させず引用元のリンクを開いて確認します。引用元を自分で開いて確かめる手順は、賃貸物件の比較やWebライターの構成案作りのように、調べ物の結果をそのまま使う場面ほど効きます。

Claude Codeでは「トグル」ではなく「ツール」として動く

Claude Codeのターミナル内には、claude.aiのようなオン・オフのトグルはありません。代わりにWebSearchという独立したツールがあり、Claudeがタスクの必要に応じて自律的に呼び出します。ユーザー側でできる設定は、権限ルールでこのツールを許可・拒否することです。

WebSearchの権限ルールには指定子(ドメインなど)がありません。allowかdenyにWebSearchと裸で書く形だけです。一時的に外したいだけなら、起動時のオプションで拒否できます。

claude --disallowedTools "WebSearch"

claude --helpには、--disallowedToolsが「拒否するツール名のカンマまたはスペース区切りリスト」と説明されています(v2.1.287で確認)。ツール名のWebSearchは、ツールリファレンスの一覧にある名前です。

WebSearchは何をして、何をしないか

WebSearchは1回の呼び出しで、Anthropicの検索バックエンドに最大8回まで内部的に検索を投げ、結果を絞り込んでからタイトルとURLの一覧を返します。ページの中身までは取得しません。

中身を読む必要があるときは、続けてWebFetchツールが呼ばれます。Claudeはallowed_domainsかblocked_domainsで検索範囲を絞れますが、この2つは同時に使えません。

APIが過負荷のときは、Claude Codeがバックオフ付きで再試行し、それでも失敗すれば失敗の結果を返します。v2.1.212より前は、APIのエラー文が検索結果として扱われてClaudeに渡ることがありました。

WebSearchとWebFetchの違い

2つのツールを、役割と権限ルールの書き方まで並べると次のとおりです。

ツール役割権限ルールの書き方
WebSearch役割検索してタイトルとURLの一覧を返す権限ルールの書き方指定子なし。ツール全体を許可・拒否する
WebFetch役割指定したURLの内容を取得する権限ルールの書き方WebFetch(domain:example.com)のようにドメインを指定できる

「このページには書かれていない」と言われたとき — WebFetchの癖

WebSearchが見つけたURLを読むのはWebFetchです。取得したページはHTMLならMarkdownに変換され、小さく高速なモデルが指示に沿った要約や抜粋だけを抜き出し、Claudeにはその結果が渡ります。生のページ全文がそのまま渡るわけではありません。

そのため、「このページには書かれていない」という回答が返っても、実際にはページの他の部分に情報がある場合があります。抜き出し方の指示が足りなかっただけ、ということです。この場合は、より具体的な指示で取り直させるか、Bashからcurlで生のページを取得するよう頼みます。

WebFetchが受け付けない場面もあります。localhostや、ドットを含まないホスト名(社内の素の名前など)は、リクエストの前に拒否されます。ローカルのサーバーに触るときは、Bash経由のcurlを使うよう案内されます。

そのほかの挙動は次のとおりです。

  • HTTPのURLは自動でHTTPSに変換される
  • 大きなページは、処理前に固定の文字数で切り詰められる
  • 別ホストへのリダイレクトは自動では追わず、元URLとリダイレクト先を示す結果が返る。続けて新しいURLにWebFetchを呼ぶ
  • 同じURLの再取得は既定で15分キャッシュされる。v2.1.233以降は環境変数CLAUDE_CODE_WEBFETCH_CACHE_TTL_MSで保持時間を変えられる
  • 5分以内にダウンロードが終わらないページは期限エラーになる。v2.1.268以降はCLAUDE_CODE_WEBFETCH_DEADLINE_MSで期限を変更でき、0で期限なしにできる

確認プロンプトが出る条件と、WebFetchだけ止める方法

手動確認のモードとacceptEditsモードでは、許可ルールにも拒否ルールにも載っていないドメインへのWebFetchで、取得のたびに確認プロンプトが出ます。事前承認済みの公式ドキュメントのドメイン群は対象外です。autoとbypassPermissionsモードではプロンプトが出ません。ただし、明示的なaskルールに一致するドメインは確認されます。

プロンプトの選択肢は3つあります。1つ目の「Yes」は、その1回だけを許可します。次のWebFetchでは、同じドメインでもまた確認します。2つ目は「Yes, and don't ask again for <ドメイン>」です。これを選ぶと、そのリポジトリの.claude/settings.local.jsonにWebFetch(domain:...)の許可ルールが保存されます。組織がallowManagedPermissionRulesOnlyを設定している場合、この選択肢は表示されません。3つ目の「No, and tell Claude what to do differently」は、取得を断って別の進め方をClaudeに指示します。

事前にプロンプトなしで通したいドメインは、WebFetch(domain:example.com)をallowに追加します。WebFetch(domain:*)で全ドメインを許可する書き方もあります。

検索は使わせたいが、ページの取得は止めたい場合は、v2.1.285以降で環境変数CLAUDE_CODE_DISABLE_WEB_FETCHを1にします。WebSearchは残ります。

Team・Enterpriseのclaude.aiアカウントでサインインし、LLMゲートウェイを経由していない場合は、WebFetchが組織のポリシーにも左右されます。ポリシーはセッション開始時にapi.anthropic.comから取得されます。

WebFetchがセッションから消えているときは、/statusの「Organization policy」の行を見ます。ポリシーが読み込めなかったと表示され、Web fetchが待機中の機能に挙がっていれば、Claude Codeが組織の許可を確認できるまでWebFetchを出さずにいる状態です。ポリシーが読み込まれて許可されれば、再起動なしでツールが戻ります。

1セッション200回のWeb検索上限

Claude Code v2.1.212以降では、1セッションあたり最大200回までWebSearchを呼び出せます。この上限はメインの会話だけでなく、そこから起動したすべてのサブエージェントの検索も合算してカウントされます。並列で調査を走らせるワークフローほど上限に達しやすくなります。

数字

Claude Codeの数字

  • 1セッションのWebSearch上限

    200回

    既定値

  • 1回の呼び出しで走る内部検索

    最大8回

  • WebFetchの再取得キャッシュ

    15分

    既定値

上限に達すると、それ以降の呼び出しはエラーではなく「すでに集めた情報で続行するように」という通知に置き換わります。エラーにしないのは、再試行を促さないためです。この通知はユーザーには見えず、会話ログ上は何もしなかった検索として残ります。Claudeが本当にもっと検索が必要だと判断すれば、上限を上げてほしいと相談してきます。

上限を変更したい場合は、環境変数CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSIONに正の整数を設定します。上げることはできますが、無効化(青天井にすること)はできません。正の整数以外の値は無視されます。

/clearを実行するとカウントはリセットされます。ただし、/clear後もサブエージェントを起動できるワークフローが動き続けている場合は、カウントが引き継がれます。他の環境変数との関係はClaude Code環境変数リファレンスで確認できます。

APIでのWeb検索 — 課金・エラー・制御パラメータ

Anthropic APIから直接使う場合、Web検索はツールの1つとしてtoolsに追加します。Claude CodeのWebSearchが使っているのも、このAnthropic側の検索バックエンドです。

課金と回数の数え方

課金は1,000回の検索につき10ドルで、検索結果が消費したトークン分の通常料金が別にかかります。検索1回のカウントは返ってきた結果の件数に関係なく一律で、検索中にエラーが起きた場合は課金されません。レスポンスのusage.server_tool_use.web_search_requestsに、実際の検索回数が入ります。

検索が失敗しても200が返る

APIでは、レート制限などでWeb検索が失敗しても、HTTPステータスは200です。失敗はweb_search_tool_resultの中身にweb_search_tool_result_errorとして入ります。ステータスコードだけを見ていると失敗を見逃す仕組みです。

エラーコードは次の6種類です。

コード意味
too_many_requests意味レート制限を超えた
invalid_tool_input意味検索クエリのパラメータが不正
max_uses_exceeded意味検索回数の上限(max_uses)を超えた
query_too_long意味クエリが長すぎる
request_too_large意味検索リクエストが大きすぎる(ドメイン指定リストが長いときなど)
unavailable意味内部エラー

結果が0件でも、それはエラーではありません。検索自体は成功して、contentが空のリストで返ります。エラーのときだけ、contentが1つのエラーオブジェクトになります。

組織の管理者がClaude ConsoleでWeb検索を無効にしている場合だけは別の形になります。リクエストが400のinvalid_request_errorで失敗し、Web検索が有効でないという旨のメッセージが返ります。結果の中のエラーコードではなく、リクエスト全体のエラーです。この無効化やドメイン制限の設定は、Messages APIのリクエストにだけ効きます。

制御パラメータ

max_usesは、1リクエストあたりの検索回数の上限です。超えると、結果がmax_uses_exceededのエラーになります。単純な事実確認なら1〜3回、複数の対象を比べる調査なら10回以上かかることがあります。

allowed_domainsとblocked_domainsは、どちらか一方だけを指定します。両方入れると400エラーです。ドメインはexample.comやexample.com/blogのように、スキームなしで書きます。

user_locationでは、都市・地域・国・タイムゾーンのうち1つ以上を指定して、検索結果を地域に寄せられます。国は2文字のISO 3166-1 alpha-2コードで、未対応のコードは400エラーです。

長い検索ターンは、stop_reason: "pause_turn"で一時停止することがあります。続けるときは、一時停止したassistantメッセージをそのまま新しいリクエストに渡します。

動的フィルタリングとバックエンド

web_search_20260209以降のバージョンでは、検索結果をコンテキストウィンドウに入れる前にコード実行でフィルタリングする「動的フィルタリング」が使えます。無関係な結果を読み込む分のトークンを減らせる機能で、Claude 4.6以降のモデルとClaude Mythos Previewで利用できます。

ドキュメントの基本例はweb_search_20250305で、これは動的フィルタリングなしの基本版です。web_search_20260209以降はallowed_callersの既定値がコード実行経由になります。コード実行を呼べないモデルで使うときは、allowed_callers: ["direct"]を指定しないと400エラーです。

検索バックエンドそのものはAnthropic製で固定されており、変更できません。別の検索プロバイダーを使いたい場合は、検索ツールを提供するMCPサーバーを追加する形になります。

どのクラウド経由なら使えるか

クラウド経由での提供状況には差があります。Claude Codeのツールリファレンスと、APIのWeb検索ツールのページでも、書き方が少し違います。

  • Claude Platform on AWSでは使えます。ただしClaude Mythos Previewは例外で、Web検索を使えません
  • Microsoft Foundryでは、Anthropicがホストするデプロイなら全バージョンが使えます。Azureがホストするデプロイは、サーバーサイドツールに対応しておらずClaude CodeのWebSearchは失敗します(API側のページでは、基本版のみ使えるとされています)
  • Google CloudのAgent Platformでは、Claude Codeのツールリファレンスでは「Claude 4以降のモデルで動く」とされています。APIのページでは、動的フィルタリングなしの基本版のみとされています
  • Amazon Bedrockでは、サーバーサイドのWeb検索ツールは提供されていません

社内でどのクラウド経由でClaudeを使っているかによって、使えるかどうかが変わります。導入前に、自分の経路が上のどれにあたるかを確かめます。

3つの面での違い早見表

項目claude.aiClaude CodeAPI
操作方法claude.ai「+」ボタン(新画面では自動)Claude CodeClaudeが自律判断で呼び出しAPIリクエストのtoolsに追加
回数の管理claude.ai利用上限に合算Claude Codeセッション単位の上限(環境変数で変更可)API従量課金、max_usesで自分で設定
検索範囲の指定claude.aiプロンプトで指示Claude Codeプロンプトで指示(Claudeがallowed_domains等で絞る)APIリクエストでallowed_domainsかblocked_domainsを指定

claude.aiとClaude Codeの検索結果は同じになるか

claude.aiの画像表示はBingが担っています。Claude CodeのWebSearchとAPIのWeb検索は、Anthropicの検索バックエンドを使い、プロバイダーを選べません。claude.aiの通常の検索結果を、どの検索エンジンが返しているかは、ここで参照した出典には書かれていません。同じ質問でも面ごとに結果が一致する保証はないため、結果が食い違ったら引用元のページを直接見比べます。

まとめ

Web検索で困ったときは、まず「どの面で、どの画面で、どのプランで使っているか」を切り分けると原因に近づけます。claude.aiで切り替えが見つからなければ新しい画面かどうかを、Claude Codeで検索が止まれば上限と権限ルールを、APIで結果が空なら200の中のエラーコードを見ます。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. support.claude.com/en/articles/10684626-enable-and-use-web-search
  2. code.claude.com/docs/en/tools-reference
  3. code.claude.com/docs/en/env-vars
  4. platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
この記事を共有:XはてブLinkedIn