Web Search

Claude Web Search（Claude 联网搜索）¶

本页介绍如何在 new API 平台 上为 Anthropic Claude 启用 Web search 工具，让 Claude 能够：

访问实时互联网内容：回答超出模型知识截止日期的问题
返回带引用的答案：在条件允许时附带网页来源链接，便于用户验证

重点说明：
- 注意事项：在使用 Claude 联网搜索时，您使用的令牌（Token）所属分组必须属于 claude code 分组。 - 本站网关 统一采用了兼容 OpenAI 规范的 /v1/chat/completions 接口，通过 web_search_options 字段来触发包括 Claude 在内的各家模型的联网能力。
- Anthropic 官方 则有自己的原生 /v1/messages 接口与专有的 web_search 工具声明方式（例如 web_search_20260209 或 web_search_20250305）。

下文将为你对比展示 本站统一调用方式 和 Anthropic 官方调用方式。

快速开始¶

本站示例¶

在本平台中，只需要向 /v1/chat/completions 端点发送请求，并在请求体中添加 web_search_options 字段即可开启联网功能。

curl "https://api-cs-al.naci-tech.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "claude-opus-4-5-20251101",
    "messages": [
      { 
        "role": "user", 
        "content": "明天北京天气怎么样？" 
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

web_search_options：开启联网搜索的标志。目前支持的配置项（如 search_context_size 控制搜索上下文量等）与平台中 GPT 等其他模型联网机制一致。

Anthropic 官方示例（原生 API）¶

如果你是直连 Anthropic 官方 API，需要在 /v1/messages 接口中，通过 tools 数组声明原生的 web_search 工具。官方工具分基础版和动态过滤版：

curl "https://api.anthropic.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "What is the weather in NYC?"
      }
    ],
    "tools": [
      {
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 5
      }
    ]
  }'

Anthropic 官方高级特性说明¶

虽然在本站你可以非常简单地用 web_search_options 解决问题，但了解官方的原生能力有助于你理解 Claude Web Search 的潜力。

支持的模型¶

根据 Anthropic 官方文档，Web Search 支持以下模型：

claude-opus-4-6 / claude-opus-4-5-20251101 / claude-opus-4-1-20250805 / claude-opus-4-20250514
claude-sonnet-4-6 / claude-sonnet-4-5-20250929 / claude-sonnet-4-20250514
claude-haiku-4-5-20251001

动态过滤与工具版本¶

官方原生接口有两个主要版本：

web_search_20260209：最新版本，支持与 代码执行工具（code execution） 联用，Claude 可以在服务端执行代码对搜索结果进行**动态过滤**，只保留真正相关的内容再放入上下文，从而提升准确性并减少 tokens。
web_search_20250305：基础版本，不带动态过滤能力。

官方启用动态过滤的示例：

curl "https://api.anthropic.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "messages": [
      {
        "role": "user",
        "content": "Search for the current prices of AAPL and GOOGL, then calculate which has a better P/E ratio."
      }
    ],
    "tools": [
      {
        "type": "web_search_20260209",
        "name": "web_search"
      },
      {
        "type": "code_execution",
        "name": "code_execution"
      }
    ]
  }'

官方参数与响应结构¶

如果你使用的是原生接口，web_search 工具还支持以下参数：

max_uses（可选）：限制单次请求中最多可触发的搜索次数；超过后会返回 max_uses_exceeded 错误。
allowed_domains（可选）：只允许从这些域名返回结果；域名不带协议，会自动包含子域名。
blocked_domains（可选）：禁止从这些域名返回结果；不能与 allowed_domains 同时使用。
user_location（可选）：用于本地化搜索结果，包括城市、地区、国家和时区等信息。

其原生的返回结果会以 server_tool_use、web_search_tool_result 内容块的形式出现在响应中，并包含 citations 结构以支持具体的来源展示。而在本平台以 /v1/chat/completions 调用时，网关会在后台进行处理并直接将整理后的结果以纯文本格式拼接，或者通过兼容的 Citation 形式返回。

总结¶

在本站使用：请直接调用 /v1/chat/completions 并传入 web_search_options。这与调用 GPT 和其他开源模型的联网功能完全一致，无需处理复杂的原生 Tool 调用逻辑。
直连官方使用：请按照官方文档调用 /v1/messages 并在 tools 数组内声明 web_search_20250305 或带过滤能力的 web_search_20260209。