Claude Code Web Fetch问题解析:域名安全预检机制故障
导致Claude Code Web Fetch报错的根源并非目标网站本身,而是客户端内置的域名安全预检机制出现了故障。该错误提示本质上是一次“误判”:客户端在发起网页请求前,先行自检安全规则,结果将自己拦截在外。
解决办法一:跳过域名安全预检(适用于90%通用场景)
1.1 适用场景
- 使用官方Claude Code渠道(如claude.ai官网、官方桌面端)
- 个人网络环境,无企业防火墙限制
- 所有域名均返回“Unable to verify”类错误
- 服务端域名验证服务暂时不可用
1.2 详细操作步骤
定位Claude配置文件
- Windows系统:打开资源管理器,进入路径
C:Users你的用户名.claudesettings.json - macOS系统:按下
Command+Shift+G,输入~/.claude 回车,找到settings.json文件 - Linux系统:直接访问路径
~/.claude/settings.json
- Windows系统:打开资源管理器,进入路径
编辑配置文件用任意文本编辑器打开
settings.json,在JSON根对象中添加以下配置行(注意保留文件中已有的其他配置):
json{ "skipWebFetchPreflight": true, // 此处保留你原有的其他配置项 "env": { "ANTHROPIC_AUTH_TOKEN": "your-token", "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.5-plus", "ANTHROPIC_SMALL_FAST_MODEL": "glm-4.7" } }重启Claude Code使配置生效完全关闭Claude Code应用(包括后台进程),重新启动后WebFetch功能即可正常使用。
1.3 验证方法
在Claude Code中输入 Fetch https://www.baidu.com,若能正常返回百度首页的文本内容,则说明配置成功。
1.4 注意事项
- 跳过预检请求意味着Claude可以访问任何域名,包括潜在恶意网站,因此请仅在受信任的网络环境中使用
- 该配置仅对本地Claude Code生效,不会影响云端其他功能
- 若后续官方修复了域名验证服务问题,可将该配置改为
false,恢复默认安全机制

