# Claude 联网搜索：web_search 工具与 Anthropic 供应商

Source: https://ofox.io/zh/docs/develop/models/claude/web-search

本页说明如何让 Claude 通过 `web_search` 工具联网搜索。模型 ID、接口地址与供应商说明见 [Claude 系列概览](https://ofox.io/zh/docs/develop/models/claude)。

**要点**:联网搜索需指定 Anthropic 供应商，仅限 Fable 5、Opus 4.8、Opus 4.7、Sonnet 5，且仅支持 Anthropic 原生接口。

在 `tools` 中加入官方的 `web_search` 服务端工具，模型会自行发起搜索并在回答中引用来源：

**Python**

```python filename="claude_web_search.py"
import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.ofox.io/anthropic",
    api_key=os.environ["OFOX_API_KEY"],
    default_headers={"X-OfoxAI-Provider-Type": "anthropic"},
)

message = client.messages.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=1500,
    tools=[{"type": "web_search_20250305", "name": "web_search", "max_uses": 3}],
    messages=[{"role": "user", "content": "Python 最新的稳定版本是多少？"}],
)
print("".join(b.text for b in message.content if b.type == "text"))
print("搜索次数:", message.usage.server_tool_use.web_search_requests)
```

**cURL**

```bash filename="Terminal"
curl https://api.ofox.io/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "X-OfoxAI-Provider-Type: anthropic" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 1500,
    "tools": [{"type": "web_search_20250305", "name": "web_search", "max_uses": 3}],
    "messages": [{"role": "user", "content": "Python 最新的稳定版本是多少？"}]
  }'
```

- 响应的 `content` 中依次出现 `server_tool_use`（搜索关键词）、`web_search_tool_result`（搜索结果）与 `text`（回答）块。
- `usage.server_tool_use.web_search_requests` 为实际搜索次数，搜索按次计费，单价见[模型页](https://ofox.io/zh/models/anthropic/claude-sonnet-5)。
- `max_uses` 限制单次请求的最多搜索次数。

其他报错见[常见报错](https://ofox.io/zh/docs/develop/models/claude#errors)。