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. 恢复原配置重复测试，确认问题确实由本次修改解决。

8. 常见问题