Claude Code 的断开分两类,处理方向完全不同:风控型——断开时伴随验证提示、unusual activity 或 401/403 类错误,病因是节点 IP 被 Anthropic 标记,要换更低共享的节点;线路型——表现为超时、stream 中断、任务卡住,病因是晚高峰丢包或节点自动切换,要换专线并固定节点。先用 curl -I https://api.anthropic.com 确认代理层正常,再按断开时的报错归类。
目录
第一步:排除代理层
curl -I https://api.anthropic.com
能返回状态码说明终端代理正常,问题在更上层;超时或拒绝连接则是代理配置问题(环境变量端口、TUN 状态),回到 Claude Code 网络指南 核对配置。
第二步:给断开归类
| 信号 | 类型 | 方向 |
|---|---|---|
| unusual activity / 要求验证 / 401 / 403 | 风控型 | 换更干净的 IP |
| timeout / stream disconnected / ECONNRESET | 线路型 | 换更稳的线路 |
| API error 529 / overloaded | 服务端 | 等待,与你无关 |
| 所有软件同时断网 | 本机 | 查代理进程 / 休眠 |
风控型断开:IP 的问题
Anthropic 的风控在会话中持续评估出口 IP,共享节点上其他用户的行为会连累你。特征:断开集中在会话建立初期或伴随明确的警告文案。
处理:
- 换到低共享的专线 / 原生 IP 节点(Claude 节点选择)。
claude.ai、anthropic.com固定到该节点,关闭自动切换。- 停止在被标记节点上的重试——每次失败都在恶化评分。
为什么 Claude 系产品的 IP 门槛这么高,见 Claude 为什么对 IP 环境更敏感。
线路型断开:丢包的问题
特征:断开集中在 20:00–23:00,或伴随明显的响应变慢;网页聊天可能只是「感觉卡」,长连接则直接超时。
确认:晚高峰 ping -c 100 节点地址,丢包 > 1% 即确诊。
处理:换 IEPL / IPLC 专线节点;无法立刻换线路时避开晚高峰跑长任务。跨工具通用的断线排查(含代理进程、系统休眠等次要因素)见 AI 编程工具经常断线怎么办。
长会话稳定配置组合
- 美国 / 日本低共享专线节点,三天验证通过后锁定
- TUN 模式(终端全覆盖,回调与会话同出口)
- 域名固定 + 自动切换关闭
- 晚高峰丢包实测 < 1%
- 长任务期间禁用系统休眠
与 Codex 在断连特性上的差异(Codex 更怕丢包、Claude Code 更怕脏 IP)见 Codex 与 Claude Code 对比;满足上述标准的线路见 Claude 机场推荐。
常见问题
怎么快速判断是风控还是线路问题?
看断开时的信息:出现验证、权限类错误(401/403)或 unusual activity 是风控型;出现 timeout、stream disconnected、ECONNRESET 是线路型。网页版 claude.ai 此刻是否正常也是重要旁证。
网页版正常但 Claude Code 频繁断?
两者共用风控但连接形态不同:网页是短请求,Claude Code 是长连接。这种组合指向线路型问题——晚高峰丢包对长连接的杀伤远大于网页。换专线节点。
API error 529 是我的网络问题吗?
不是。529 是 Anthropic 服务端过载,与你的线路无关,等待后重试即可;反复出现可关注官方状态页。
断开后任务进度会丢吗?
Claude Code 会保留会话上下文并尝试恢复,短暂断开通常能续上;长时间中断建议用 /resume 或重新描述进度,关键操作前让它先提交一次代码。