Claude Code WebFetch：Unable to verify domain 快速解决

许多用户在使用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." 我方测试了今日头条以及一些常规站点，均未能成功。即使启用了代理或TUN模式，问题也未必能得到解决。

一、根本原因分析

经过深入研究GitHub上的相关讨论（Issue #6388），可以明确地指出问题并非出自目标网站本身，而是由于"预检查"过程失败所致。具体来说，在正式开始网页抓取之前，Claude Code会首先向以下安全校验接口发起请求：

复制代码

https://claude.ai/api/web/domain_info?domain=xxx

如果用户的网络环境对claude.ai进行了拦截（例如因防火墙设置、企业级安全策略或代理配置不当等），则该预检查步骤将无法顺利完成，从而导致WebFetch功能直接报错并中断操作。因此，即便目标网站可访问，并不意味着WebFetch功能必然可用，因为其依赖于对claude.ai的安全性验证。

二、解决方案建议

为了解决上述问题，Claude Code提供了一个配置选项skipWebFetchPreflight，允许用户绕过这一前置验证流程。尽管当前官方文档中对此项配置介绍不够详尽，但根据实际测试表明，该方法是可行且有效的。通过启用此选项，可以避免因网络限制而导致的预检查失败问题，进而确保WebFetch功能的正常使用。

三、解决方案

1）编辑配置文件

mac/linux

复制代码

vim ~/.claude/settings.json

win

复制代码

C:\Users\你的用户名\.claude\settings.json

CMD 写法 ：%USERPROFILE%\.claude\settings.json
PowerShell 写法 ：$HOME\.claude\settings.json
Git Bash 写法 ：~/.claude/settings.json（等价于 /c/Users/你的用户名/.claude/settings.json）

2）加入配置

复制代码

{
  "skipWebFetchPreflight": true
}

如果你原本已有其他配置，只需要在 JSON 中补上这一项即可。

3）重启 Claude Code

重启后配置生效。

四、验证是否成功

重启后，随便测一个站点

若能够成功加载并显示网页内容，则表明问题已得到解决。