Claude Code 报 fetch failed / ECONNRESET：终端代理三步修好

原因

Claude Code 运行在终端里，而终端程序默认不会使用浏览器或系统的代理设置。很多人在浏览器里能正常打开 claude.ai，到了终端却一直报连接错误，根源就在这里。Claude Code 支持读取 HTTPS_PROXY、HTTP_PROXY 等标准环境变量，只要把它们指向本地代理客户端的端口，请求就会经过代理。剩下的问题多与节点地区、代理认证和证书有关，可以根据报错信息快速定位。

解决步骤

1. 确认本地代理端口。打开代理客户端的设置页，找到 HTTP 或混合（mixed）端口。7890 是 Clash 系客户端的常见默认端口，Clash Verge Rev 新版本常为 7897，v2rayN 等客户端端口不同，请以实际显示为准。

2. 为终端设置代理环境变量。macOS、Linux 在终端执行：

   export HTTPS_PROXY=http://127.0.0.1:7890
   export HTTP_PROXY=http://127.0.0.1:7890

   Windows PowerShell 执行：

   $env:HTTPS_PROXY="http://127.0.0.1:7890"
   $env:HTTP_PROXY="http://127.0.0.1:7890"

   代理地址建议使用 http:// 形式的 HTTP 代理，SOCKS 代理的支持情况以官方文档为准。

3. 测试能否连通 Anthropic API。在同一个终端窗口执行：

   curl -I https://api.anthropic.com

   只要返回了 HTTP 状态行（状态码是 404 之类也没关系），就说明网络已经打通；如果一直卡住或报超时，问题仍在代理或节点。

4. 检查节点地区。执行 curl https://ipinfo.io/json 查看出口地区，确认不是中国大陆或香港。遇到 403 时优先检查这一步，参考 Claude 地区不可用怎么办。

5. 重新启动 Claude Code。在设置好代理的终端里重新运行 claude。如果仍有问题，执行 claude doctor 检查安装和配置状态。

让代理设置长期生效

export 只对当前终端窗口有效，关掉窗口就失效了。常用的长期配置方式有两种：

• 写入 shell 配置文件：把上面的 export 两行追加到 ~/.zshrc（macOS 默认）或 ~/.bashrc，执行 source ~/.zshrc 后生效。这样所有终端程序都会走代理。

• 只对 Claude Code 生效：在 Claude Code 的用户配置文件 ~/.claude/settings.json 中加入 env 字段：

  {
    "env": {
      "HTTPS_PROXY": "http://127.0.0.1:7890"
    }
  }

  这种方式不影响 git、npm 等其他命令，适合只想让 Claude Code 走代理的情况。

还是不行？

• curl 测试正常，但 Claude Code 仍报错：确认是在同一个终端窗口里运行的
• 设置了 NO_PROXY 变量时，检查它是否意外包含了 anthropic.com
• 登录时浏览器授权成功但终端没反应：浏览器与终端使用的网络环境应一致
• 公司网络或校园网：可能存在额外的代理与证书策略，参考 TLS 握手错误怎么办
• 查看 status.anthropic.com，排除官方服务故障

Claude Code 的完整网络配置（包括 IDE 插件、远程服务器场景）见 Claude Code 网络环境与连接配置。长时间编程任务对线路稳定性要求更高，选线路时可以参考 Claude 稳定机场推荐。