WebSearch returns 0 results：Claude Code

Quick fix

暂时禁用内置 WebSearch，改用 Brave Search MCP 查找页面后再用 WebFetch 读取，以避开空结果和卡顿。

Symptom

报错原文复制

Web search results for query: "<query>"


REMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks.

Cause

在报告的 Claude Code 2.1.209、CC Switch 3.17.0、Codex OAuth 代理环境中，内置 `WebSearch` 返回空结果，JSONL 中显示 `"results": []` 和 `"searchCount": 0`；其中一次调用耗时 264.42 秒，随后顶层请求还持续无输出直至被手动中断。相同会话中的 Brave Search MCP 可立即返回结果，说明一般网络访问可用。

原帖无法确认问题位于 Claude Code 的 WebSearch 封装，还是 CC Switch 的 Claude-to-Codex 请求转换；也未确认内置 WebSearch 是否受 Codex OAuth 提供方正式支持。关闭状态不代表已有修复。报告者验证过的临时缓解措施是避开内置 WebSearch，改走 Brave Search MCP 与 WebFetch。

Fix

1. 1

   在 `~/.claude/settings.json` 的现有 deny 列表中加入 `WebSearch`，保留已有条目。

   ~/.claude/settings.json

   {
     "permissions": {
       "deny": [
         "WebSearch"
       ]
     }
   }

2. 2

   在 `~/.claude/CLAUDE.md` 中指示 Claude Code 不使用内置 `WebSearch`，网页研究先用 Brave Search MCP 定位 URL，再用 `WebFetch` 读取具体页面。

   ~/.claude/CLAUDE.md

   Disable and do not use the built-in `WebSearch` tool
   For general web research, first use Brave Search MCP to locate relevant pages, then use `WebFetch` to read specific URLs

3. 3

   启动新的 Claude Code 会话，使全局设置和 `CLAUDE.md` 更完整地重新加载。

Affected Versions

ToolClaude Code

Version2.1.209（报告的受影响版本）

PlatformsmacOS

Source Issues

本页汇总自 1 个真实 issue

• #5363Claude Code built-in WebSearch returns 0 results and can stall via Codex OAuth proxy

FAQ

Claude Code 的内置 WebSearch 通过 Codex OAuth provider 是否获得官方支持？

原帖提出了该问题，但未提供确认答复。

转换器会保留并执行强制的服务端 `web_search` 调用，还是只会返回模型的工具调用意图并产生空结果？

原帖无法确认，未提供已验证的结论。

能否为转换后的内置 WebSearch 请求及上游响应或错误增加诊断日志，并设置有界超时？

这是原帖向维护者提出的改进请求，未记录已实现情况。

相关问题

Invalid schema for function — Codex将 CC Switch 升级至包含 v3.18.0 修复的版本可解决 `parameters.type:null` 变体；其他 `null` schema 变体仍需跟踪原帖。13 issues merged[DISCUSS] 支持 pi coding agent这是功能请求，维护者已将其合并至统一追踪 issue #1855，原帖未提供可验证的解法。1 issues mergedexceeded the 64000/128000 output token移除或改写触发拒绝的 MCP 工具 JSON Schema `pattern`，以避免 Codex OAuth 将零用量拒绝误显示为输出 token 超限。1 issues merged