【已解决】Claude Code WebFetch 调用失败问题 - skipWebFetchPreflight 配置

2026-04-11 10:571阅读0评论SEO教程
  • 内容介绍
  • 文章标签
  • 相关推荐
问题描述:

问题背景

最近在使用 Claude Code 的 WebFetch 功能时,一直遇到这个错误:

Unable to verify if domain xxx is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.

不管是抓 Wikipedia、Hacker News 还是普通网站都不行,看到 佬友的帖子 也遇到了同样的问题,即使开了代理、配置了 Clash TUN 模式都不行。

原因分析

翻了下 GitHub,在 Issue #6388 找到了根本原因:

WebFetch 在抓取目标网站之前,会先调用 https://claude.ai/api/web/domain_info?domain= 做安全验证。如果你的网络环境下 claude.ai 被墙或者被企业防火墙拦了,这个预检查就会失败,即使目标网站本身是可以访问的。

所以就算开了全局代理,如果代理没有正确处理 claude.ai 的请求,WebFetch 还是会报错。

解决方案

Claude Code 其实提供了一个配置项 skipWebFetchPreflight 可以跳过预检查,但是官方文档里没写(坑)。

配置步骤

  1. 编辑 settings.json

    vim ~/.claude/settings.json

    添加这一行:

    { "skipWebFetchPreflight": true }

  2. 重启 Claude Code生效

验证

重启后随便让 Claude 抓个网页测试:

抓取 https://news.ycombinator.com 的内容

能正常返回了

参考

  • GitHub Issue: [BUG] WebFetch "Unable to verify domain is safe" error · Issue #6388 · anthropics/claude-code · GitHub

希望能帮到遇到同样问题的佬友们

网友解答:
--【壹】--:

赞,硬核知识点


--【贰】--: rocsy:

抓取 https://news.ycombinator.com 的内容

验证没有问题, 今天就遇到了fetch报错问题, 我还以为是公益站的问题


--【叁】--:

感谢分享


--【肆】--:

好奇WebSearch和WebFetch是什么原理,是完全本地实现的吗?还是走A​的服务器


--【伍】--:

感谢分享,爱你


--【陆】--:

感谢分享


--【柒】--:

感谢分享


--【捌】--:

顶啊啊啊


--【玖】--: rocsy:

skipWebFetchPreflight

查一下小米股价

Web Search(“小米股价 2025”)
⎿ Did 0 searches in 285ms

抱歉,目前 WebSearch 工具无法使用。

我加了 “skipWebFetchPreflight”: true 之后,报这个问题,是咋回事啊


--【拾】--:

都怪a除多此一举,那个验证很容易因为节点ip问题被reject,不如直接skip算了


--【拾壹】--:

感谢分享


--【拾贰】--:

好像是haiku模型无法使用搜索工具


--【拾叁】--: rocsy:

"skipWebFetchPreflight": true

验证有牛,NBNB


--【拾肆】--:

感谢分享,今天刚好遇到了,查个cloudflare的api文档一直报错


--【拾伍】--:

image1770×310 47.1 KB
实测有用


--【拾陆】--:

感谢大佬


--【拾柒】--:

本地实现的。默认设置下,webfetch执行前会额外让a​服务器判断下url合法性 是否允许爬虫程序这些


--【拾捌】--:

直接给他跳过验证,不需要a除帮我验证


--【拾玖】--:

666666 好使

问题描述:

问题背景

最近在使用 Claude Code 的 WebFetch 功能时,一直遇到这个错误:

Unable to verify if domain xxx is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.

不管是抓 Wikipedia、Hacker News 还是普通网站都不行,看到 佬友的帖子 也遇到了同样的问题,即使开了代理、配置了 Clash TUN 模式都不行。

原因分析

翻了下 GitHub,在 Issue #6388 找到了根本原因:

WebFetch 在抓取目标网站之前,会先调用 https://claude.ai/api/web/domain_info?domain= 做安全验证。如果你的网络环境下 claude.ai 被墙或者被企业防火墙拦了,这个预检查就会失败,即使目标网站本身是可以访问的。

所以就算开了全局代理,如果代理没有正确处理 claude.ai 的请求,WebFetch 还是会报错。

解决方案

Claude Code 其实提供了一个配置项 skipWebFetchPreflight 可以跳过预检查,但是官方文档里没写(坑)。

配置步骤

  1. 编辑 settings.json

    vim ~/.claude/settings.json

    添加这一行:

    { "skipWebFetchPreflight": true }

  2. 重启 Claude Code生效

验证

重启后随便让 Claude 抓个网页测试:

抓取 https://news.ycombinator.com 的内容

能正常返回了

参考

  • GitHub Issue: [BUG] WebFetch "Unable to verify domain is safe" error · Issue #6388 · anthropics/claude-code · GitHub

希望能帮到遇到同样问题的佬友们

网友解答:
--【壹】--:

赞,硬核知识点


--【贰】--: rocsy:

抓取 https://news.ycombinator.com 的内容

验证没有问题, 今天就遇到了fetch报错问题, 我还以为是公益站的问题


--【叁】--:

感谢分享


--【肆】--:

好奇WebSearch和WebFetch是什么原理,是完全本地实现的吗?还是走A​的服务器


--【伍】--:

感谢分享,爱你


--【陆】--:

感谢分享


--【柒】--:

感谢分享


--【捌】--:

顶啊啊啊


--【玖】--: rocsy:

skipWebFetchPreflight

查一下小米股价

Web Search(“小米股价 2025”)
⎿ Did 0 searches in 285ms

抱歉,目前 WebSearch 工具无法使用。

我加了 “skipWebFetchPreflight”: true 之后,报这个问题,是咋回事啊


--【拾】--:

都怪a除多此一举,那个验证很容易因为节点ip问题被reject,不如直接skip算了


--【拾壹】--:

感谢分享


--【拾贰】--:

好像是haiku模型无法使用搜索工具


--【拾叁】--: rocsy:

"skipWebFetchPreflight": true

验证有牛,NBNB


--【拾肆】--:

感谢分享,今天刚好遇到了,查个cloudflare的api文档一直报错


--【拾伍】--:

image1770×310 47.1 KB
实测有用


--【拾陆】--:

感谢大佬


--【拾柒】--:

本地实现的。默认设置下,webfetch执行前会额外让a​服务器判断下url合法性 是否允许爬虫程序这些


--【拾捌】--:

直接给他跳过验证,不需要a除帮我验证


--【拾玖】--:

666666 好使