CC-017:WebFetch 报错但网页能打开
问题现象
浏览器能打开目标网页,Claude Code 的 WebFetch 却报错或无法获取内容。
根因分析
浏览器和工具可能走不同网络路径;工具权限、域名检查、目标站登录要求或反爬限制也可能导致失败。不能仅凭此现象认定一定是预检问题。
修复步骤
- 记录 WebFetch 返回的完整错误和实际失败域名。
- 使用
/permissions检查该域名的 WebFetch 规则。 - 比较客户端进程与浏览器的网络设置,分别确认目标站和相关检查服务可达。
- 若目标站要求登录或不支持工具抓取,改用用户提供的页面内容或该站允许的接口。
- 如曾添加
skipWebFetchPreflight,先核对当前版本是否支持,避免将旧版字段当作通用设置。
预防措施
一次只修改一项工具或网络配置。按失败地址排查,不为单个网页问题批量修改模型连接设置。