Client Network Socket Disconnected 报错深度排查指引

为什么会频繁遭遇网络超时与 socket disconnected 异常？

由于中国大陆的网络边界路由阻断以及高频高吞吐的 API 并发传输特性，Claude Code 在上传和比对本地大规模代码树（Git context）时，极易因网络链路波动触发 Node.js 底层的 Client network socket disconnected、ETIMEDOUT 或 ECONNRESET 错误。

在一般网页版对话中，由于流量较小很难察觉；但 Claude Code 的终端代理高频调用需要极高且稳定的带宽支持，任何轻微的丢包都可能导致会话中断。

一键极速调优：全局环境变量与终端代理配置

要破解此难题，最稳健的方法是直接在您的终端 Shell（如 Zsh 或 Powershell）中配置 HTTP/HTTPS 代理。

macOS / Linux Zsh 配置：

# 编辑 ~/.zshrc 并追加以下内容
export http_proxy="http://127.0.0.1:YOUR_PORT"
export https_proxy="http://127.0.0.1:YOUR_PORT"
# 如果代理工具支持 socks5 协议
export ALL_PROXY="socks5://127.0.0.1:YOUR_PORT"

Windows Powershell 配置：

$env:http_proxy="http://127.0.0.1:YOUR_PORT"
$env:https_proxy="http://127.0.0.1:YOUR_PORT"

配置完成后，可以使用 curl -I https://api.anthropic.com 验证代理连通性，再启动 claude 即可畅快运行。