Claude Code
fetch failed 网络请求失败
报错原文
fetch failed
出现场景
在登录环节(OAuth 浏览器授权回调)或任意对话请求时报错, 通常几秒内就失败, 表现为连接超时或直接被重置。
可能原因(按概率)
- 本地代理/防火墙拦截了到 api.anthropic.com 或 console.anthropic.com 的请求
- 代理只对浏览器生效, 终端环境变量未继承代理配置
- 公司/校园网出口对 Anthropic 域名做了 QoS 限速或丢包
修复步骤(从最简单的开始)
- 运行 claude /doctor 看具体是哪一跳失败
- 确认代理监听端口: netstat -ano | grep 7890 (Git Bash 下用 findstr 也可: netstat -ano | findstr 7890)
- 手动导出代理变量后在同一终端里跑: export HTTPS_PROXY=http://127.0.0.1:7890; claude
- 用 curl 单独验证网络层: curl -x $HTTPS_PROXY -v https://api.anthropic.com/v1/messages , 排除是不是 Claude Code 自身 Node 客户端的问题而非网络问题
- 仍失败可执行 claude /feedback 生成诊断包提交给官方, 或直接切换到国内可直连的中转网关方式跑
大陆网络环境注记
该报错是官方文档明确列出的网络类错误, 大陆环境下 90% 是代理未生效或未被终端进程继承, 少数是本身命中了地域封锁(见 403 条目); 用中转网关可以绕开这层排查成本。
反复被网络 / 支付 / 限流问题耗时间?国内直连的 API 网关一个 key 通多家模型,绕开这一整类报错。
了解 newapi 网关claude-code网络登录OAuth