Claude Code Web Fetch错误修复方法

作者:技术拾光时间:2026-07-17 09:01:05浏览:592

ClaudeCodeWebFetch问题源于客户端域名安全预检机制故障,导致误判拦截。解决方法为修改配置文件settings.json,添加"skipWebFetchPreflight":true,重启后生效。此操作适用于官方客户端且无企业防火墙场景,但需注意仅在信任网络中使用,后续可恢复默认安全机制。

claude code 出现Claude Code Web Fetch问题

问题根源在于Claude Code客户端内置的域名安全预检机制出现故障,而非目标网站本身。该错误提示本质上是一次“误判”——客户端在访问网页前,先自检安全规则,结果将自己拦截。

Claude Code Web Fetch错误修复方法

解决办法一:跳过域名安全预检(90% 通用场景)

1.1 适用场景

  • 使用官方Claude Code渠道(claude.ai官网、官方桌面端)
  • 个人网络环境,无企业防火墙限制
  • 所有域名均返回“Unable to verify”类错误
  • 服务端域名验证服务暂时不可用

1.2 详细操作步骤

  1. 找到Claude配置文件

    • Windows系统:打开资源管理器,进入路径 C:Users你的用户名.claudesettings.json
    • macOS系统:按下 Command+Shift+G,输入 ~/.claude 回车,找到 settings.json 文件
    • Linux系统:直接访问路径 ~/.claude/settings.json
  2. 修改配置文件用任意文本编辑器打开 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"
      }
    }
  3. 重启Claude Code生效完全关闭Claude Code应用(包括后台进程),重新启动后WebFetch功能即可正常使用。

1.3 验证方法

在Claude Code中输入 Fetch https://www.baidu.com,若能正常返回百度首页的文本内容,说明配置成功。

1.4 注意事项

  • 跳过预检请求意味着Claude可以访问任何域名,包括潜在恶意网站,因此请仅在信任的网络环境中使用
  • 该配置仅对本地Claude Code生效,不影响云端其他功能
  • 若后续官方修复域名验证服务问题,可将该配置改为 false,恢复默认安全机制

总结