解决 Claude CLI 频繁断连：调整网络超时与重试配置的实战方案

近期在开发者社区 Linux.do 中，有用户针对在使用 Claude CLI 及 Codex 等工具时遇到的网络连接频繁中断问题，提出了一套有效的技术解决方案。该问题主要表现为在网络环境不稳定或通过代理访问时，目标连接会出现无响应断开。解决方案的核心在于修改代理服务端或客户端的配置参数。具体措施包括：将 HTTP 请求的最大重试次数从默认值大幅提升至 300 次，以应对网络抖动；将 SSE（Server-Sent Events）流的中断重试次数同步提升至 300 次；将 SSE 流的空闲超时时间从默认的 300 秒延长至 300000 毫秒；同时确保 WebSocket 传输支持被开启。此外，在 Claude CLI 的环境变量中设置 `CLAUDE_CODE_RETRY_WATCHDOG` 为 “1” 被证实能有效防止连接意外挂起。该配置方案已被证实能彻底解决此类断连困扰，保障 AI 编码任务的连续性与稳定性。

事件分析

💡 核心观点：默认的超时配置难以适配高延迟网络，通过激进的重试策略与延长超时时间是保障弱网环境下 AI 编码工具稳定性的关键基建优化。