搞懂 Claude Code 聯網搜索 2 種方式：自帶 WebSearch 和 6 大 MCP 搜索插件對比指南

作者注：詳解 Claude Code 自帶的 WebSearch 和 WebFetch 聯網搜索工具的工作原理與侷限，對比 Brave Search、Tavily、Exa 等 6 大 MCP 搜索插件，幫你判斷是否需要安裝額外的搜索 MCP。

Claude Code 聯網搜索是很多開發者關心的話題——Claude Code 自帶了 WebSearch 和 WebFetch 兩個聯網工具，那還有必要安裝 Brave Search MCP、Tavily MCP 等搜索插件嗎？本文將從技術原理層面詳解這兩種方式的工作機制和適用場景，幫你做出 最適合自己工作流的選擇。

核心價值: 讀完本文，你將清楚瞭解 Claude Code 聯網搜索的自帶工具和 MCP 插件各自的能力邊界，以及在什麼場景下該用哪種方案。

Claude Code 聯網搜索核心要點

Claude Code 聯網搜索的核心結論

先說結論: 對於大多數開發者，Claude Code 自帶的 WebSearch + WebFetch 組合已經能滿足日常聯網搜索需求，無需額外安裝搜索 MCP。但如果你對搜索質量、搜索結果控制或批量網頁抓取有更高要求，安裝一個搜索 MCP（推薦 Brave Search MCP）能帶來顯著提升。

這就像瀏覽器自帶的搜索框對大多數人夠用，但有些人會安裝專門的搜索插件來獲得更好的體驗——關鍵在於你的具體使用場景。

Claude Code 自帶聯網搜索工具詳解

Claude Code 內置了兩個互相配合的聯網工具：WebSearch 負責搜索，WebFetch 負責獲取頁面內容。

WebSearch 工具：搜索引擎

WebSearch 是 Claude Code 的搜索入口，接受查詢關鍵詞並返回相關網頁的標題和鏈接。

WebSearch 的工作原理:

1. Claude Code 收到你的搜索請求
2. 生成一個二級對話（secondary conversation），調用 Anthropic 服務端的 web_search 工具
3. 這個服務端搜索引擎和 Claude.ai 網頁版的搜索功能使用相同的後端
4. 返回結果僅包含標題和 URL，不包含頁面正文內容

WebFetch 工具：頁面內容獲取

WebFetch 接受一個已知的 URL 和一個具體問題，獲取該頁面內容並返回針對問題的摘要答案。

WebFetch 的內部處理流程:

1. URL 校驗: 長度檢查、HTTP 自動升級爲 HTTPS、去除憑證信息
2. 域名安全檢查: 調用 domain_info 端點檢查黑名單，考慮 robots.txt
3. 獲取頁面: 使用 Axios 本地獲取，同域重定向自動跟蹤，跨域重定向需單獨處理
4. 內容轉換: HTML 通過 Turndown 庫轉爲 Markdown，超過 100KB 自動截斷
5. AI 摘要: 由 Claude Haiku 3.5 處理，返回針對你問題的摘要答案

關鍵設計細節:

• 15 分鐘緩存: 同一 URL 在 15 分鐘內重複訪問會使用緩存
• 約 10MB 大小限制: 獲取時的最大頁面大小
• 不返回原始內容: WebFetch 只返回摘要答案，不返回原始 HTML 或 Markdown

🎯 設計目的: Anthropic 故意設計爲不返回原始內容，原因有三：（1）完整頁面通常 10-100KB，直接推入主模型成本高且擠佔代碼上下文；（2）限制提示注入攻擊面；（3）版權合規——引用限制在 125 字符以內。

Claude Code 聯網搜索自帶工具的侷限

Claude Code 聯網搜索 MCP 插件對比

如果自帶工具無法滿足需求，以下是 6 個主流的 MCP 搜索插件：

Brave Search MCP 聯網搜索詳解

Brave Search MCP 是 Anthropic 官方推薦的搜索 MCP，也是使用最廣泛的搜索插件。它被包含在 Anthropic 官方的 modelcontextprotocol/servers 倉庫中。

核心優勢:

• 使用 Brave 獨立搜索索引（非 Google/Bing 轉售），搜索結果更多樣化
• 隱私優先，不追蹤用戶搜索行爲
• 免費層每月 2，000 次查詢，個人開發者足夠使用
• 社區反饋搜索質量優於 Claude Code 內置 WebSearch

Tavily MCP 聯網搜索詳解

Tavily 是一個專爲 AI Agent 設計的搜索引擎，其 MCP 插件特別擅長技術文檔和開發相關查詢。

核心優勢:

• 搜索結果經過 AI 優化，直接提取核心內容
• 支持內容提取（extract）、網站地圖（map）和爬取（crawl）功能
• 對技術文檔查詢的準確度高於通用搜索引擎
• 每月 1，000 次免費查詢

Claude Code 聯網搜索方案對比：自帶 vs MCP

該選自帶工具還是 MCP

典型場景對號入座:

• 日常開發查 API 文檔 → 自帶工具夠用
• 驗證某個錯誤信息的解決方案 → 自帶工具夠用
• 寫技術文章需要深度調研 → 推薦 Tavily MCP
• 需要隱私保護的搜索 → 推薦 Brave Search MCP
• 批量抓取競品網站信息 → 推薦 Firecrawl MCP
• 代碼搜索和學術研究 → 推薦 Exa MCP
• 需要綜合答案而非鏈接 → 推薦 Perplexity MCP

💡 實用建議: Claude Code 支持同時配置多個 MCP 搜索插件，它會根據查詢內容自動選擇最合適的工具。如果你對搜索質量有要求，推薦至少安裝一個 Brave Search MCP 作爲補充。通過 API易 apiyi.com 調用 Claude 模型配合自定義搜索邏輯，也可以實現更靈活的聯網搜索方案。

Claude Code 聯網搜索 MCP 安裝配置

Brave Search MCP 安裝（推薦）

第 1 步: 獲取 API Key

訪問 Brave Search API 頁面: brave.com/search/api ，註冊免費賬號獲取 API Key（免費 2，000 次/月）。

第 2 步: 添加 MCP Server

# 在 Claude Code 終端中運行
claude mcp add brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_BRAVE_API_KEY

# 獲取 Tavily API Key: tavily.com
# 添加 Tavily MCP Server
claude mcp add tavily-search \
  npx -y tavily-mcp@latest \
  --api-key YOUR_TAVILY_API_KEY

# 獲取 Exa API Key: exa.ai
# 添加 Exa MCP Server
claude mcp add exa-search \
  npx -y exa-mcp-server \
  --api-key YOUR_EXA_API_KEY

MCP 配置管理

# 查看已安裝的 MCP Servers
claude mcp list

# 刪除某個 MCP Server
claude mcp remove brave-search

# 項目級配置（團隊共享）
claude mcp add --scope project brave-search \
  npx -y @anthropic/mcp-brave-search

# 用戶級配置（僅個人，存儲在 ~/.claude.json）
claude mcp add --scope local brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key YOUR_KEY

安全建議: 包含 API Key 的 MCP 配置建議使用 --scope local 存儲在個人配置中，避免 API Key 泄露到項目倉庫。團隊共享配置使用 --scope project，將 API Key 通過環境變量注入。

Claude Code 聯網搜索實戰示例

使用自帶 WebSearch 搜索

當你在 Claude Code 中提出需要聯網信息的問題時，它會自動調用 WebSearch：

# 在 Claude Code 中直接提問
> 幫我查一下 React 19 最新的 Server Components 變化

# Claude Code 自動調用 WebSearch 搜索
# 然後調用 WebFetch 獲取相關頁面的摘要內容
# 最後綜合信息回答你的問題

使用 MCP 搜索插件

安裝 Brave Search MCP 後，Claude Code 會自動在可用工具中選擇使用：

# 安裝了 Brave Search MCP 後
> 搜索最新的 Node.js 安全公告

# Claude Code 可能選擇使用 Brave Search MCP
# 返回更豐富的搜索結果
# 包含更多上下文信息

通過 API 實現自定義聯網搜索

如果你需要在自己的項目中實現類似的聯網搜索能力，可以通過 Claude API 結合搜索工具實現：

import openai
import requests

def search_and_analyze（query: str） -> str:
    """結合搜索引擎和 Claude 實現聯網搜索分析"""
    # 第1步: 使用搜索API獲取結果
    # 可使用 Brave Search API、Tavily API 等
    search_results = requests.get（
        "https://api.search.brave.com/res/v1/web/search"，
        headers={"X-Subscription-Token": "YOUR_BRAVE_KEY"}，
        params={"q": query， "count": 5}
    ）.json（）

    # 第2步: 將搜索結果交給 Claude 分析
    client = openai.OpenAI（
        api_key="YOUR_API_KEY"，
        base_url="https://vip.apiyi.com/v1"
    ）

    context = "\n".join（[
        f"- {r['title']}: {r['url']}"
        for r in search_results.get（"web"， {}）.get（"results"， []）
    ]）

    response = client.chat.completions.create（
        model="claude-sonnet-4-6"，
        messages=[
            {"role": "system"， "content": "基於以下搜索結果，回答用戶問題。"}，
            {"role": "user"， "content": f"搜索結果:\n{context}\n\n問題: {query}"}
        ]
    ）
    return response.choices[0].message.content

建議: 通過 API易 apiyi.com 調用 Claude API 配合 Brave Search API 等搜索服務，可以構建更靈活的聯網搜索方案。平臺提供免費測試額度和 OpenAI 兼容接口，適合快速驗證方案。

Claude Code 聯網搜索進階技巧

技巧 1: 使用 domain 過濾優化搜索

Claude Code 的 WebSearch 支持域名過濾，可以精確控制搜索範圍：

# 僅搜索官方文檔
> 在 docs.python.org 搜索 asyncio 的使用方法

# Claude Code 會使用 allowed_domains 參數
# 限制結果僅來自 docs.python.org

技巧 2: 多 MCP 搜索引擎協同

Claude Code 支持同時配置多個搜索 MCP，它會根據查詢類型自動選擇：

• 通用問題 → 自動選擇 Brave Search 或內置 WebSearch
• 技術文檔 → 自動選擇 Tavily（如已安裝）
• 代碼示例 → 自動選擇 Exa（如已安裝）

技巧 3: WebFetch 直接讀取已知 URL

如果你已經知道目標頁面的 URL，可以跳過搜索步驟，直接讓 Claude Code 使用 WebFetch：

# 直接讀取指定URL的內容
> 請閱讀 https://docs.anthropic.com/claude/docs 告訴我最新的API變化

🎯 技術建議: 如果你經常需要在 CI/CD 流程中使用聯網搜索能力，建議通過 API易 apiyi.com 平臺調用 Claude API 配合 Brave 或 Tavily 的搜索 API，構建自動化的信息獲取流水線。平臺支持 OpenAI 兼容接口，便於與現有工具鏈集成。

常見問題

總結

Claude Code 聯網搜索的 3 個核心要點：

1. 自帶工具夠用: Claude Code 內置的 WebSearch + WebFetch 組合能滿足 80% 的聯網搜索需求，WebSearch 負責搜索返回鏈接，WebFetch 負責獲取頁面摘要答案，兩者配合形成完整的搜索鏈路
2. MCP 搜索是錦上添花: Brave Search MCP（官方推薦，免費 2，000 次/月）和 Tavily MCP（擅長技術文檔）是最值得安裝的兩個搜索插件，能在搜索質量和結果豐富度上帶來顯著提升
3. 按需選擇即可: 日常開發查文檔→自帶工具；深度研究和批量抓取→安裝 MCP；需要在自動化流程中集成搜索→通過 API易 apiyi.com 調用 Claude API 配合搜索服務 API

Claude Code 聯網搜索的設計哲學是「保持主 agent 輕量」，自帶工具在安全性、版權合規和性能之間取得了良好平衡。根據你的實際需求選擇是否安裝額外的搜索 MCP，避免過度配置。

📚 參考資料

1. Claude Code Web Tools 深度解析: WebSearch 和 WebFetch 的內部實現原理

   • 鏈接: mikhail.io/2025/10/claude-code-web-tools/
   • 說明: 逆向工程分析 Claude Code 聯網工具的技術實現

2. Web Search Tool 官方文檔: Claude API 搜索工具說明

   • 鏈接: platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
   • 說明: Anthropic 官方的 WebSearch 工具 API 文檔

3. Web Fetch Tool 官方文檔: Claude API 頁面獲取工具說明

   • 鏈接: platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool
   • 說明: Anthropic 官方的 WebFetch 工具 API 文檔

4. MCP 搜索插件集成指南: 多種 MCP 搜索服務對比和安裝教程

   • 鏈接: intuitionlabs.ai/articles/mcp-servers-claude-code-internet-search
   • 說明: 8 種 MCP 搜索插件的詳細對比和使用建議

5. Brave Search MCP: Anthropic 官方推薦的搜索 MCP

   • 鏈接: brave.com/search/api/guides/use-with-claude-desktop-with-mcp/
   • 說明: Brave Search MCP 安裝和使用指南

作者: APIYI 技術團隊
技術交流: 歡迎在評論區分享你的 Claude Code 聯網搜索配置經驗，更多 AI 開發資料可訪問 API易 docs.apiyi.com 文檔中心