Claude Code 代理后一直 Reconnecting 或 ECONNRESET 怎么办？

1. Claude Code 网络问题先分三层

这三条链路不能使用同一个结论。API 请求需要代理时，本地 ws://127.0.0.1:PORT 仍应绕过代理；预检失败也不一定等于实际 API 不可达。

2. Reconnecting、ECONNRESET 与 ERR_SOCKET_CLOSED 的区别

• Reconnecting 后自动恢复：流式连接中途断开，客户端重试成功。记录频率和发生时间，偶发不等于配置错误。
• ECONNRESET 持续出现：连接被对端或中间网络重置。代理、TLS 检查、网络波动和服务端都可能触发。
• ETIMEDOUT / fetch failed：目标地址或代理在超时内没有建立连接，先检查 Base URL、DNS 和代理端口。
• Checking connectivity → ERR_SOCKET_CLOSED：可能是启动预检与企业 TLS 代理不兼容，需与实际 API 请求结果对照。
• IDE 连接失败：优先检查 loopback 是否被 HTTP_PROXY/HTTPS_PROXY 接管。

3. HTTP_PROXY、HTTPS_PROXY 与 NO_PROXY 怎么配

如果当前网络需要本地代理访问 API，可使用实际 HTTP 或 mixed 端口。不要照抄示例端口，也不要在文章、日志或工单中暴露带用户名密码的企业代理 URL。

export HTTP_PROXY="http://127.0.0.1:PORT"
export HTTPS_PROXY="http://127.0.0.1:PORT"
export NO_PROXY="localhost,127.0.0.1,::1"
export no_proxy="localhost,127.0.0.1,::1"

$env:HTTP_PROXY = "http://127.0.0.1:PORT"
$env:HTTPS_PROXY = "http://127.0.0.1:PORT"
$env:NO_PROXY = "localhost,127.0.0.1,::1"
$env:no_proxy = "localhost,127.0.0.1,::1"

1. 确认代理软件实际监听协议和端口。
2. 检查是否同时存在大小写两套变量，避免旧值覆盖。
3. 保证 NO_PROXY 与 no_proxy 都包含 loopback。
4. 完全退出 Claude Code 和编辑器，再启动新会话。
5. 先验证短文本 API 请求，再执行 /ide 或工具调用。

NODE_USE_ENV_PROXY=1会启用 Node 的原生环境代理行为，只应在确认当前 Node/CLI 版本和部署方式需要时设置。不要为了“试试看”同时开启多个代理机制。

4. 为什么大写 NO_PROXY 正确，IDE 仍连接失败

Claude Code issue #79545记录了一种大小写优先级问题：在 NODE_USE_ENV_PROXY=1 下，如果小写 no_proxy 存在但没有 loopback，它可能优先于正确的大写 NO_PROXY。结果是本地 IDE WebSocket 被送入 HTTP/HTTPS 代理。

# macOS / Linux
env | grep -i proxy

# PowerShell
Get-ChildItem Env: | Where-Object Name -Match 'proxy'

修复重点不是删除所有代理，而是让本机地址始终绕过代理。保存当前值后，把两种大小写都统一为包含 localhost,127.0.0.1,::1 的列表。重启后再次连接 IDE，并检查企业代理日志中是否还出现本机 loopback 端口。

5. 企业 HTTPS 代理下卡在 Checking connectivity

公开 issue #81611记录过 Claude Code 2.1.220 的启动预检在企业 HTTPS 代理下返回 ERR_SOCKET_CLOSED，但同一代理上的 curl 与实际 SDK 请求可达。这个案例说明：预检使用的网络客户端与模型请求路径可能不同。

1. 使用同一代理对当前 API/Base URL 做最小可达性测试。
2. 用无效测试密钥得到明确 401，也能证明网络已经到达 API；不要使用生产密钥做公开诊断。
3. 记录 Claude Code 版本，优先升级到当前稳定版本后复测。
4. 如果问题明确由版本回归引起，可在隔离测试环境临时固定已知可用版本，同时保留升级计划。
5. 不要关闭 TLS 验证来绕过企业证书问题；应安装组织提供的可信 CA，并按官方方式配置证书链。

6. Claude Code 中转 API 的分层验证

Claude Code 中转配置见Claude Code API 配置教程。提交客服时提供脱敏时间、模型、错误码、请求 ID、版本和复现步骤，不要发送完整密钥。

7. 修改后的验证与回滚

1. 备份修改前的代理变量和值，代理密码必须脱敏。
2. 新开终端，发送一个短文本请求。
3. 连接 IDE，确认本地 WebSocket 不经过代理。
4. 运行一个持续时间稍长但只读的任务，观察是否中途重连。
5. 恢复原配置重复测试，确认问题确实由本次修改解决。

Tool Use 截断与重连要分开排查

工具调用中途没有结束，不一定是代理断线。先保存原始响应中的 tool call、停止原因、流式事件顺序和请求 ID，再按下面顺序定位：

1. 响应完整性：确认 JSON 或参数片段是否在传输层被截断；若网关日志已收到完整响应，转查客户端解析。
2. 上下文与输出预算：记录输入/输出 tokens、工具结果长度和最大输出设置，避免把预算不足误判为 ECONNRESET。
3. 代理空闲超时：长时间没有增量事件时，检查代理和网关 idle timeout；用短工具结果复现并对照直连路径。
4. 回归验证：分别运行纯文本、单工具、连续工具三组任务；只有第三组失败时，优先检查工具结果拼接和重试逻辑。

该清单用于区分协议/解析、上下文预算和网络重连，不对未测量的成功率或稳定性作承诺。

8. 常见问题